Swift Translate 安装与配置指南

Swift Translate 安装与配置指南

swift-translate Swift Package Plugin for automatically translating your String Catalogs 项目地址: https://gitcode.com/gh_mirrors/sw/swift-translate

1. 项目基础介绍

Swift Translate 是一个开源项目，它提供了一个命令行工具和 Swift 包插件，用于帮助开发者轻松本地化应用程序。该工具可以拆解字符串目录，并将其发送到 OpenAI 的 GPT-3.5-Turbo/GPT-4o 模型或 Google Cloud Translate（v2）进行翻译。

主要编程语言：Swift

2. 项目使用的关键技术和框架

• OpenAI API：用于将字符串目录发送到 GPT-3.5-Turbo/GPT-4o 模型进行翻译。
• Google Cloud Translate API：另一种翻译服务，可以通过该 API 进行字符串的翻译。
• Swift Package Manager：用于管理和构建 Swift 项目。

3. 项目安装和配置的准备工作

在开始安装之前，请确保您的开发环境满足以下要求：

• macOS 13 或更高版本
• Xcode 15 或更高版本
• 使用 String Catalogs 进行本地化的项目
• OpenAI API 密钥 或 Google Cloud Translate（v2）API 密钥

安装步骤

方式一：通过仓库克隆

1. 克隆此仓库或从 GitHub 下载 zip 文件。

2. 打开终端并使用 cd 命令导航到您的本地仓库目录。

3. 测试您的 API 密钥，执行以下命令进行基本文本翻译：

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

   如果一切正常，您将看到翻译输出。

4. 使用 swift run swift-translate --help 命令获取更多帮助信息。

方式二：通过包插件

1. 在您的 Package.swift 文件中添加以下依赖项：

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

2. 添加插件到您的目标中：

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

3. 打开终端并导航到您的包目录。

4. 尝试翻译包中的目录：

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

5. 当系统提示您是否允许写入包文件夹和允许网络连接时，输入 Y。

6. 翻译完成后，检查原始文件所在目录下是否生成了新的 YourFile.loc.xcstrings 文件。

方式三：在 Xcode 中使用

目前此方法还不支持。

以上是 Swift Translate 的安装和配置指南，按照以上步骤，您可以轻松地将该工具集成到您的开发流程中。

swift-translate Swift Package Plugin for automatically translating your String Catalogs 项目地址: https://gitcode.com/gh_mirrors/sw/swift-translate