iOS - Lingo.dev CLI

iOSとは？

iOSは、iPhoneおよびiPadデバイスを動かすAppleのモバイルオペレーティングシステムです。

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.10",
  "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をクリックします。
シミュレーターでアプリを実行します。