Swift Translate 使用教程

Swift Translate 使用教程

1. 项目介绍

Swift Translate 是一个开源的命令行工具和 Swift 包插件，旨在简化 iOS 应用的本地化过程。它能够解析字符串目录，并将它们发送给 OpenAI 的 GPT-3.5-Turbo/GPT-4o 模型或 Google Cloud Translate（v2）进行翻译。此项目适用于 macOS 13+ 和 Xcode 15+ 的项目，并需要使用字符串目录进行本地化。

2. 项目快速启动

通过仓库克隆

1. 克隆此仓库或从 GitHub 下载 zip 文件。
2. 打开终端并使用 cd 命令导航到你的项目目录。
3. 使用以下命令测试你的 API 密钥并进行基本文本翻译：

swift run swift-translate --verbose -k <你的密钥> --text "这是一个测试" --lang de

通过包插件

1. 在你的 Package.swift 文件中添加依赖项：

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

2. 将插件添加到你的目标：

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

3. 打开终端并导航到你的包目录。
4. 尝试翻译包中的目录：

swift package plugin swift-translate -k <你的密钥> <path/to/some/localization.xcstrings> --lang de --verbose

当提示是否授权写入包文件夹和允许网络连接时，输入 Y。

3. 应用案例和最佳实践

• 翻译新的或现有的字符串目录：你可以使用 Swift Translate 来翻译全新的字符串目录，或者填充现有目录中缺失的翻译。
• 支持复杂的字符串目录：即使目录中包含复数和设备变体或替换，Swift Translate 也能够正确处理。
• 保持原始目录安全：默认情况下，Swift Translate 不会覆盖原始的字符串目录，而是创建一个带有 .loc 扩展名的副本。

注意：在进行任何重要操作之前，请确保你的目录已经被备份或提交到版本控制系统。

4. 典型生态项目

Swift Translate 可以作为你本地化工作流程的一部分，与其他工具和框架相结合，例如：

• Xcode 项目：将 Swift Translate 集成到你的 Xcode 工作流程中，自动化翻译过程。
• 持续集成/持续部署 (CI/CD)：在 CI/CD 流程中加入 Swift Translate，确保本地化与代码同步更新。
• 其他本地化工具：与如 fastlane 等其他本地化工具结合使用，进一步自动化你的本地化流程。

通过以上步骤和最佳实践，你可以有效地使用 Swift Translate 来简化 iOS 应用的本地化工作。