ローカリゼーションとは?
自分が作ったアプリが人気になり、英語など他の言語にそのアプリを翻訳してもっと多くの人が使えるようにしたいと思うときが来るかもしれません。iOSのシステムは、ユーザー設定に基づきコンテンツを適切な言語で表示するなど、大方のローカリゼーションを行ってくれます。
アプリをローカライズする方法
Xcode 13では、ローカライゼーションをより簡単に行う方法があります。
Development language
の変更
開発言語とは、アプリの開発時に使用する言語のことを指します。まず、設定の内容を確認する必要があります:
プロジェクトファイルをクリックし、(ターゲットではなく)プロジェクトファイルを選択します。ローカリゼーションのセクションで、Development Language
が日本語なのか英語なのかを確認します。日本語の場合、設定は正しいので、何もする必要はありません。英語の場合、引き続き開発言語の変更のガイドに従ってください。
![スクリーンショット 2020-05-24 16.05.37.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F635330%2F819e7553-86c5-4105-9877-94f658c877c4.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=ec6b9b352ce73deedcafeb1a17265f4e)
次に Xcode
を閉じ、.xcodeproj
ファイルを右クリックして選択し、このファイルの内容を表示する:
![スクリーンショット 2020-05-24 16.08.33.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F635330%2F3eddb722-0927-76d2-1c39-42930d294683.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=25d60824a48fa450635f0f226ab4d967)
project.pbxproj
ファイルを見つけ、テキストエディターで開く。
![スクリーンショット 2020-05-24 16.09.42.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F635330%2Fa0283160-b8ff-683e-69b7-f8bf142013e9.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=245ec897edb5cb4c9a4d9a71ff5e8582)
developmentRegion
を検索し、ja
に変更する。
compatibilityVersion = "Xcode 9.3";
developmentRegion = en;
hasScannedForEncodings = 0;
上記のコードを以下に変更する
compatibilityVersion = "Xcode 9.3";
developmentRegion = ja;
hasScannedForEncodings = 0;
knownRegions
を検索する
knownRegions = (
en,
Base,
);
上記のコードを以下に変更する
knownRegions = (
ja,
en,
Base,
);
ファイルを保存して、再度 Xcode
を開く:
Development Language
が日本語に変更されているのをご確認いただけます
![スクリーンショット 2020-05-24 16.13.36.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F635330%2Fbbbe3ed3-040f-64cd-fb9f-83f9869a34db.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=94db9b1a22f8554040a3d5eeaf43634a)
新しい言語の追加
- ファイルナビゲーター内のプロジェクトファイルをクリックします
- プロジェクトファイルをクリックします
- 情報タブを開いていることを確認してください
-
Localizations
セクションのプラスボタンをクリックしてください - 追加したい言語を選択してください
![スクリーンショット 2020-05-24 16.15.42.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F635330%2Fc1c61ba0-f2f8-384a-b338-ce9fc1793b6c.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=bf94a373b39b7365a94113cb4b07faba)
また、必ずスイッチ Use Base Internationalization
を有効にしてください
![スクリーンショット 2020-05-24 16.53.57.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F635330%2Fbacb41b0-8283-d465-32d3-3d92274cb5ad.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=a02bd23996969baf8fab87a2563b5145)
ストーリーボードのローカリゼーション
初期設定
ローカリゼーションを最初にセットアップするとき、Xcodeはあなたのためにすべての文字列を抽出してそれらをファイルに入れる作業を行います。ストーリーボードのローカリゼーションをセットアップするには:
- Storyboard ファイルを選択します。
- 右側のパネルで、
Localizations
セクションを探し、追加したい言語のオプションをオンにします。
![スクリーンショット 2020-05-24 16.18.53.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F635330%2F50fc0256-8f29-c463-bbfc-1beec9c0ceb7.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=6bd14141a775b957331528c79b7da5f9)
これで、左側のファイルナビゲーターで、Storyboard ファイルを展開し、翻訳ファイルを確認できます:
![スクリーンショット 2020-05-24 16.20.10.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F635330%2F3426ad00-73d0-1984-3bd7-8661c3e05381.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=f7605fa787ec44406a71988efafdebe4)
Main.strings (English)
をクリックすると、原文と翻訳文のペアが表示されます:
/* Class = "UILabel"; text = "こんにちは"; ObjectID = "ok2-tj-BN9"; */
"ok2-tj-BN9.text" = "こんにちは";
さて、ok2-tj-BN9
は、Storyboard 上にあるUILabel
の要素IDです。ストーリーボードインターフェースに戻り、そのラベルを選択すると、その要素IDが表示されます:
![スクリーンショット 2020-05-24 16.22.14.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F635330%2F8f1d5290-6909-9cf7-a39e-53343ac3a50c.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=4673ec048b03a940fb0c2dbc0191767f)
また、.text
はその UILabel
のテキストプロパティを示しているにすぎません。
さぁ、これで翻訳済みのストリングを Main.strings (English)
に入れられるようになりました:
/* Class = "UILabel"; text = "こんにちは"; ObjectID = "ok2-tj-BN9"; */
"ok2-tj-BN9.text" = "Hello";
トランスレーションの追加
さらにトランスレーションを追加したい場合。 UIStoryboard
でエレメントのオブジェクトIDを見つけ、それを Main.strings (English)
ファイルに追加する。
エレメントが異なる場合、プロパティは同じではない:
//9rM-vm-U1g is an UITextField. Placeholder means placeholder.
"9rM-vm-U1g.placeholder" = "ユーザー名";
//GsY-2N-hIy is an UIButton, normalTitle means the title of the button at normal.
"GsY-2N-hIy.normalTitle" = "ボタン";
//BYZ-38-t0r is an UIViewController
"BYZ-38-t0r.title" = "登録画面";
文字列のローカライズ
文字列ファイルを作成する
command-Nを押し、Strings file
を作成する
![スクリーンショット 2020-05-24 16.33.11.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F635330%2Fda308fb7-1bdd-41cd-72e5-b265b8dcfcac.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=acdfa21d225c70c62518359eb79d6bd1)
ファイル Localizable.strings
に名前を付ける
Xcodeでそのファイルを選択し、右側のローカライズボタンを選択する。ポップアップで英語を選択する。次に、右側のパネルで、すべての言語を選択する。
![スクリーンショット 2020-05-24 16.35.48.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F635330%2Ffcdac467-c55b-ea02-c8a7-14f927ed2d51.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=232860c9d7dfd3bd76f1fa19528cca56)
全ての文字列を NSLocalizedString
に入れて下さい
この例では、元のコードは以下です:
@IBAction func actionPress(){
let alert = UIAlertController(title: "こんにちは", message: nil, preferredStyle: .alert)
let actionClose = UIAlertAction(title: "はい", style: .cancel, handler: nil)
alert.addAction(actionClose)
present(alert, animated: true, completion: nil)
}
@IBAction func actionPress(){
let alert = UIAlertController(title: NSLocalizedString("こんにちは", comment: ""), message: nil, preferredStyle: .alert)
let actionClose = UIAlertAction(title: NSLocalizedString("はい", comment: ""), style: .cancel, handler: nil)
alert.addAction(actionClose)
present(alert, animated: true, completion: nil)
}
コードファイルから文字列を抽出する
- Terminal を開く
-
cd
コマンドで.lproj
ファイルがある場所に移動し、以下のコマンドを実行する
find . -name \*.swift | xargs genstrings -o en.lproj
find . -name \*.swift | xargs genstrings -o ja.lproj
en.lproj
ファイルを開く:
ご覧の通り、すでにプログラムの文字列が含まれています:
/* No comment provided by engineer. */
"こんにちは" = "こんにちは";
/* No comment provided by engineer. */
"はい" = "はい";
これで、英語の訳を追加することができます:
/* No comment provided by engineer. */
"こんにちは" = "Hello";
/* No comment provided by engineer. */
"はい" = "Yes";
ローカリゼーションのデバッグ
シミュレーターの言語を変更する
シミュレーターの言語を変更するには、Edit Schemeをクリックします。
![スクリーンショット 2020-05-24 16.45.10.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F635330%2F3ae85385-34c0-f329-8765-ba630516e466.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=cd352553b977f2d0fe989ab8fc99ac5b)
Options
タブを選択すると、Application Language
を編集できるようになります。
![スクリーンショット 2020-05-24 16.45.54.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F635330%2Fc14c673f-a658-97d9-0100-b263bea37906.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=b5846bc0023e5f80776a8e95b3d3e8b1)
プログラムを英語で実行すると次のようになります:
![スクリーンショット 2020-05-24 16.45.10.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F635330%2F02838691-8d1b-fa97-409a-ab54ad6f5e6a.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=0fcadffd1d42640c70bc75a603dcd2bf)
ローカライズされていない文字列の確認方法:
再度、設定 Edit Scheme
のタブ Options
を開き、Show non-localized strings
をオンに切り替える。
![スクリーンショット 2020-05-24 16.49.09.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F635330%2F576a853b-29dc-0c20-ab7e-5d6a9c2c1d9c.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=4c72babe41260fccf9066f471e25c705)
この状態でプログラムをテストする。ローカライズされていない文字列があれば、コンソールにエラーが表示される:
![スクリーンショット 2020-05-24 16.57.13.png](https://qiita-user-contents.imgix.net/https%3A%2F%2Fqiita-image-store.s3.ap-northeast-1.amazonaws.com%2F0%2F635330%2F2392c0d7-9a81-9a7b-5af9-078c6229f6bc.png?ixlib=rb-4.0.0&auto=format&gif-q=60&q=75&s=48a6d8ff774b27a47d7ed976cdb2dd4d)
Like this message:
localization[3921:116986] [strings] ERROR: pBD-R7-cpO.text not found in table Main of bundle CFBundle 0x7fdab8704210
実際のデバイスでアプリケーションの言語を変更する:
実際のデバイスでアプリケーションをテストしてから、アプリケーションの言語を切り替える必要がある。そのためには:
-
システム設定を開く
-
アプリの名前を見つけ、アプリの設定を開く
-
言語オプションをクリックする
-
言語を切り替える
-
これで、自分のアプリをテストすることが可能となります。