gslocalization

iOS和Android本地化使用Google表

基本思想

1. 將您的本地化文件導出到Google表。
2. 翻譯丟失的本地化或更新Google電子表格中的現有網站。
3. 再次運行腳本以將電子表格的本地化導入到您的項目中。

安裝

還必須使用pip命令在計算機上安裝Python 2.7或最好的Python 3。

克隆存儲庫並運行pip install -r requirements.txt 。

使用Google表授權gslocalization

1. 從您的Google開發人員控制台獲取service account key JSON文件
   • 登錄到https://console.developers.google.com
   • 選擇您的項目（或創建一個新項目）
   • 確保啟用了Google Drive API和Google Sheets API
   • 轉到Credentials和從Create credentials菜單中，選擇Service account key
   • 選擇您的服務帳戶（或使用App Engine Admin角色創建一個新帳戶）
   • 確保在Key type選項中選擇JSON 。
   • 單擊Create
   • JSON文件將開始下載。保存此文件並以後使用它進行身份驗證。

ios-gslocalization.py

用法

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到您的.xcodeproj文件的路徑
   • 用於調用xcodebuild （導出和導入本地化）
   • 生成的Xliff文件保存到XLIFF_OUTPUT_DIR
2. XLIFF_OUTPUT_DIR生成的Xliff文件的輸出目錄
3. JSON_AUTH_FILE_PATH GOOGLE床單Service account key路徑
4. SHARE_EMAIL_ADDRESS共享創建電子表格的電子郵件地址
   • 由於我們使用的是Service account key ，因此所有電子表格均由服務帳戶創建和擁有（ex。[email protected]）
   • 服務帳戶創建電子表格後，它將文件所有權轉移到提供的電子郵件地址
   • 提供您的電子郵件地址，以便能夠在Google電子表格中可視化結果
5. LOCALIZATION_LANGUAGES一個包含用於本地化多種語言代碼的字符串
   • 例如：西班牙語，俄語和日語的“ ES，RU，JA”
   • 這不會在Xcode項目中為新語言啟用本地化
   • 提供項目中已經存在的語言
6. DEV_LANGUAGE （可選，默認為en ） - 項目開發語言的語言代碼

筆記

• 此腳本使用xcodebuild導出您項目的當前本地化。

• 它解析了獲得的Xliff文件並將其上傳到Google表。

• 每種語言都有一個電子表格，具有以下名稱格式： {PROJECT_NAME}_{LANGUAGE_NAME}_localizations （例如MyProject_Spanish_localizations ， MyProject_Russian_localizations等）。在每個電子表格中，每個平台都有一個工作表（例如ios_strings ， android_strings ）。 {PROJECT_NAME}是從xcodeproj文件名中推斷出來的。

• 所有字符串都添加到相應的電子表格中，並帶有以下標頭：

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

  • Source: SOURCE_LANGUAGE =源語言中的文本
  • Target: TARGET_LANGUAGE =以目標語言翻譯的文本
  • Example =如果字符串包含佔位符（ %@, %d, etc. ），則為空。這是為翻譯人員提供示例的地方。
  • Comment = NSLocalisedString評論
  • String Key =字符串的ID
  • File Path =字符串源文件的相對路徑（ .strings File或.storyboard ）

• 在更新Google表中的翻譯後，再次運行相同的腳本以將新字符串導入您的Xcode項目。

android-gslocalization.py

用法

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項目名稱（用於前綴電子表格名稱）
2. PATH_TO_RES_FOLDER通往Android res文件夾的路徑
   • 查看所有strings.xml的文件夾。 xml文件
   • 對於任何strings.xml文件，目標語言由Parrent文件夾名稱檢測到（ex。value values-es ）
3. JSON_AUTH_FILE_PATH GOOGLE床單Service account key路徑
4. SHARE_EMAIL_ADDRESS共享創建電子表格的電子郵件地址
   • 由於我們使用的是Service account key ，因此所有電子表格均由服務帳戶創建和擁有（ex。[email protected]）
   • 服務帳戶創建電子表格後，它將文件所有權轉移到提供的電子郵件地址
   • 提供您的電子郵件地址，以便能夠在Google電子表格中可視化結果
5. DEVELOPMENT_LANGUAGE開發語言的語言代碼（默認en ）

筆記

• 該腳本將所有strings.xml加載PATH_TO_RES_FOLDER中的所有字符串。

• 它解析了獲得的XML文件並將其上傳到Google表。

• 每種語言都有一個電子表格，具有以下名稱格式： {PROJECT_NAME}_{LANGUAGE_NAME}_localizations （例如MyProject_Spanish_localizations ， MyProject_Russian_localizations等）。在每個電子表格中，每個平台都有一個工作表（例如ios_strings ， android_strings ）。

• 所有字符串都添加到相應的電子表格中，並帶有以下標頭：

  Source: SOURCE_LANGUAGE | Target: TARGET_LANGUAGE | String ID

  • Source: SOURCE_LANGUAGE =源語言中的文本
  • Target: TARGET_LANGUAGE =以目標語言翻譯的文本
  • String ID =字符串的ID

• 在更新Google表中的翻譯後，再次運行相同的腳本以覆蓋資源文件夾中的strings.xml文件。

依賴性

 # 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'

一般提示

1. 在源控制下保持您的項目可以使您可以將本地化文件恢復到其先前狀態，以防該腳本打破某些內容。

iOS提示

1. 為本地化字符串使用默認值。通過這樣做，您將在源語言列中具有默認值（通常是開發語言中的字符串），而不是字符串鍵。
   • 對於Objective C ，請使用NSLocalizedStringWithDefaultValue(@"KEY", nil, [NSBundle mainBundle], @"DEFAULT_VALUE", @"COMMENT")]代替NSLocalizedString(@"KEY", @"COMMENT")]
   • 對於Swift ，請使用NSLocalizedString("KEY", tableName: nil, bundle: Bundle.main, value: "DEFAULT_VALUE", comment: "COMMENT")而不是NSLocalizedString("KEY", comment: "COMMENT")
   • 使用此Python腳本將NSLocalizedString調用轉換為包含默認值