Startseite>Programmierbezogen>Anderer Quellcode
Herunterladen

iOS- und Android -Lokalisierung mit Google Sheets

Grundgedanke

  1. Exportieren Sie Ihre Lokalisierungsdateien in Google Sheets .
  2. Übersetzen Sie die fehlenden Lokalisationen oder aktualisieren Sie die vorhandenen in Google -Tabellen .
  3. Führen Sie das Skript erneut aus, um die Lokalisierungen aus der Tabelle in Ihr Projekt zu importieren.

Installation

Python 2.7 oder vorzugsweise muss Python 3 auf Ihrem Computer installiert werden, wobei auch der pip -Befehl verfügbar ist.

Klonen Sie das Repository und führen Sie pip install -r requirements.txt aus.

Genehmigung von gslocalization mit Google Sheets

  1. Ermitteln Sie eine JSON -Datei service account key von Ihrer Google Developer -Konsole
    • Melden Sie sich bei https://console.developers.google.com an
    • Wählen Sie Ihr Projekt aus (oder erstellen Sie eine neue)
    • Stellen Sie sicher, dass die Google Drive API und Google Sheets API aktiviert sind
    • Gehen Sie zu Credentials und wählen Sie im Menü Create credentials Service account key
    • Wählen Sie Ihr Servicekonto aus (oder erstellen Sie eine neue mit der App Engine Admin -Rolle).
    • Stellen Sie sicher, dass JSON in den Key type ausgewählt ist.
    • Klicken Sie Create
    • Eine JSON -Datei beginnt mit dem Herunterladen. Speichern Sie diese Datei und verwenden Sie sie später zur Authentifizierung.

ios-gslocalization.py

Verwendung

python ios-gslocalization.py -x {PATH_TO_XCODEPROJ} -o {XLIFF_OUTPUT_DIR} -a {JSON_AUTH_FILE_PATH} -e {SHARE_EMAIL_ADDRESS} -l {LOCALIZATION_LANGUAGES} -d {DEV_LANGUAGE}

  1. PATH_TO_XCODEPROJ - Pfad zu Ihrer .xcodeproj -Datei
    • Wird zum Aufrufen von xcodebuild (Exportieren und Importieren von Lokalisationen) verwendet)
    • Die generierten XLIFF -Dateien werden auf XLIFF_OUTPUT_DIR gespeichert
  2. XLIFF_OUTPUT_DIR - Ausgabeverzeichnis für die generierten XLiff -Dateien
  3. JSON_AUTH_FILE_PATH - Pfad zum Google Sheets Service account key
  4. SHARE_EMAIL_ADDRESS - die E -Mail -Adresse zum Freigeben der erstellten Tabellenkalkulationen
    • Da wir einen Service account key verwenden, werden alle Tabellenkalkulationen erstellt und im Service -Account (z. B. [email protected]) erstellt.
    • Nachdem das Servicekonto die Tabellenkalkulationen erstellt hat, überträgt es die Dateibesitz an die bereitgestellte E -Mail -Adresse
    • Geben Sie Ihre E -Mail -Adresse an, um die Ergebnisse in Google -Tabellen visualisieren zu können
  5. LOCALIZATION_LANGUAGES ​​- eine Zeichenfolge, die mehrere Sprachcodes enthält, die für die Lokalisierung verwendet werden
    • Beispiel: "Es, Ru, Ja" für Spanisch, Russisch und Japanisch
    • Dies ermöglicht keine Lokalisierung für eine neue Sprache in Ihrem Xcode -Projekt
    • Geben Sie Sprachen an, die bereits in Ihrem Projekt existieren
  6. DEV_LANGUAGE (optional, standardmäßig an en ) - Der Sprachcode für die Entwicklungssprache des Projekts

Notizen

  • Dieses Skript exportiert die aktuellen Lokalisierungen für Ihr Projekt mit xcodebuild .

  • Es analysiert die erhaltenen XLiff -Dateien und lädt sie in Google -Blätter hoch.

  • Für jede Sprache gibt es eine Tabelle mit dem folgenden Namensformat: {PROJECT_NAME}_{LANGUAGE_NAME}_localizations MyProject_Spanish_localizations MyProject_Russian_localizations . In jeder Tabelle befindet sich ein Arbeitsblatt pro Plattform (z. B. ios_strings , android_strings ). Der {PROJECT_NAME} wird aus dem xcodeproj -Dateinamen abgeleitet.

  • Alle Saiten werden ihrer entsprechenden Tabelle mit dem folgenden Header hinzugefügt:

    Source: SOURCE_LANGUAGE | Target: TARGET_LANGUAGE | Example | Comment | String Key | File Path

    • Source: SOURCE_LANGUAGE = Text in der Quellsprache
    • Target: TARGET_LANGUAGE = Text in der Zielsprache übersetzt
    • Example = leer, wenn die Zeichenfolge Platzhalter enthält ( %@, %d, etc. ). Dies ist ein Ort, an dem Übersetzer ein Beispiel geben können.
    • Comment = NSLocalisedString Kommentare
    • String Key = die ID der Zeichenfolge
    • File Path = Relative Pfad zur Quelldatei der String ( .strings -Datei oder .storyboard )

  • Führen Sie nach der Aktualisierung der Übersetzung in Google Sheets das gleiche Skript erneut aus, um die neuen Zeichenfolgen in Ihr Xcode -Projekt zu importieren.

