文字列のローカライズ
ローカライズとは、アプリケーションを異なる言語、地域、文化的な慣習に適応させるプロセスです。 このガイドでは、翻訳ディレクトリの設定方法、地域固有の形式の扱い方、右から左へ記述する言語 (RTL) の扱い方、およびクロスプラットフォームでのローカライズのテスト方法について説明します。
Compose Multiplatform で文字列をローカライズするには、サポートされているすべての言語でアプリケーションのユーザーインターフェース要素に翻訳されたテキストを提供する必要があります。Compose Multiplatform は、共通のリソース管理ライブラリとコード生成を提供することで、このプロセスを簡素化し、翻訳への簡単なアクセスを可能にします。
翻訳ディレクトリの設定
すべての文字列リソースは、共通ソースセット内の専用の composeResources ディレクトリに格納します。 デフォルトのテキストは values ディレクトリに配置し、各言語に対応するディレクトリを作成します。 以下の構造を使用してください。
commonMain/composeResources/
├── values/
│ └── strings.xml
├── values-es/
│ └── strings.xml
├── values-fr/
│ └── strings.xml
└── ... (other locale directories)values ディレクトリとそのローカライズされたバリアント内で、キーと値のペアを使用して strings.xml ファイルに文字列リソースを定義します。 例えば、commonMain/composeResources/values/strings.xml に英語のテキストを追加します。
<resources>
<string name="app_name">My Application</string>
<string name="greeting">Hello, world!</string>
<string name="welcome_message">Welcome, %s!</string>
</resources>次に、翻訳に対応するローカライズされたファイルを作成します。例えば、commonMain/composeResources/values-es/strings.xml にスペイン語の翻訳を追加します。
<resources>
<string name="app_name">Mi Aplicación</string>
<string name="greeting">¡Hola mundo!</string>
<string name="welcome_message">¡Bienvenido, %s!</string>
</resources>静的アクセス用のクラスを生成する
すべての翻訳を追加したら、プロジェクトをビルドして、リソースへのアクセスを提供する特殊なクラスを生成します。 Compose Multiplatform は composeResources 内の strings.xml リソースファイルを処理し、各文字列リソースに対して静的アクセサープロパティを作成します。
結果として得られる Res.strings オブジェクトにより、共有コードからローカライズされた文字列に安全にアクセスできます。 アプリのUIに文字列を表示するには、stringResource() コンポーザブル関数を使用します。 この関数は、ユーザーの現在のロケールに基づいて正しいテキストを取得します。
import project.composeapp.generated.resources.Res
@Composable
fun MyApp() {
Text(stringResource(Res.strings.app_name))
Text(stringResource(Res.strings.greeting))
Text(stringResource(Res.strings.welcome_message, "User"))
}上記の例では、welcome_message 文字列には動的な値のためのプレースホルダー (%s) が含まれています。 生成されたアクセサーと stringResource() 関数はどちらも、このようなパラメータの受け渡しをサポートしています。