iOS - Lingo.dev CLI

什么是 iOS？

iOS 是 Apple 推出的移动操作系统，为 iPhone 和 iPad 设备提供支持。

什么是 Lingo.dev CLI？

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

关于本指南

本指南介绍如何在 iOS 应用中配置 Lingo.dev CLI。您将学习如何在 Xcode 中创建 String Catalog，配置翻译流水线，并在 iOS 模拟器中测试结果。

步骤 1. 创建 String Catalog

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

默认情况下，String Catalog 文件的名称为 Localizable.xcstrings。

步骤 2. 创建可本地化字符串

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

步骤 3. 配置 CLI

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

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

该文件定义了：

Lingo.dev CLI 需要翻译的 String Catalog 文件
需要翻译的语言

在本例中，配置会将 String Catalog 从 English 翻译为 Spanish。

了解更多信息，请参见 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 代码中，通过 key 引用本地化字符串：

Text("welcome")

步骤 6. 预览翻译效果

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