PTC
Registrieren Upgrade auf Pro Ihr Konto

Lokalisierung in CI/CD: Übersetzen bei jedem Commit

Fügen Sie Ihrer CI/CD-Pipeline mit der PTC Übersetzungen hinzu: Ein Token, eine Workflow-Datei, und die übersetzten Dateien kehren als Pull Request auf GitHub, GitLab oder Bitbucket zurück.

Auf dieser Seite
  1. Kurz gesagt: vier Schritte
    1. Starten Sie Ihre 30-Tage-Testphase – übersetzen Sie Ihre Software genau jetzt
  2. Der Lokalisierungs-Workflow, der Ihr Team ausbremst
  3. Was die PTC bei der Software-Lokalisierung auszeichnet
  4. Die PTC lernt das Vokabular und die Markenstimme Ihres Produkts
    1. Für Entwicklerteams gebaut, nicht nachträglich aufgesetzt
  5. Visuelle Übersetzungsprüfung Ihrer laufenden Software – veröffentlichen Sie ohne manuelle QA pro Sprache
  6. Native CI/CD-Integration mit GitHub, GitLab und Bitbucket
    1. Lokalisierung läuft parallel zu Ihrem Code, nicht danach
  7. Wie die CI/CD-Integration funktioniert
    1. 1. Ressourcendateien sind an einen Branch gebunden
    2. 2. Übersetzungen werden asynchron verarbeitet
    3. 3. Ein CLI-Skript funktioniert überall
  8. High-Level-Workflow: Richten Sie die PTC-API in Ihrer CI/CD-Pipeline ein
    1. 1Melden Sie sich für eine Testphase an.
    2. 2Erstellen Sie ein neues Projekt.
    3. 3Holen Sie sich Ihr API-Token.
    4. 4Fügen Sie das PTC-API-Token an der richtigen Stelle zu Ihrem Repository hinzu.
    5. 5Kopieren Sie die einsatzbereite CI/CD-Konfiguration.
    6. 6Führen Sie den Workflow aus.
  9. CI/CD-Beispiele
  10. Glossar und Translation-Memory pro Projekt
    1. Bearbeiten oder übersetzen Sie jeden String nach der Generierung neu
  11. Die PTC unterstützt jedes gängige Ressourcenformat sofort
    1. Veröffentlichen Sie in 40+ Sprachen, von Arabisch bis Japanisch
  12. Übersetzen Sie plattformübergreifende Release Notes, Kunden-E-Mails und Support-Dokumente
  13. Übersetzen Sie nutzergenerierte Inhalte, Support-Tickets und dynamische Daten mit der PTC-API
  14. Preise: 30-Tage-Testphase, danach Pay-As-You-Go
  15. Die PTC ist für den Unternehmenseinsatz ISO 27001-zertifiziert
    1. Folgen Sie einem bewährten Pfad vom ersten String bis zum veröffentlichten Release
  16. Bereit, verifizierte mehrsprachige Software zu veröffentlichen?

Kurz gesagt: vier Schritte

  1. Erstellen Sie ein PTC-Projekt und wählen Sie API integration. Sie beschreiben das Produkt, wählen die Sprachen aus und erhalten ein Projekt-API-Token.
  2. Fügen Sie das Token zu Ihrem Repository hinzu, und zwar als Secret PTC_API_TOKEN.
  3. Fügen Sie den einsatzbereiten Workflow für Ihre CI hinzu. Sehen Sie sich die Beispiele für GitHub Actions und GitLab CI an.
  4. Pushen Sie. Die PTC übersetzt nur die neuen und geänderten Strings, und die übersetzten Dateien kommen als Pull Request zurück.

Die vollständige Einrichtung finden Sie unten. Sie richten dies einmal ein; danach wird jeder Commit übersetzt, ohne dass jemand den Vorgang manuell starten muss.

Quelldateien ändern sich, die PTC übersetzt automatisch, übersetzte Dateien landen als Merge Request wieder in Ihrem Repo, und die AI Visual QA überprüft die gerenderte App, bevor das Release veröffentlicht wird. Kein Hin- und Herschieben von Dateien zwischen Teams, keine Übergaben an Agenturen zwischen Releases.

Starten Sie Ihre 30-Tage-Testphase – übersetzen Sie Ihre Software genau jetzt

  • 20.000 Wörter in 2 Sprachen
  • 40+ unterstützte Sprachen
  • Visuelle Übersetzungsprüfung der laufenden App inklusive
  • ISO 27001-zertifiziert – Sicherheit und Compliance sind abgedeckt
  • Keine Kreditkarte erforderlich

