如何对 iOS 应用中的文本进行本地化

此时，再在模拟器或者真机上安装 app，app 的名称将会在不同的语言下显示对应的文字。

在最近两个版本的 Xcode 中，可以不直接设置 Info. plist，通常在 Target 的 Info 中查看或修改值

实战 4：本地化饮品名称

在 Localizable(Chinese) 字符串文件中添加如下内容

关于饮料的定义请查看 Model/Drink.swift 代码

通过设置本地环境变量查看预览，或者将模拟器语言改成中文，亦或者在 Scheme 中将 App Lanuguage 改成中文。

执行 app，我们并没有获得预期的效果。饮品的名称并 没有变成中文 。此时通过查看 Drink.swift 我们可以找出原因：对于已经明确了的 String 类型，Text 是不会将其视作 LocalizedStringKey 的。

之前在 ItemRowView 中，我们通过如下代码显示饮品名称：

Text(item.drink.name)
          .padding(.leading,20)
          .frame(maxWidth:.infinity,alignment: .leading)

而饮品的名称在 Drink 中的定义如下

struct Drink:Identifiable,Hashable,Comparable{
    let id = UUID()
    let name:String //String 类型
    let price:Double
    let calories:Double

因此最简单的办法就是修改 ItemRowView 的代码

Text(LocalizedStringKey(item.drink.name))
         .padding(.leading,20)
         .frame(maxWidth:.infinity,alignment: .leading)

在某些情况下，我们只能获得 String 类型数据，可能会经常做类似的转换

再次运行，你将可以看到表格中的饮品名称已经更改为正确的中文显示

修改后的代码可以正常的显示饮料名称的中文了。

上面的方法在绝大多数的情况下都是很好的解决问题的手段，但并不适合完全依赖 Export Localizations... 生成用于本地化键值对的项目。

为了能够更精确的对本地化后的文本进行排序，我们也可以对 Drink 的比较函数做近一步修改：

NSLocalizedString 可以通过给定的文本 键 获取对应后的文本 值

将 InfoView 中的

我们难道不能直接当 Drink 的 name 定义为 LocalizedStringKey 类型吗？

由于 LocalizedStringKey 不支持 Identifiable , Hashable , Comparable 协议，同时官方也没有提供任何 LocalizedStringKey 转换成 String 的方法。因此，如果我们想将 name 定义成 LocalizedStringKey 类型需要使用一些特殊手段（需通过 Mirror，本文就不展开介绍了）。

为本地化占位符添加位置索引

在声明本地化字符串时，相同类型的占位符在不同的语言中可能会出现语序不一样的情况。例如下面的日期和地点：

// Localizable.strings - en
"GO %1$@ ON %2$@" = "Go to %1$@ on %2$@";
"HOSPITAL" = "the hospital";
// Localizable.strings - zh
"GO %1$@ ON %2$@" = "%2$@去%1$@";
"HOSPITAL" = "医院";

暂时我们只能通过 String.localizedStringWithFormat 方法按照位置索引顺序添加插值内容：

var string:String{
    let formatString = NSLocalizedString("GO %1$@ ON %2$@", comment: "")
    let location = String(localized: "HOSPITAL", comment: "")
    return String.localizedStringWithFormat(
        formatString,
        location,
        Date.now.formatted(.dateTime.month().day())
Text(string)

此种方式无法在预览中通过修改环境值实时查看变化（ 在模拟器或实机中均可正确可以 ）

创建字符串字典文件

一些在中文里并不会存在的困扰，在其他一些语言中却是不小的问题。比较典型的如 复数 。如果你的 app 只有英文版并且只需应对较少名词时，或许可以将复数规则写死在代码里面。比如：

但这一方面不利于代码的维护，另一方面对于某些具有复杂复数规则的语言（比如俄语，阿拉伯语等）灵活性就太差了。

为了解决如何定义不同语言的复数规则，苹果在 .strings 之外又提供了另一种解决方案 .stringdict 字符串字典文件。

它是一个带有 .stringsdict 文件扩展名的属性列表文件，对它的操作和编辑其他的属性列表完全一样（比如 Info. plist）。

.stringsdict 最初是为了解决复数问题而提出的，不过这几年又陆续增加了针对不同的数值显示不同的文本（通常用于屏幕尺寸的变化），以及针对特定平台（iphone、ipad、mac、tvos）显示对应的文本等功能。

上图中，我们分别制定了使用 NSStringLocalizedFormatKey 的复数规则、 NSStringVariableWidthRuleType 可变宽度规则以及 NSStringDeviceSpecificRuleType 特定设备内容规则

.stringdict 的根节点为 Strings Dictionary ，我们的规则都需要建立在它之下。我们需要为每个规则首先建立一个 Dictionary 。上图中，三条规则分别对应的 键 为 device %lld 、 GDP 、 book %lld cups 。程序在碰到满足这三个 键 定义的文本内容时，将使用其对应的规则来生成正确的本地化内容。

所以尽管看起来和 .strings 略有不同，但实际上内在的逻辑是一致的。

制定复数规则

数量类别的含义取决于语言，并非所有语言都有相同的类别。

例如，英语只使用 one 和 other 类别来表示复数形式。阿拉伯语对 zero 、 one 、 two 、 few 、 many 、 other 类别有不同的复数形式。虽然俄语也使用 many 类别，但数字 many 类别中的规则与阿拉伯语规则不同。

除 other 外，所有类别都是可选的。

但是，如果您不为所有特定语言类别提供规则，您的文本在语法上可能不正确。相反，如果您为语言不使用的类别提供规则，则会忽略它并使用 other 格式字符串。

在 zero 、 one 、 two 、 few 、 many 、 other 格式字符串中使用 NSStringFormatValueTypeKey 格式说明符是可选的。比如上面的定义当数字为 1 时，返回的是 one cup，不需要必须包含对应的%lld

如何在各个语言中定义复数规则请查看 UNICODE 官方文档

可变宽规则

let gdp = (NSLocalizedString("GDP",comment: "") as NSString).variantFittingPresentationWidth(25)
Text(gdp) //返回 GDP(Billon Dollor)
let gdp = (NSLocalizedString("GDP",comment: "") as NSString).variantFittingPresentationWidth(100)
Text(gdp) //返回 GDP(anything you want to talk about)

没有完全相同的数字时，将返回最接近的内容。

它的使用场景，我感觉并非不可替代。毕竟在代码上的参与量多了些。

特定设备规则

目前支持的设备类型有：appletv、apple watch、ipad、iphone、ipod、mac

使用者不需要在代码中进行介入，系统将根据使用者的硬件设备返回对应的内容

实战 5：重新设定付款按钮

使用复数规则完善付款按钮。

付款按钮的代码在 ButtonView 中：

我们需要对 Pay for \(order.totalQuantity) drinks 进行设置。

首先创建 Localizable.stringsdict 文件

我们在实战 2 中曾经在 Localizable.strings 中为 Pay for %lld drinks 设置了键值对，但由于 .stringdict 的优先级更高，所以系统将优先使用 NSStringPluralRuleType 规则。

实战 6：戳我还是点我

根据不同的设备，在添加饮料的按钮上显示不同的内容。

比如，我们可以在 iphone、ipad 上显示 tap 、在 appletv 上显示 select 、在 mac 上显示 click

在 Chinese 中添加

Formatter 格式化输出

仅对显示标签进行本地化是远远不够的。在应用中，还有大量的数字、日期、货币、度量单位、人名等等方面内容都有本地化的需求。

苹果投入了巨大的资源，为开发者提供了一个完整的解决方案——Formatter。

在今年（2021），苹果对 Formatter 做了进一步的升级，不仅提高了 Swift 下的调用便利性，而且推出了适合 Swift 下使用的 FormatStyle 协议。

Formatter 涉及的内容非常多，单独编写一篇文章都未必介绍完全。下文中将通过 Demo 中的几个例子让大家有个基本的了解。

实战 7: 日期、货币、百分比

Text(order.date,style: .date) //显示年月日          
Text(order.date.formatted(.dateTime.weekday())) //显示星期

在 Demo 中我们通过了两种方式来本地化日期的显示。

Text 本身支持日期的格式化输出，不过这种方式可定制性不高。

使用了新的 FormatStyle 来链式定义输出内容：

order.date.formatted(.dateTime.weekday()) 将只显示星期几

      private func currencyFormatter() -> NumberFormatter {
          let formatter = NumberFormatter()
          formatter.numberStyle = .currency
          formatter.maximumFractionDigits = 2
          if locale.identifier != "zh_CN" {
              formatter.locale = Locale(identifier: "en-us")
          return formatter
Demo 中仅提供两种货币的价格，当系统的的区域的设置不是中国大陆的话，则将货币设置为美元。
在 Text 中应用 Formatter
          Swift
      
Text(NSNumber(value: item.amount),formatter:currencyFormatter() )
由于在 Text 中，Formatter 仅能用于 NSObject，因此需要将 Double 转换成 NSNumber。
目前 FormatStyle 提供的 Currency 可配置项太少，暂不采用。
      
init(name: String, price: Double, calories: Double) {
        self.name = String.localizedStringWithFormat(NSLocalizedString(name, comment: name))
        self.price = price
        self.calories = Measurement<UnitEnergy>(value:calories,unit: .calories) //设置时将原始数据设为 calorie
测量对象同样可以进行数据计算：
          Swift
      
    var totalCalories:Measurement<UnitEnergy>{
        items.keys.map{ drink in
            drink.calories * Double(items[drink] ?? 0)
        }.reduce(Measurement<UnitEnergy>(value: 0, unit: .calories), +)
创建描述 MeasureMent 的 Formatter
          Swift
      
    var measureFormatter:MeasurementFormatter{
        let formatter = MeasurementFormatter()
        formatter.unitStyle = .medium
        return formatter
在 SwiftUI 中显示
          Swift
      
    var list:String {
        order.list.map{NSLocalizedString($0.drink.name, comment: "")}.formatted(.list(type: .and))
使用 tabname 指定特定名称字符串文件
可以创建多个字符串文件，当该文件名不是 Localizabl 时，我们需要指明文件名称，比如 Other.strings
          Swift
tableName 同样适用于 .stringdict
指定其他 Bundle 中的字符串文件
如果你的 app 中使用了包含多语言资源的其他 Bundle 时，可以指定使用其他 Bundle 中的字符串文件
          Swift
      
import MultiLanguPackage // ML
Text("some text",bundle:ML.self)
在包含多语言资源的 Package 中，可以使用以下代码指定 Bundle
          Swift
      
Text("some text",bundle:Self.self) 
markdown 符号支持
苹果在 WWDC 2021 上，宣布可以在 Text 中直接使用部分 markdown 符号。比如：
          Swift
本文原为我针对 iOS 的本地化主题系列文章中的一篇，不过由于琐事较多，始终没有最终完成。