Integrieren Sie die Lokalisierung mit der PTC API in Ihre CI/CD-Pipeline
Erfahren Sie, wie Sie die PTC API in Ihre CI/CD-Pipeline integrieren, um KI-Übersetzungen in menschlicher Qualität als Teil Ihres Build-Prozesses zu liefern.
Sicher durch Design – kein Lese- oder Schreibzugriff auf das Repository erforderlich.- Kompatibel mit jedem CI/CD-System, inklusive fertiger Konfigurationen.
- Kontrollierter Zugriff durch projektspezifische API-Token.
- Übersetzungen in menschlicher Qualität, geliefert in Minuten, direkt in Ihrem Build.
Wie die CI/CD-Integration funktioniert
Bevor Sie PTC mit Ihrem CI-System einrichten, finden Sie hier die drei Prinzipien hinter der PTC API und dem CLI:
1. Ressourcendateien sind an einen Branch gebunden
Jede Datei, die Sie an PTC senden, ist mit einem Branch-Namen verknüpft (z. B. main, feature/new-checkout). Dies hält Übersetzungen getrennt, sodass verschiedene Features einander nicht überschreiben.
Wenn Sie die fertigen CI/CD-Konfigurationen verwenden, wird dieses Mapping bereits automatisch erledigt.
2. Übersetzungen werden asynchron verarbeitet
PTC gibt Übersetzungen nicht sofort zurück. Stattdessen führt es folgende Schritte aus:
- Hochladen der aktualisierten Dateien
- Identifizierung nur der neuen oder geänderten Strings
- Übersetzen der Strings
- Bereitstellen der übersetzten Dateien zum Download
3. Ein CLI-Skript funktioniert überall
Anstatt die API selbst aufzurufen, verwenden Sie das PTC CLI:
Ein Skript übernimmt den gesamten Ablauf (Upload → Poll → Download). Das CLI läuft auf Linux und macOS und funktioniert mit GitHub Actions, GitLab, Bitbucket oder jeder anderen CI/CD-Plattform.
High-Level-Ablauf: Einrichten der PTC API in Ihrer CI/CD-Pipeline
1Registrieren Sie sich für eine kostenlose Testphase.
Erhalten Sie vollen Zugriff auf alle Funktionen und übersetzen Sie bis zu 20.000 Wörter in zwei beliebige Sprachen Ihrer Wahl.
2Erstellen Sie ein neues Projekt.
Wenn Sie wählen, wie Sie PTC nutzen möchten, wählen Sie API integration. Während der Einrichtung geben Sie ein wenig Kontext zu Ihrem Projekt an (was es tut, für wen es gedacht ist) und wählen die Sprachen aus, in die Sie übersetzen möchten.
3Holen Sie sich Ihr API-Token.
Am Ende der Einrichtung erhalten Sie ein projektspezifisches API-Token. Kopieren Sie es und bewahren Sie es sicher auf – Sie benötigen es zur Authentifizierung aller Anfragen. Sie können dasselbe Token jederzeit in Ihrem Projekt-Dashboard unter Settings → PTC API tokens wiederfinden.
4Fügen Sie das PTC API-Token an der richtigen Stelle in Ihr Repository ein.
| Anbieter | Wo das Token hinzugefügt wird |
|---|---|
| GitHub Actions | Gehen Sie zu Settings → Secrets and variables → Actions und fügen Sie PTC_API_TOKEN hinzu. Gehen Sie dann zu Settings → Actions → General und aktivieren Sie Workflow permissions, damit der Workflow Pull Requests erstellen kann. |
| GitLab CI/CD | Gehen Sie zu Settings → CI/CD → Variables und fügen Sie PTC_API_TOKEN hinzu. |
| Bitbucket Pipelines | Gehen Sie zu Repository settings → Pipelines → Repository variables und fügen Sie PTC_API_TOKEN hinzu. |
5Kopieren Sie die fertige CI/CD-Konfiguration.
Sie erhalten die fertige CI/CD-Konfiguration für Ihre Plattform im PTC CLI Wiki. Diese Vorlagen enthalten bereits die Schritte zum Herunterladen und Ausführen des CLI.
6Führen Sie den Workflow aus.
Sie können den Workflow manuell auslösen, bei Commits, die Ressourcendateien aktualisieren, oder nach einem Zeitplan. Siehe Trigger für GitHub, GitLab und Bitbucket.
Wenn er ausgeführt wird, lädt das CLI Ihre Dateien hoch, wartet auf den Abschluss der Übersetzungen und schreibt die aktualisierten Übersetzungen zurück in Ihr Repository. Wenn Sie die fertigen Konfigurationen verwenden, erstellt der Workflow außerdem einen Pull Request oder Merge Request mit den Änderungen, sodass Sie diese wie jedes andere Code-Update prüfen und mergen können. Von nun an bleiben Ihre Übersetzungen automatisch synchron.
CI/CD-Beispiele
Weiterführende Literatur
Warum PTC für Software-Übersetzungen nutzen?
PTC ist ein komplettes Übersetzungssystem für Entwickler und Produktteams – entwickelt, um Ihren Code, Ihre Marke und Ihr Publikum synchron zu halten.
Kontextbezogene Übersetzungen, die Ihre Markenstimme schützen
Bevor PTC übersetzt, lernt es Ihr Produkt, Ihr Publikum und Ihre Terminologie kennen. Deshalb gehen 99,5 % der Sätze ohne Bearbeitung live und 85 % der Projekte werden überhaupt nicht bearbeitet.
Wie die KI-Übersetzungen von PTC Ihre Markenstimme schützen →
Breite Unterstützung von Plattformen und Dateiformaten
PTC funktioniert mit den gängigsten Ressourcendateiformaten und Plattformen, darunter: Android, iOS, React, Vue.js, Angular, Ruby on Rails, JavaScript, Adobe Commerce (Magento), Shopify und WordPress.
Mehr über unterstützte Dateiformate →
Übersetzen Sie mehr als nur Ressourcendateien
Müssen Sie Release Notes, E-Mails oder Dokumentationen übersetzen? PTC enthält auch eine schnelle „Einfügen zum Übersetzen“-Funktion, die Ihnen dieselben kontextbezogenen Übersetzungen für Texte außerhalb des Codes liefert.
Wie man Texte außerhalb von Ressourcendateien übersetzt →
Automatisieren Sie Übersetzungen in Ihrer CI/CD
Richten Sie PTC einmal ein, und Ihre Ressourcendateien und Übersetzungen bleiben in Ihrer CI/CD-Pipeline automatisch aktuell.