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 bereitzustellen.
Sicher durch Design – kein Lese- oder Schreibzugriff auf das repository erforderlich.- Kompatibel mit jedem CI/CD-System, inklusive vorgefertigter Konfigurationen.
- Kontrollierter Zugriff durch projektspezifische API-Token.
- Übersetzungen in menschlicher Qualität, in wenigen Minuten direkt in Ihrem Build geliefert.
Wie die CI/CD-Integration funktioniert
Bevor Sie die PTC in Ihrem CI-System einrichten, hier die drei Prinzipien hinter der PTC-API und der CLI:
1. Ressourcendateien sind an einen Branch gebunden
Jede Datei, die Sie an die PTC senden, ist mit einem Branch-Namen verknüpft (z. B. main, feature/new-checkout). Dadurch bleiben die Übersetzungen getrennt, sodass sich Übersetzungen verschiedener Features nicht gegenseitig überschreiben.
Wenn Sie die vorgefertigten CI/CD-Konfigurationen verwenden, wird diese Zuordnung bereits automatisch verarbeitet.
2. Übersetzungen werden asynchron verarbeitet
Die PTC gibt Übersetzungen nicht sofort zurück. Stattdessen geht sie wie folgt vor:
- Sie lädt die aktualisierten Dateien hoch
- Sie identifiziert nur die neuen oder geänderten strings
- Sie übersetzt die strings
- Sie bereitet die übersetzten Dateien zum Download vor
3. Ein CLI-Skript funktioniert überall
Anstatt die API selbst aufzurufen, verwenden Sie die PTC-CLI:
Ein Skript verarbeitet den gesamten Ablauf (Upload → Abfragen → Download). Die CLI läuft unter Linux und macOS und funktioniert mit GitHub Actions, GitLab, Bitbucket oder jeder anderen CI/CD-Plattform.
Allgemeiner Ablauf: Einrichten der PTC-API in Ihrer CI/CD-Pipeline
1Melden Sie sich für eine Testversion an.
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 auswählen, wie Sie die 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 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, um alle Anfragen zu authentifizieren. Sie finden dasselbe Token jederzeit in Ihrem Projekt-dashboard unter Settings → PTC API tokens wieder.
4Fügen Sie das PTC-API-Token an der richtigen Stelle zu Ihrem repository hinzu.
| 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 vorgefertigte CI/CD-Konfiguration.
Fügen Sie bei GitHub Actions die PTC Translate action zu Ihrem Workflow hinzu. Ihr API-Token ist die einzige Eingabe, die Sie übergeben müssen. Die Action enthält intern eine feste Version der CLI, sodass Ihr Build zur Laufzeit niemals ein Skript herunterlädt, und sie öffnet den Übersetzungs-pull request für Sie.
Kopieren Sie bei GitLab CI, Bitbucket Pipelines oder einer anderen Plattform den Job für Ihre Plattform aus den PTC-CLI-CI/CD-Vorlagen. Jede Vorlage bindet die CLI an ein spezifisches Release und veröffentlicht die Prüfsumme zur Verifizierung, sodass ein späteres CLI-Release nicht ändern kann, was Ihr Build ausführt.
6Führen Sie den Workflow aus.
Sie können den Workflow manuell, bei Commits, die Ressourcendateien aktualisieren, oder nach einem Zeitplan auslösen. Siehe Trigger für GitHub, GitLab und Bitbucket.
Wenn er ausgeführt wird, lädt die CLI Ihre Dateien hoch, wartet auf den Abschluss der Übersetzungen und schreibt die aktualisierten Übersetzungen zurück in Ihr repository. Wenn Sie die vorgefertigten Konfigurationen verwenden, wird der Workflow mit den Änderungen außerdem die Aktion create a merge request ausführen, sodass Sie diese wie jedes andere Code-Update überprüfen und mergen können. Von nun an bleiben Ihre Übersetzungen automatisch synchron.
CI/CD-Beispiele
Weiterführende Literatur
- Eingaben für die PTC Translate action
- CI/CD-Vorlagen für GitHub und GitLab
- Konfigurationsdatei
- Verarbeitungs-Workflow
- Fehlerbehebung
Warum PTC für Software-Übersetzungen nutzen?
Die 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 Marke schützen
Vor dem Übersetzen lernt die PTC 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 der PTC Ihre Marke schützen →
Breite Unterstützung für Plattformen und Dateiformate
Die PTC funktioniert mit den beliebtesten 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? Die PTC enthält auch eine schnelle „Paste to translate“-Funktion, die Ihnen dieselben kontextbezogenen Übersetzungen für Text außerhalb von Code bietet.
So übersetzen Sie Text außerhalb von Ressourcendateien →
Automatisieren Sie Übersetzungen in Ihrer CI/CD
Richten Sie die PTC einmal ein, und Ihre Ressourcendateien und Übersetzungen bleiben in Ihrer CI/CD-Pipeline automatisch auf dem neuesten Stand.