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调用转换为包含默认值