介绍
- 如果 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。
效果
- 英文。
- 中文。