[SwiftUI] SwiftUI での Localization 方法

⌛️ 3 min.

SwiftUI での Localization の方法を説明します。

Sponsor Link

ローカライゼーション

Storyboard を使用している時は、Storyboard ごとローカライズしたり、その中で使用される文字列をコードでローカライズしたりできました。

SwiftUI ではどうなのか確認してみます。

Storyboard を対象外とするので、イメージとテキストの扱いについて確認します。

以下では、英語をベース言語として、日本語対応分を追加する方法を説明します。

ローカライズされていないプロジェクト

以下のように、イメージとテキストを表示するアプリをローカライズしていきます。

アプリケーションコード


//
//  ContentView.swift
//
//  Created by : Tomoaki Yagishita on 2020/10/21
//  © 2020  SmallDeskSoftware
//

import SwiftUI

struct ContentView: View {
    var body: some View {
      ZStack {
        Image("AppImage")
          .resizable()
          .scaledToFit()
        VStack {
          Spacer()
          Text("Hello")
            .padding()
        }
      }
    }
}

struct ContentView_Previews: PreviewProvider {
    static var previews: some View {
        ContentView()
    }
}

リソースとしては、AppImage_EN.jpg を用意して、Assets.xcassets の中に、AppImage というイメージリソースを作り、登録しました。

「Resource setup」

日本語対応用として、AppImage_JP.jpg も別途用意しています。

英語バージョンは、以下のような画面となります。

「App image (english)」

プロジェクトのローカライズ設定

SwiftUI を使う時も同様に設定が必要です。

プロジェクトのローカライズ対応言語設定

Xcode 上で、プロジェクトからプロジェクト設定中の Localization を “+” ボタンを押して、(数多く表示される言語から) “Japanese” を選択して追加します。

「Project setting for Localization」

これで、プロジェクトのローカライズ設定は終わりです。

以降、ローカライズしたい対象の要素についてローカライズ設定を行なっていきます。

テキストのローカライズ

基本的には、UIKit を使っていた時と同じです。

ただし、SwiftUI では、文字列指定されたテキストは、デフォルトで、ローカライズのキーとして扱われます。ですので、特別な設定をせずとも、ローカライズ対象になっています。

Localizable.strings ファイルの作成

Localizable.strings を作成します。　Xcode の新規ファイルから、Strings ファイルを選択し、ファイル名を Localizable.strings にして、保存します。

その後、Xcode の Project Navigator 上で Localizable.strings を選択してから、File Inspector 上で、”Localize…” ボタンを押します。次に表示されるダイアログは、現在のファイルをどの言語対応とするかの選択です。　English を選んで “Localize” ボタンを押します。