Starten Sie Ihre Testphase

Der Lokalisierungs-Workflow, der Ihr Team ausbremst

Die meisten Entwicklerteams gehen die Lokalisierung auf dieselbe Weise an. Sie stoßen auf dieselben drei Probleme:

Die PTC ersetzt alle drei durch einen CI-nativen Workflow.

Was die PTC bei der Software-Lokalisierung auszeichnet

Jeder der folgenden Punkte verlinkt zu einem detaillierten Abschnitt weiter unten auf der Seite.

Die PTC lernt das Vokabular und die Markenstimme Ihres Produkts

Die PTC ist kein Übersetzungstool, das Ihrem Team beim Übersetzen hilft. Die PTC ist der Übersetzer. Sie lernt das Vokabular, die Tonalität und die Regeln Ihres Produkts aus den Strings, die Sie hochladen, und wendet diese bei jedem Release konsistent an.

Für Entwicklerteams gebaut, nicht nachträglich aufgesetzt

Ein Software-Übersetzungstool verdient sich seinen Platz, wenn es in den bestehenden Workflow passt, technische Dateiformate versteht und Platzhalter sowie Variablen beibehält. Die PTC wurde genau dafür entwickelt: Sie parst Ihre Ressourcendateien automatisch, lernt die Terminologie Ihres Produkts und liefert Übersetzungen, die Ihre UI-Beschränkungen respektieren, sodass Ihre Entwickler ihren Workflow beibehalten können, anstatt sich an eine generische Übersetzungs-App anpassen zu müssen.

  • Markenstimme pro Projekt. Definieren Sie den Zweck und die Zielgruppe Ihres Produkts einmalig. Die PTC nutzt diesen Kontext für jeden String, sodass Ihre Übersetzungen so klingen, als wären sie von Ihrem Team geschrieben worden. Das gilt unabhängig davon, ob Ihr Produkt formell oder locker, technisch oder für Endverbraucher gedacht ist.
  • Ein Glossar, das kumuliert. Fügen Sie markenspezifische Begriffe, Funktionsnamen und „Nicht übersetzen“-Regeln einmalig hinzu. „Cart = Carrito“ für Spanisch. Die PTC setzt sie in jeder Datei, jeder Sprache und jedem zukünftigen Update durch.
  • Übersetzungen, die in Ihr UI passen. Die PTC verwendet intelligente Standardlängen für jede Zielsprache und kennzeichnet Überläufe bereits während der Übersetzung, nicht erst nach dem Build.
  • Korrekt verarbeitete Platzhalter. Die PTC erkennt Platzhalter wie %s, {{name}}, {0}, %1$s in jedem unterstützten Ressourcenformat. Variablen bleiben erhalten, sodass Sie niemals einen fehlerhaften String veröffentlichen.
  • Translation-Memory über Updates hinweg. Wenn Sie ein Wort in einem Absatz ändern, übersetzt die PTC nur das, was sich geändert hat, und behält den Rest bei.
  • Kein Raten. Wenn ein String mehrdeutig ist (ist „Submit“ ein Button oder ein Substantiv?), hält die PTC an und fragt nach, anstatt eine falsche Bedeutung zu wählen.

Visuelle Übersetzungsprüfung Ihrer laufenden Software – veröffentlichen Sie ohne manuelle QA pro Sprache

Eine Übersetzung ist notwendig, aber nicht ausreichend, um mehrsprachige Software zu veröffentlichen. Ein übersetzter String kann ein fehlerhaftes Produkt ausliefern. Ein deutsches Label, das über einen Button hinausragt. Ein französisches Wort mit der falschen Wortart. Ein englischer String, den jemand vergessen hat, in den i18n-Helper zu wrappen. Diese Fehler zu finden, bedeutet traditionell einen mehrtägigen Durchlauf der manuellen QA pro Sprache und Release. Das ist die teuerste und langsamste Phase der Lokalisierung und der Grund, warum sich viele Teams auf zwei oder drei Sprachen beschränken.

Die AI Visual QA der PTC ersetzt diesen Durchlauf durch CI-native Automatisierung. Zwei Varianten decken jede Art von Software ab:

  • Browser-Erweiterung (für browserbasierte Software wie SaaS, Web-Admin-UIs, webbasierte Desktop-Apps). Installieren Sie die PTC-Browser-Erweiterung und zeichnen Sie einmalig einen Rundgang durch die kritischen Benutzer-Workflows Ihrer App auf. Von da an spielt die PTC die Aufzeichnung nach jedem Release ab, erfasst jeden Bildschirm in jeder Sprache und prüft das gerenderte Ergebnis.
  • Screenshot-Upload (für native Desktop-Apps, Server-CLI-Tools oder jegliche Nicht-Browser-Software). Laden Sie einen Screenshot pro Sprache und Bildschirm hoch. Die Vision-KI der PTC prüft das gerenderte Ergebnis auf die gleiche Weise.