Android-GsLocalization.py

Verwendung

python android-gslocalization.py -p {PROJECT_NAME} -r {PATH_TO_RES_FOLDER} -a {JSON_AUTH_FILE_PATH} -e {SHARE_EMAIL_ADDRESS} -l {DEVELOPMENT_LANGUAGE}

  1. PROJECT_NAME - Projektname (verwendet zum Präfix des Tabellenkalkulationsname)
  2. PATH_TO_RES_FOLDER - Pfad zu Ihrem Android res -Ordner
    • Schauen Sie sich diesen Ordner für alle strings.xml -Dateien an
    • Für jede Datei strings.xml wird die Zielsprache vom Namen des Parrent-Ordners festgestellt (z. B. values-es für Spanisch)
  3. JSON_AUTH_FILE_PATH - Pfad zum Google Sheets Service account key
  4. SHARE_EMAIL_ADDRESS - die E -Mail -Adresse zum Freigeben der erstellten Tabellenkalkulationen
    • Da wir einen Service account key verwenden, werden alle Tabellenkalkulationen erstellt und im Service -Account (z. B. [email protected]) erstellt.
    • Nachdem das Servicekonto die Tabellenkalkulationen erstellt hat, überträgt es die Dateibesitz an die bereitgestellte E -Mail -Adresse
    • Geben Sie Ihre E -Mail -Adresse an, um die Ergebnisse in Google -Tabellen visualisieren zu können
  5. DEVELOPMENT_LANGUAGE - Der Sprachcode Ihrer Entwicklungssprache (default = en )

Notizen

  • Dieses Skript lädt alle strings.xml -Dateien in PATH_TO_RES_FOLDER .

  • Es analysiert die erhaltenen XML -Dateien und lädt sie in Google Sheets hoch.

  • Für jede Sprache gibt es eine Tabelle mit dem folgenden Namensformat: {PROJECT_NAME}_{LANGUAGE_NAME}_localizations MyProject_Spanish_localizations MyProject_Russian_localizations . In jeder Tabelle befindet sich ein Arbeitsblatt pro Plattform (z. B. ios_strings , android_strings ).

  • Alle Saiten werden ihrer entsprechenden Tabelle mit dem folgenden Header hinzugefügt:

    Source: SOURCE_LANGUAGE | Target: TARGET_LANGUAGE | String ID

    • Source: SOURCE_LANGUAGE = Text in der Quellsprache
    • Target: TARGET_LANGUAGE = Text in der Zielsprache übersetzt
    • String ID = die ID der Zeichenfolge

  • Führen Sie nach der Aktualisierung der Übersetzung in Google Sheets das gleiche Skript erneut aus, um die Dateien von strings.xml in Ihrem Ressourcenordner zu überschreiben.

Abhängigkeiten 

 # parsing arguments
argparse

# provides access to Google Sheets API
pygsheets

# XML parsing for XML/XLIFF files
lxml

# type hinting
typing

# colored output in consolde
colorama

# conversion between language code and language name
langcodes; python_version>'3'
langcodes-py2; python_version<'3'

Allgemeine Tipps

  1. Behalten Sie Ihr Projekt unter der Quellvertretung auf, sodass Sie Ihre Lokalisierungsdateien in ihren vorherigen Status wiederherstellen können, falls dieses Skript etwas bricht.

iOS -Tipps

  1. Verwenden Sie einen Standardwert für lokalisierte Zeichenfolgen. Auf diese Weise haben Sie den Standardwert (normalerweise die Zeichenfolge in der Entwicklungssprache) in der Spalte Quellsprache anstelle der String -Taste.
    • Verwenden Sie für Objective C NSLocalizedStringWithDefaultValue(@"KEY", nil, [NSBundle mainBundle], @"DEFAULT_VALUE", @"COMMENT")] anstelle von NSLocalizedString(@"KEY", @"COMMENT")]
    • Verwenden Sie für Swift NSLocalizedString("KEY", tableName: nil, bundle: Bundle.main, value: "DEFAULT_VALUE", comment: "COMMENT") anstelle von NSLocalizedString("KEY", comment: "COMMENT")
    • Verwenden Sie dieses Python -Skript, um die NSLocalizedString -Aufrufe zu konvertieren, um einen Standardwert zu enthalten
Expandieren
Zusätzliche Informationen
Ähnliche Anwendungen
Empfohlen für Sie
Ähnliche Nachrichten Alle