BartyCrouch 项目常见问题解决方案

BartyCrouch 项目常见问题解决方案

BartyCrouch Localization/I18n: Incrementally update/translate your Strings files from .swift, .h, .m(m), .storyboard or .xib files. 项目地址: https://gitcode.com/gh_mirrors/ba/BartyCrouch

项目基础介绍

BartyCrouch 是一个用于本地化（I18n）的开源工具，主要用于增量更新和翻译 Swift 项目中的字符串文件。它可以从 Swift 代码和 Interface Builder 文件中自动提取字符串，并支持机器翻译功能，能够将一种语言翻译成60多种其他语言。BartyCrouch 的主要编程语言是 Swift，适用于 Xcode 14+ 和 Swift 5.7+ 的项目。

新手使用注意事项及解决方案

1. 安装和配置问题

问题描述：新手在安装 BartyCrouch 时可能会遇到依赖库安装失败或配置文件不正确的问题。

解决步骤：

• 步骤1：确保已安装 Xcode 14+ 和 Swift 5.7+，并且 Xcode Command Line Tools 已正确安装。
• 步骤2：使用 Homebrew 安装 BartyCrouch：

  brew install bartycrouch
  

• 步骤3：在项目根目录下创建或编辑 .bartycrouch.toml 配置文件，确保配置文件内容正确。

2. 字符串提取问题

问题描述：在使用 BartyCrouch 提取字符串时，可能会遇到字符串未被正确提取或提取结果不符合预期的问题。

解决步骤：

• 步骤1：确保项目中的字符串文件路径和命名符合 BartyCrouch 的配置要求。
• 步骤2：运行以下命令手动触发字符串提取：

  bartycrouch update
  

• 步骤3：检查提取结果，确保所有需要本地化的字符串都被正确提取到对应的 .strings 文件中。

3. 机器翻译问题

问题描述：在使用 BartyCrouch 进行机器翻译时，可能会遇到翻译结果不准确或翻译失败的问题。

解决步骤：

• 步骤1：确保已正确配置 BartyCrouch 的机器翻译服务，如 Google Translate API 的密钥。
• 步骤2：运行以下命令手动触发机器翻译：

  bartycrouch translate -v
  

• 步骤3：检查翻译结果，如果翻译不准确，可以手动调整或使用其他翻译服务进行补充翻译。

通过以上步骤，新手可以更好地理解和使用 BartyCrouch 项目，解决常见的问题。

BartyCrouch Localization/I18n: Incrementally update/translate your Strings files from .swift, .h, .m(m), .storyboard or .xib files. 项目地址: https://gitcode.com/gh_mirrors/ba/BartyCrouch