Fehler, die die PTC in den Ressourcendateien beheben kann (Mehrdeutigkeit zwischen Verb und Substantiv, Layout-Überlauf, Plural-Inkonsistenzen), werden automatisch behoben. Fehler, die sich in Ihrem Quellcode befinden (fehlende Wrapper, hardcodierte Strings, Satzverkettungen), kommen als einsatzbereite Prompts für Cursor oder Claude Code zurück.

Das Lieferergebnis verlagert sich von „übersetzten Ressourcendateien“ zu „veröffentlichungsreifer mehrsprachiger Software“. Keine andere Lokalisierungsplattform bietet dies heute an.

Native CI/CD-Integration mit GitHub, GitLab und Bitbucket

Committen Sie eine .ptc-config.yml, die die Dateien mit Ihren Quellstrings benennt und angibt, wohin die Übersetzungen gehören:

# .ptc-config.yml
source_locale: en
files:
  - file: src/locales/en.json
    output: src/locales/{{lang}}.json
  - file: app/src/main/res/values/strings.xml
    output: app/src/main/res/values-{{lang}}/strings.xml

Fügen Sie dann die PTC Translate action zu Ihrem Workflow hinzu. Sie enthält eine angeheftete Version der PTC-CLI, sodass Ihr Build zur Laufzeit nichts herunterlädt:

# .github/workflows/translate.yml
name: Translate
on:
  push:
    branches: [main]
    paths:
      - 'src/locales/en.json'
      - 'app/src/main/res/values/strings.xml'
  workflow_dispatch: {}

jobs:
  translate:
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
      - uses: OnTheGoSystems/ptc-action@v1
        with:
          api-token: ${{ secrets.PTC_API_TOKEN }}
          create-pr: true

Die PTC synchronisiert die neuen Quellstrings, übersetzt sie in Ihre Zielsprachen und öffnet einen Pull Request mit den aktualisierten es.json-, de.json-, values-es/strings.xml-Dateien und so weiter. Ihr Team überprüft diesen wie jede andere Codeänderung. Ein Push, der Ihre Quellstrings unverändert lässt, übersetzt nichts und öffnet nichts.

Für GitLab CI, Bitbucket Pipelines, CircleCI oder jedes andere CI-System funktioniert derselbe Workflow über REST. Sehen Sie sich die PTC-API-Referenz für die vollständige Webhook- und Sync-API an.

Für Teams, die mehrere Releases pro Woche veröffentlichen, skaliert die PTC ohne Overhead pro Release. Die PTC übersetzt nur Strings neu, die sich tatsächlich geändert haben. Ein Update von 10 Strings führt nicht dazu, dass die restlichen 10.000 neu übersetzt werden. Die PTC läuft rund um die Uhr. Sie warten nie auf die Lieferprognose einer Agentur für die nächste Woche.

Lokalisierung läuft parallel zu Ihrem Code, nicht danach

Kontinuierliche Lokalisierung bedeutet, dass die Übersetzung Teil Ihres Entwicklungszyklus ist, anstatt zu einer separaten Phase am Ende zu werden. Die PTC bietet dies, indem sie sich mit Ihrem Git-Repository oder Ihrer CI/CD-Pipeline verbindet. Wenn Sie neuen Code pushen, erkennt die PTC die neuen Strings, wendet Ihren Produktkontext und Ihr Glossar an, übersetzt sie und gibt sie als Merge Request zurück, sodass die Lokalisierung mit jedem Commit Schritt hält, anstatt das nächste Release zu blockieren.

Wie die CI/CD-Integration funktioniert

Bevor Sie die PTC in Ihrem CI-System einrichten, hier sind die drei Prinzipien hinter der PTC-API und -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). Dies hält Übersetzungen getrennt, sodass sich Übersetzungen aus verschiedenen Funktionen nicht gegenseitig überschreiben. Wenn Sie die einsatzbereiten CI/CD-Konfigurationen verwenden, wird diese Zuordnung bereits automatisch vorgenommen.

2. Übersetzungen werden asynchron verarbeitet

Die PTC gibt Übersetzungen nicht sofort zurück. Stattdessen führt sie Folgendes aus:

  • Lädt die aktualisierten Dateien hoch
  • Identifiziert nur die neuen oder geänderten Strings
  • Übersetzt die Strings
  • Bereitet übersetzte Dateien zum Download vor

