iOS - Lingo.dev CLI

什么是 iOS？

iOS 是苹果公司为 iPhone 和 iPad 设备提供的移动操作系统。

什么是 Lingo.dev CLI？

Lingo.dev 是一个由 AI 驱动的翻译平台。Lingo.dev CLI 读取源文件，将可翻译内容发送到大型语言模型，并将翻译后的文件写回到您的项目中。

关于本指南

本指南解释了如何在 iOS 应用中设置 Lingo.dev CLI。您将学习如何在 Xcode 中创建字符串目录、配置翻译管道，并在 iOS 模拟器中测试结果。

第 1 步：创建字符串目录

在 Xcode 中打开您的项目。
导航到 File > New > File from Template。
从模板选项中选择 String Catalog。
点击 Next。
点击 Create。

默认情况下，字符串目录文件的名称为 Localizable.xcstrings。

第 2 步：创建可本地化的字符串

打开字符串目录文件。
选择源语言环境（例如，English）。
点击 + 图标添加新字符串。
输入一个键，例如 "welcome"。
输入一个值，例如 "Hello, world"。

第 3 步：配置 CLI

在 Xcode 项目的根目录中，创建一个 i18n.json 文件：

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": 1.8,
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {
    "xcode-xcstrings": {
      "include": ["Localizable.xcstrings"]
    }
  }
}

此文件定义了：

Lingo.dev CLI 应翻译的字符串目录文件
翻译的语言对

在此配置中，字符串目录将从英语翻译为西班牙语。

了解更多信息，请参阅 i18n.json 配置。

第 4 步. 翻译内容

注册一个 Lingo.dev 账户。
通过 CLI 登录 Lingo.dev：
```
npx lingo.dev@latest login
```
运行翻译流水线：
```
npx lingo.dev@latest run
```
CLI 将更新您的 Localizable.xcstrings 文件，填入翻译内容，并创建一个 i18n.lock 文件，用于跟踪已翻译的内容（以防止不必要的重复翻译）。

第 5 步. 使用翻译内容

在您的 Swift 代码中，通过键引用本地化字符串：

Text("welcome")

第 6 步. 预览翻译内容

导航到 Product > Scheme > Edit Scheme。
在弹出的对话框中，选择 Run。
切换到 Options 选项卡。
从 App Language 下拉菜单中选择要测试的语言。
点击 Close。
通过模拟器运行应用程序。