xcstrings-localize

iOS 多言語ローカライズワークフロー

xcstrings (String Catalog) を起点とした iOS アプリの多言語対応を自動化する。 xcodebuild によるエクスポート/インポートと、XLIFF ファイルの AI 翻訳を組み合わせる。

全体フロー

xcstrings → xcodebuild -exportLocalizations → xcloc (XLIFF) → AI翻訳 → バリデーション → xcodebuild -importLocalizations → xcstrings

---

ステップ 0: 対象言語の特定

翻訳対象の言語はプロジェクトの設定から動的に取得する。ハードコードしない。

方法 A: xcstrings から検出（推奨）

プロジェクト内の .xcstrings ファイルは JSON 形式で、sourceLanguage と各言語の翻訳情報を保持している。

# xcstrings ファイルを探す
find . -name "*.xcstrings" -not -path "*/.*"

# 対応言語の一覧を取得（sourceLanguage 以外のキーが翻訳対象）
python3 -c "
import json, sys
with open(sys.argv[1]) as f:
    data = json.load(f)
src = data.get('sourceLanguage', 'ja')
langs = set()
for key, val in data.get('strings', {}).items():
    langs.update(val.get('localizations', {}).keys())
langs.discard(src)
print(f'開発言語: {src}')
print(f'翻訳対象: {\" \".join(sorted(langs))}')
" Localizable.xcstrings

方法 B: Xcode プロジェクト設定から検出

# .xcodeproj 内の knownRegions を取得
grep -A 20 'knownRegions' *.xcodeproj/project.pbxproj | grep -oE '"[a-z]{2}(-[A-Za-z]+)?"'

方法 C: ユーザー指定

ユーザーが「英語とフランス語に翻訳して」のように明示した場合は、その言語のみを対象とする。

言語コードの対応表（参考）

よく使われる言語コード：

• en (英語), zh-Hans (中国語簡体字), zh-Hant (中国語繁体字)
• ko (韓国語), fr (フランス語), de (ドイツ語)
• es (スペイン語), it (イタリア語), pt-BR (ポルトガル語・ブラジル)
• th (タイ語), vi (ベトナム語), id (インドネシア語)
• ar (アラビア語), hi (ヒンディー語)

---

ステップ 1: xcloc パッケージのエクスポート

ステップ 0 で特定した言語を -exportLanguage に指定してエクスポートする。

# 例: LANGUAGES 変数に検出結果を格納してエクスポート
xcodebuild -exportLocalizations \
  -project <プロジェクト名>.xcodeproj \
  -localizationPath ./Localizations \
  $(printf -- '-exportLanguage %s ' ${LANGUAGES})

注意事項

• プロジェクトの場合は -project、ワークスペースの場合は -workspace と -scheme を指定する
• -exportLanguage を省略すると開発言語のみエクスポートされる
• コマンドは全ターゲットをビルドするため、コンパイルエラーがあると失敗する
• 出力先に Localizations/{lang}.xcloc/ が言語ごとに生成される

---

ステップ 2: XLIFF ファイルの翻訳

2-1. 対象ファイルの特定

xcloc パッケージ内の XLIFF ファイルパスは以下の規則に従う：

{言語コード}.xcloc/Localized Contents/{言語コード}.xliff