Xcode 27の多言語UIプレビュー方法？2026年ローカライズ検収

翻訳を追加したのにプレビューが切り替わらない、ボタンの文字が画面からはみ出す。
最短の進め方は、対象言語のリソースを準備してXcode 27の多言語UIプレビューで配置を確認し、その後、シミュレーターまたは実機で言語と地域を指定して検収することです。プレビューだけで実行時の動作まで合格と判断しないでください。

翻訳を追加・更新している個人開発者は、画面レイアウトの早期確認に使えます。
SwiftUIまたはInterface Builderを使う開発者は、それぞれのプレビュー方法と確認範囲を把握できます。
リモートMacでXcodeを動かす小規模チームは、どの確認をその環境に載せるか判断できます。

※ 2026年10月14日更新。Xcode 27の機能と操作範囲は、AppleのXcode 27リリースノートおよびローカライズプレビューの公式資料を基に確認しています。利用中のパッチ版で項目が見当たらない場合は、その版のリリースノートを確認してください。

プレビューと実行検収は役割を分ける

Xcode 27では、異なるローカライズ環境でUIをプレビューする機能がリリースノートに記載されています。ただし、プレビューは文字列の長さやレイアウトを早い段階で確認するためのものです。アプリの実行時に言語・地域が正しく反映されるか、画面遷移を含めて問題なく表示されるかは、別途シミュレーターまたは実機で確かめます。

Xcodeの版や画面の種類によってプレビュー操作は異なります。操作項目が見つからないときは、機能が利用可能かをリリースノートで照合したうえで、プロジェクトの言語設定と画面形式を確認してください。

画面を開く前に、言語リソースをそろえる

最初に、プロジェクトで対象言語をサポートしているか確認します。言語を追加しただけで翻訳内容が完成するわけではありません。ローカライズファイルが未作成、または一部のキーが未翻訳なら、プレビュー側の不具合ではなくリソースの不足が原因かもしれません。

既存の翻訳をプロジェクトへ取り込む場合は、Xcodeのローカライズ読み込み手順を参照してください。新たな言語や地域を加える作業については、言語と地域のサポートに関するAppleの説明に沿って、プロジェクトの設定と対象リソースを確認します。

この段階では、次の状態を混同しないようにします。

• リソースが未準備：対象言語の翻訳がなく、表示する文字列を用意できていません。
• プレビューの言語が未変更：リソースはあっても、プレビュー環境が別の言語のままです。
• 翻訳内容の問題：文字列は切り替わっていますが、意味や文体が不自然です。

この切り分けをせずにビューのコードを直すと、レイアウトの修正が不要なケースまで調査してしまいます。

Xcode 27の多言語UIプレビューで表示を比べる

SwiftUIではLocaleとレイアウト方向を確認する

SwiftUIのプレビューでは、対象ローカライズを選べる設定があれば、そこで確認する言語を指定します。コードから条件を固定したい場合は、PreviewにLocaleを環境値として渡す方法があります。

#Preview("French") {
    ContentView()
        .environment(\.locale, Locale(identifier: "fr"))
}

この指定は、翻訳済み文字列や日付などの表示を確かめる手がかりになります。ただし、ローカライズリソースが欠けていると、Localeを変えても期待した表示にはなりません。翻訳の切り替わりを確認したら、見出しの改行、ボタン内の文字の収まり、本文との優先順位を順番に見ます。

RTL（右から左へ読む）言語では、文字列だけの置き換えでは不十分です。SwiftUIのレイアウト方向に関する公式資料を確認し、必要に応じてプレビューのレイアウト方向も設定してください。矢印やナビゲーションの並び、左右の余白が言語に合わせているかを見ます。

Interface Builderでは制約と疑似言語を確認する

StoryboardやXIBを使う画面では、Interface Builderで用意されているローカライズ表示や疑似言語のプレビューを選び、テキストが長くなった場合の表示を確認します。ラベルの幅が固定されていないか、ボタンの高さが文字に追従するか、隣接するコントロールと重ならないかを見てください。

