SwiftUI-国际化 - 技术栈

介绍

如果 App 需要提供给不同国家的用户使用，则需要进行国际化处理。
SwiftUI 项目的国际化主要包括：Info.plist 文件国际化、文本国际化等。

配置国际化语言

在进行国际化之前，必须要添加需要的国际化语言，选中国际化的项目 ---> PROJECT ---> Info ---> Localizations ，点击+添加需要的国际化语言（默认已经存在英文）。

Info.plist文件国际化

新建一个Strings File，必须命名为InfoPlist.strings。
选中InfoPlist.strings，在 Xcode 的右侧文件检查器中找到Localization，点击Localize...，然后勾选配置的国际化语言。
InfoPlist.strings左侧多了一个箭头，点击箭头展开后可以看见不同语言的Strings File，里面存放的是形如Key = Value的键值对。
在不同语言的Strings File中设置需要国际化的内容，如 App 名称等。

swift 复制代码

// 英文App名
"CFBundleName" = "I18N";

swift 复制代码

// 中文App名
"CFBundleName" = "国际化";

文本国际化

新建一个Strings File，必须命名为Localizable.strings。
选中InfoPlist.strings，在 Xcode 的右侧文件检查器中找到Localization，点击Localize...，然后勾选配置的国际化语言。
Localizable.strings左侧多了一个箭头，点击箭头展开后可以看见不同语言的Strings File。
在不同语言的Strings File中设置需要国际化的文本键值对。

swift 复制代码

// 英文
"title" = "Reminder";
"message" = "Weather Information";
// 插值
"Weather is %@" = "Today is %@";
"Temperature is %lld" = "The temperature is %lld";

swift 复制代码

// 中文
"title" = "提示";
"message" = "今日天气";
// 插值
"Weather is %@" = "今天 %@";
"Temperature is %lld" = "气温 %lld 度";

SwiftUI 文本国际化非常简单，开箱即用，因为大多数 View 与 Modifier 的构造方法中都将LocalizedStringKey作为参数类型，该参数的值为文本键值对中的键。

swift 复制代码

import SwiftUI

struct ContentView: View {
    let weather = "Sunny"
    let temperature = 10

    var body: some View {
        VStack {
            // 纯文本，有3种方式
            Text(title)
            
            Text(LocalizedStringKey("title"))

            Text("title", comment: "The title of the dialog.")
            
            // 自定义View
            MessageView("message")
            
            // 插值
            Text("Weather is \(weather)")
            
            Text("Temperature is \(temperature)")   
        }
    }
}

struct MessageView: View {
    var messaege: LocalizedStringKey

    init(_ messaege: LocalizedStringKey) {
        self.messaege = messaege
    }

    var body: some View {
        Text(messaege)
    }
}

注意：插值格式参考 String Format Specifiers。

测试

默认情况下，App 的语言随着系统语言的变化而变化。但在开发阶段，如果才能快速测试 App 的国际化效果？主要有以下几种方式。

运行 App 之后在设备/模拟器通过设置（Settings）---> 通用（General）---> 语言与地区（Languages & Region） 切换系统语言以查看 App 的国际化效果。
通过 Xcode 菜单 ---> Product ---> Scheme ---> Edit Scheme... ---> Run ---> Options ---> App Language，选择需要测试的国际化语言之后再运行 App。
通过 Xcode 菜单 ---> Product ---> Scheme ---> Manage Scheme... ---> 选择需要复制的 Scheme ---> 点击下方的圆形...图标 ---> Duplicate ---> 重命名 Scheme，然后将复制的 Scheme 按照方式 2 将 App Language 设置为需要测试国际化语言，最后运行时选择对应国际化语言的 Scheme。

效果

英文。

中文。