Swift Translate 是一个 CLI 工具和 Swift Package 插件，可以轻松地本地化您的应用程序。它会解析您的字符串目录，并将其发送到 OpenAI 的 GPT-3.5-Turbo/GPT-4o 模型或 Google Cloud Translate (v2) 进行翻译。观看演示：

• macOS 13+
• Xcode 15+
• 项目使用 字符串目录 (String Catalogs) 进行本地化
• OpenAI API 密钥 或 Google Cloud Translate (v2) API 密钥

• ✅ 翻译单个字符串目录或文件夹中的所有目录
• ✅ 从英语翻译成 ar, ca, zh-HK, zh-Hans, zh-Hant, hr, cs, da, nl, en, fi, fr, de, el, he, hi, hu, id, it, ja, ko, ms, nb, pl, pt-BR, pt-PT, ro, ru, sk, es, sv, th, tr
• ✅ 支持具有复数 & 设备变体或替换的复杂字符串目录
• ✅ 翻译全新的目录或填充现有目录中缺失的翻译
• ✅ 支持 ChatGPT (3.5-Turbo 和 4o 模型) 和 Google Translate (v2)
• 🚧 文档 (#2)
• 🚧 单元测试 (#3)
• ❌ 从非英语源语言翻译 (#23)
• ❌ 翻译文本文件（对于 fastlane 元数据很有用）(#12)
• ❌ "置信度检查"：要求 GPT 将文本翻译回源语言，以便与原始字符串进行比较 (#14)

在继续之前，请阅读以下内容

• 本项目仍处于非常早期的阶段。 🐣
• 不建议用于生产环境。 ⛔️
• 与任何基于 ChatGPT 构建的工具一样，响应可能不准确或完全损坏。 🤪
• Hidden Spectrum 不对数据丢失、文件损坏或不准确/冒犯性翻译（或因上述不准确而导致的任何后续不良应用评论）负责 🙅🏻‍♂️

👉 注意：默认情况下，您的目录不会被覆盖，而是会创建一个带有 .loc 扩展名的副本。如果您希望覆盖您的目录，请确保它们已签入您的存储库或已备份，然后使用 --overwrite CLI 参数。

好的，现在让我们开始有趣的部分...

👉 注意：虽然此插件仍在开发中，但这是尝试将其与您的项目一起使用的推荐方法。

1. 克隆此存储库或从 GitHub 下载一个 zip 文件。

2. 打开终端并 cd 到您机器上的仓库。

3. 使用基本文本翻译测试您的 API 密钥

   swift run swift-translate --verbose -k <your key here> --text "This is a test" --lang de

4. 您应该看到以下输出

   Building for debugging...
   Build complete! (0.59s)
   
   Translating `This is a test`:
   de:      Dies ist ein Test
   ✅ Translated 1 key(s) (0.384 seconds)

5. 接下来，运行 --help 命令以了解更多信息

   swift run swift-translate --help

1. 将依赖项添加到您的 Package.swift 文件中。

   dependencies: [
       .package(url: "https://github.com/hidden-spectrum/swift-translate", .upToNextMajor(from: "0.1.0"))
   ]

2. 将插件添加到您的 target

   .target(
       name: "App",
       // ...
       plugins: [
           .plugin(name: "SwiftTranslate", package: "swift-translate")
       ]
   )

3. 打开终端并 cd 到您的包目录。
4. 尝试翻译您包中的目录

   swift package plugin swift-translate -k <your key here> <path/to/some/localization.xcstrings> --lang de --verbose 

5. 当系统提示您授予对您的包文件夹的写入权限和对传出网络连接的权限时，输入 Y。
6. 翻译完成后，在与原始文件相同的目录中检查是否存在新的 YourFile.loc.xcstrings 文件。

🚧 *暂不支持*

如果您是 GPT 专家，我们很乐意听取您关于如何改进我们对 OpenAI API 的使用的建议。打开一个 issue 并提出您的建议，或者联系我们以直接参与。

我们仍在制定一个适当的流程来为此项目做出贡献。同时，请查看 open issues 以查看您可以提供帮助的地方。如果未列出任何内容，请随时打开一个 issue 或 PR，我们将进行查看！