3. Ein CLI-Skript funktioniert überall

Anstatt die API selbst aufzurufen, verwenden Sie die PTC-CLI:

Ein Skript übernimmt den gesamten Workflow (Upload → Abfragen → Download). Die CLI läuft auf Linux und macOS und funktioniert mit GitHub Actions, GitLab, Bitbucket oder jeder anderen CI/CD-Plattform.

High-Level-Workflow: Richten Sie die PTC-API in Ihrer CI/CD-Pipeline ein

1Melden Sie sich für eine Testphase 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 etwas 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 Einstellungen → PTC-API-Tokens.

Abrufen des PTC-API-Tokens bei der Projekteinrichtung
Abrufen des API-Tokens bei der Projekteinrichtung
Abrufen des PTC-API-Tokens aus dem Dashboard
Abrufen des API-Tokens aus dem PTC-Dashboard

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 → Workflow permissions und aktivieren Sie Allow GitHub Actions to create and approve pull requests. Die Workflow-Datei fordert bereits den benötigten Schreibzugriff an; dieses Kontrollkästchen ist das Einzige, was sie sich nicht selbst gewähren 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 einsatzbereite 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 eine feste Version der CLI, sodass Ihr Build zur Laufzeit niemals ein Skript herunterlädt, und wenn ein Durchlauf neue Übersetzungen produziert, öffnet sie den Pull Request für Sie.

Kopieren Sie bei GitLab CI, Bitbucket Pipelines oder jeder anderen Plattform den Job für Ihre Plattform aus den PTC-CLI-CI/CD-Vorlagen. Jede Vorlage heftet die CLI an ein bestimmtes Release an 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. Sehen Sie sich die Trigger für GitHub, GitLab und Bitbucket an. Ein Pull Request benötigt einen Branch, gegen den er geöffnet werden kann. Daher öffnet die PTC Translate Action bei GitHub Actions einen bei einem Push, nach einem Zeitplan und bei einem manuellen Durchlauf aus einem Branch. Bei einem pull_request-, pull_request_target- oder merge_group-Ereignis, oder bei einem Tag oder Release, stoppt sie stattdessen mit einer Erklärung – übersetzen Sie bei einem Push in Ihren Quell-Branch oder legen Sie create-pr: false für diesen Durchlauf fest.

Wenn sie 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 einsatzbereiten Konfigurationen verwenden und der Durchlauf neue Übersetzungen produziert hat, wird der Workflow für die Änderungen außerdem create a merge request ausführen, sodass Sie diese wie jedes andere Code-Update überprüfen und mergen können. Ein Durchlauf, der nichts zum Übersetzen findet, schreibt nichts und öffnet keinen Merge Request. Von nun an bleiben Ihre Übersetzungen automatisch synchron.

CI/CD-Beispiele

WordPress
Ruby on Rails
JSON-Dateien (React-Apps)

Glossar und Translation-Memory pro Projekt

Fügen Sie einen Glossareintrag einmalig hinzu. Zum Beispiel: „Cart = Carrito“ für Spanisch. Die PTC wendet den Eintrag auf jede Datei im selben Projekt an, jetzt und bei jedem zukünftigen Update. Sie müssen zwischen den Durchläufen nie wieder TMX-Dateien hochladen.

Sie können Glossareinträge auf zwei Arten verwalten. Das PTC-Dashboard bietet einen Editor für Ad-hoc-Einträge. Die PTC-REST-API unterstützt den Import und Export von Glossaren für Teams, die ihre Terminologie in einem separaten System pflegen.

Bearbeiten oder übersetzen Sie jeden String nach der Generierung neu

Die PTC sperrt niemals eine Übersetzung. Sie können jeden String jederzeit über den Tab Translations überprüfen, bearbeiten oder die PTC bitten, ihn neu zu übersetzen, sodass Ihr Team bei jedem veröffentlichten Wort das letzte Wort behält.

Die PTC unterstützt jedes gängige Ressourcenformat sofort

Die PTC verarbeitet die Formate, die Ihr Stack tatsächlich verwendet. Die unten genannten Formate verlinken auf ihre jeweiligen Übersetzungsseiten:

  • Web: JSON (i18next, react-intl, vue-i18n, next-intl), YAML (Rails), PO/POT (Django, WordPress).
  • iOS: .strings, .stringsdict, .xcstrings (String Catalogs).
  • Android: strings.xml, Pluralformen, String-Arrays.
  • Desktop / plattformübergreifend: .properties (Java), .po (gettext).
  • Daten / Kataloge: CSV, XLIFF.