Appleのローカライズに備えたインターフェイス設計資料は、翻訳後の文字列に合わせて画面を構成する際の確認に役立ちます。疑似言語で問題が出なかった場合も、実際の翻訳は単語の長さや改行位置が異なるため、対象言語の文字列で再確認してください。

疑似言語は、文字列の拡張によるレイアウト崩れを見つける手段です。実際の翻訳品質や実行時の言語設定が正しいことを示すものではありません。

発見した問題を同じ条件で修正する

プレビューで問題を見つけたら、画面名だけでなく、言語、地域、入力したプレビュー条件、再現した表示を記録します。条件を残せば、修正後に同じ画面を開いて、直ったかどうかを比較できます。

文字列自体に問題がある場合は翻訳リソースを直し、配置に問題がある場合は制約やレイアウトを見直します。修正と再確認で別の言語設定を使うと原因が追いにくくなるため、記録した条件を維持してください。

よくある確認事項

SwiftUIのプレビューでアプリの言語を切り替えるには？

対象言語のローカライズリソースを確認したあと、プレビュー設定でその言語を選びます。コードで条件を明示する場合は、Localeを環境値として渡します。地域ごとの日付や数値も画面に出るなら、言語だけで済ませず、実行時の地域設定も合わせて検収してください。

Interface Builderで疑似言語を確認できますか？

Interface Builderのプレビューで、用意されているローカライズや疑似言語を選べる場合は、文字列が長くなった際の制約や表示を確認できます。これは開発中のレイアウト確認です。実際の翻訳の意味や、アプリ起動時に対象言語が使われることの確認は、シミュレーターまたは実機で行います。

RTL言語の画面はどこを見るべきですか？

RTLの文字列に切り替えるだけでなく、レイアウト方向も対象にして、配置順や余白、戻る操作、アイコンの向きを確認します。左右どちらに置くべきかが意味によって変わるアイコンもあります。プレビューで確認した後、実行環境でも同じ言語を指定して操作してください。

プレビューに問題がなければ実行テストは不要ですか？

不要ではありません。プレビューは画面レイアウトの確認に有効ですが、実行中の言語・地域の反映、画面遷移、アプリ内の状態変化までを代替しません。対象言語と地域でシミュレーターまたは実機を動かし、必要なら対象言語を使う人にも翻訳の自然さを確認してもらいます。

シミュレーターまたは実機で検収を完了する

プレビューでの確認が済んだら、アプリ実行時にローカライズをテストする手順に従い、対象の言語と地域でアプリを実行します。プレビューで見た画面に加えて、アプリ内の移動、入力、エラー表示など、利用中に通る画面も確認してください。

公開準備の判定は、次の段階を分けて記録します。

• プレビュー確認済み：主要な画面で文字切れ、重なり、RTLの不整合が見つからない。
• 実行確認済み：対象の言語と地域を設定したシミュレーターまたは実機で、表示と操作を確かめている。
• ローカライズ公開準備済み：翻訳リソースと実行結果を確認し、対象言語を理解する人による表現の確認も済んでいる。

ローカライズ資料の参照や画面の修正は手元のMacで進められますが、継続してXcodeを動かす環境がないと、実行確認のたびに作業場所や端末を確保する負担が生じます。手元のMacは環境を直接管理しやすい一方、ストレージの空きや保守を自分で確保する必要があります。単発の確認なら手元の環境やチーム内の既存環境で足りる場合もありますが、Macを持たずに繰り返し検収したいなら、リモートMacを選択肢に加えられます。

MacDateのリモートMacを検討する場合は、先に利用できる環境とアクセス方法を確認し、Xcodeのプレビューだけでなく、シミュレーターや実機での確認を自分の開発手順に組み込めるか判断してください。月ごとの費用を手元のMacの維持と比べたい場合は、Macの料金案内も参照できます。プレビュー合格で止めず、実行時の言語・地域まで確かめる運用が、公開前の見落としを防ぐ基準になります。