Android アプリをローカライズする

Android のリソースを翻訳し、適切なロケールのディレクトリに配置して、アプリ内でメッセージを確認します。

Android はリソースディレクトリからローカライズされたテキストを選びます。アプリケーションコードでは、引き続き同じリソース名を使えます。Lingo.dev はこれらのリソースを翻訳し、翻訳先ディレクトリに出力します。まずは既定のリソースファイルから挨拶、リスト、複数形を一つずつ選び、別のロケールで動作する画面に表示してみましょう。

この手順はネイティブの Android XML 向けです。Flutter についてはARB リソースと生成されるローカライゼーションコードを、JSON カタログについてはReact Native のローカライゼーションを参照してください。

画面で読み込むリソースを準備する #

既定のリソースは app/src/main/res/values/strings.xml に保存します。

xml
<resources>
  <string name="welcome">Welcome, %1$s!</string>
  <string name="product_name" translatable="false">ExampleApp</string>
  <string-array name="delivery_options">
    <item>Standard delivery</item>
    <item>Express delivery</item>
  </string-array>
  <plurals name="items_count">
    <item quantity="one">%d item</item>
    <item quantity="other">%d items</item>
  </plurals>
</resources>

アプリケーションの既存のリソース呼び出しを使って、これらのリソースを画面に表示します。welcome はメッセージを識別し、%1$s はコードから渡される名前を受け取ります。複数形リソースでは、形式の選択と書式設定に件数が必要です。translatable="false" を使うと、製品名を翻訳対象から除外できます。

Android ファイルハンドラーはプレーンテキストの項目を選択し、インラインの子要素によるマークアップが混在する項目はスキップします。メッセージに <b> や <xliff:g> などの子要素が含まれる場合は、それらの項目を別途処理してください。CDATA のテキストは、それを囲む構文を保ったまま翻訳できます。内部のマークアップは、保護対象の子要素構造ではなく、テキストとして扱われます。装飾を含むリソースは、アプリケーションで実際に使うレンダラーで確認してください。

翻訳元の選択とロケールのパスを設定する #

プロジェクトのルートで CLI をインストールし、連携します。

sh
npm install --global @lingo.dev/cli
lingo login
lingo init --source en --targets es,pt-BR,zh-Hans --files 'app/src/main/res/values/strings.xml' --yes
lingo link

.lingo/config.json では、連携済みの組織とローカライゼーションエンジンの ID をそのまま残し、ファイル形式を明示的に設定します。

json
{
  "pattern": "app/src/main/res/values/strings.xml",
  "format": "android"
}

このオブジェクトをファイルのエントリとして使います。拡張子 .xml だけでは、Android と他の XML 語彙を区別できません。arrays.xml など、他のリソースファイルの翻訳元エントリも追加してください。ただし、生成された翻訳先ディレクトリは含めないでください。

現在の CLI は修飾子のない values/ ディレクトリを認識し、翻訳先パスには Android の修飾子を使います。

翻訳先ロケール翻訳先ディレクトリ
esvalues-es
pt-BRvalues-pt-rBR
zh-Hansvalues-b+zh+Hans

この構成では、values-en のシンボリックリンクは不要です。古い設定で使っていた場合は、削除する前に設定を更新し、内容を確認してください。values-pt-BR のようなディレクトリ名をそのまま使うと、想定される地域修飾子にはなりません。翻訳先パスの明示的な指定とロケールの表記については、CLI の設定を参照してください。

最初の翻訳先ロケール向けに翻訳し、読み込む #

翻訳先ファイルがまだない場合は、次を実行します。

sh
lingo push --backfill-missing --wait

設定されているレビューも含め、処理が完了するのを待ってから、取得した XML を確認します。リソース名、配列の順序、数量属性、固定の製品名、書式指定子を翻訳元と比較してください。--wait を使わない場合は、送信に使ったチェックアウトで lingo pull を実行し、完了した処理の結果を取得します。

プロジェクトの Gradle 設定でビルドし、翻訳先ロケールに設定した実機またはエミュレーターでアプリを実行します。画面を開き、名前といくつかの異なる件数を入力してください。ビルドが成功すれば、リソースの構文と参照を検証できます。端末上では、Android が翻訳済みディレクトリを実際に選択したかを確認します。

翻訳先言語の各複数形カテゴリに該当する件数で、出力を確認してください。ハンドラーは翻訳元の複数形構造を維持するため、英語の one と other だけでは、翻訳先言語に必要な形式がすべて揃うとは限りません。長いラベルやアクセシビリティ用テキストに加え、必要に応じて右から左へのレイアウトも確認してください。lingo check は、Android リソースの検証や網羅性の確認の代わりにはなりません。

翻訳元の変更に継続して対応する #

翻訳元、承認済みの翻訳、連携設定、.lingo/lock.json をまとめてコミットします。翻訳元の文字列を編集したら、次のコマンドで変更箇所を翻訳します。

sh
lingo push --wait

エンジンへの指針を変更した後、一つの翻訳元ファイルの翻訳をすべて再生成するには、承認済みの翻訳を保存してから次を実行します。

sh
lingo push "app/src/main/res/values/strings.xml" --force --wait

これにより、設定済みの翻訳先ロケールで、選択したファイルの翻訳が置き換えられます。ファイルの選択と再生成については、CLI のスコープを参照してください。

翻訳の変更前後の差分を残してください。上記の製品名の例のように、翻訳しない Android リソースには translatable="false" を指定します。再生成の前には、既存の修正を保存してください。送信後に行われた翻訳の編集を検出するには、--wait を省略し、取得前に lingo pull --dry-run を確認します。この確認と競合への対処については、レビュー済みの翻訳を保持するで説明しています。

一つの画面で動作を確認できたら、GitHub App または CI ランナーを使って継続的に翻訳します。ランナーは認証とレビュー可能な書き戻しを担いますが、承認前には引き続き Android のビルドと代表的な画面の確認が必要です。別の場所でコミットされた翻訳はバージョン管理を通じて取り込み、lingo pull ではローカルに記録された送信の結果を取得します。