Software-Lokalisierung fängt nicht beim User Interface an und hört dort auch nicht auf. Die PTC übersetzt auch Release Notes, E-Mail-Benachrichtigungen, Hilfedokumentationen, Marketingmaterialien, Benutzerfeedback und Fehlerberichte. Alles im selben Projekt, sodass die Terminologie bei allem, womit Ihre Benutzer in Berührung kommen, konsistent bleibt.

Sehen Sie sich die vollständige Matrix der unterstützten Formate und Sprachen für die komplette Liste an.

Veröffentlichen Sie in 40+ Sprachen, von Arabisch bis Japanisch

Die PTC übersetzt in 40+ Sprachen, darunter Arabisch, Chinesisch, Französisch, Deutsch, Japanisch, Koreanisch, Portugiesisch, Spanisch und weitere, sodass Sie neue Märkte erschließen können, ohne für jeden ein neues Tool hinzuzufügen. Sehen Sie sich die vollständige Liste der unterstützten Sprachen an, um sicherzustellen, dass Ihre Zielsprachen abgedeckt sind.

Übersetzen Sie plattformübergreifende Release Notes, Kunden-E-Mails und Support-Dokumente

Plattformübergreifende Release Notes, kundenorientierte E-Mails, Support-Dokumentationen und Texte für Marketing-Websites befinden sich alle außerhalb Ihrer Ressourcendateien. Die Paste to Translate der PTC verarbeitet diese Texte im selben Projekt. Fügen Sie den Ausgangstext ein, wählen Sie die Zielsprachen aus und erhalten Sie Übersetzungen zurück, die dasselbe Glossar und dieselbe Markenstimme verwenden wie Ihre In-App-Strings.

Übersetzen Sie nutzergenerierte Inhalte, Support-Tickets und dynamische Daten mit der PTC-API

Nutzergenerierte Inhalte, Support-Tickets und die dynamischen Daten, die Ihre Software zur Laufzeit verarbeitet, müssen direkt bei ihrem Eintreffen übersetzt werden. Die PTC-REST-API übersetzt diese Inhalte bei Bedarf mit Bearer-Token-Authentifizierung und verwendet dabei dasselbe Glossar und dieselbe Markenstimme wie die Übersetzungen Ihrer Ressourcendateien.

Preise: 30-Tage-Testphase, danach Pay-As-You-Go

Die Testphase umfasst 20.000 Wörter in 2 Sprachen ohne Kreditkarte. Wenn die Testphase endet, bietet die PTC Pay-As-You-Go. Kein Abonnement. Keine Mindestlaufzeit. Die ersten 500 Wörter jeden Monat sind kostenlos. Sie zahlen nur für den Rest. Auf der Preisseite finden Sie einen Kostenrechner. Melden Sie sich mit einer Firmen-E-Mail-Adresse für eine erweiterte Business-Testphase an.

Die PTC ist für den Unternehmenseinsatz ISO 27001-zertifiziert

Die PTC ist ISO 27001-zertifiziert, was bedeutet, dass Ihre Daten und die Daten Ihrer Benutzer nach international anerkannten Sicherheitsstandards verarbeitet werden. Die PTC unterstützt kontinuierliche Lokalisierung für Entwicklerteams jeder Größe, vom 3-Entwickler-Startup bis hin zum Enterprise-Unternehmen, das wöchentlich in 12 Sprachen veröffentlicht.

Folgen Sie einem bewährten Pfad vom ersten String bis zum veröffentlichten Release

Der Einstieg ist unkompliziert, wenn man einen Plan hat. Unser Leitfaden zur Software-Lokalisierung führt Sie durch alles – von der Vorbereitung Ihrer Strings für die Übersetzung bis hin zur Verwaltung von Updates, während Ihr Produkt wächst –, sodass Sie die PTC mit einem klaren Plan statt durch Ausprobieren einführen. Lesen Sie den Leitfaden zur Software-Lokalisierung, um Ihr erstes Projekt einzurichten.

Bereit, verifizierte mehrsprachige Software zu veröffentlichen?

Verbinden Sie Ihr GitHub- oder GitLab-Repo. Die PTC übersetzt Ihre Ressourcendateien in 40+ Sprachen und prüft die laufende App bei jedem Release in jeder einzelnen davon. Sie veröffentlichen mit Zuversicht.

Starten Sie Ihre 30-Tage-Testphase – 20.000 Wörter gehen auf uns, keine Kreditkarte erforderlich.

Für Entwickler, die bereit sind loszulegen:

Zuletzt aktualisiert: