实现模块化应用的本地化

前言

我已经有一段时间没有从头开始一个需要支持多种语言的新项目了。当然不是从头开始，而是在代码库中通过使用 Swift 包将代码分成不同模块。

我想提醒自己记住许多在本地化实行中的过程，所以我认为最好写一篇文章，以便下次开始同类型项目时可以参考。

开始吧！

让我们看看代码库的一个简化版本。它包含一个 Xcode 项目，一个单独的 app target（即将运行的那个）和一个名为 Features 的 Swift 包。后者将包含 app 中所有页面的代码，每一页将被定义为自己的产品：

Package.swift

// swift-tools-version: 5.6
import PackageDescription

let package = Package(
    name: "Features",
    products: [
        .library(
            name: "Home",
            targets: ["Home"]),
        .library(
            name: "Detail",
            targets: ["Detail"]
        )
    ],
    dependencies: [
    ],
    targets: [
        .target(
            name: "Home"
        ),
        .target(
            name: "Detail"
        )
    ]
)

这个 app target 将会作为 app 的组合层，其唯一的目的是导入每个功能，实例化它们并协调导航。所有的 UI ，演示和业务逻辑将留在各自的 “模块” 中（Features Swift Package 中的一个 target）。这将允许每个功能独立开发并完全的与其他功能隔离。

为了简单起见，这个例子里仅有两个功能：主页和详情，他们代表 app 中仅有的两个页面。

主页有一个按钮允许用户导航到详情页面，还有一个标签展示用户当前所在区域的语言代码。详情页只展示一个标签，和主页标签展示的信息一致：

Images of both screens with english selected as the language

添加字符串！

看起来不错，但是现在展示的信息是用英文通过硬编码编写的字符串。app 需要内容被翻译成另外两种语言：加泰罗尼亚语和西班牙语。

虽然有多种实现方式，我更倾向每个功能（或页面）只包含它所需要的本地化字符串，这样可以增加功能的可移植性和可重用性。

这可以在 Swift 包中完成，通过将所有必需的 .lproj 文件和所有需要本地化的内容（当前例子中只有 Localizable.strings 文件）放在目标文件夹下 - 我的习惯是放在父 Resources/ 文件夹下，并将这些资源定义为 Package.swift 的特定 target。

添加文件之后构建该功能将导致编译器抛出如下错误：

Error thrown by Xcode when no default localisation is set

这是因为 defaultLocalization 必须由 Package.swift 提供。所有功能的 target 来自一个包，所以只能有一个 defaultLocalization 。以下是 Package.swift 添加本地化内容之后的样子：

Package.swift

// swift-tools-version: 5.6
import PackageDescription

let package = Package(
    name: "Features",
    defaultLocalization: "en",
    platforms: [.iOS(.v15)],
    products: [
        .library(
            name: "Home",
            targets: ["Home"]),
        .library(
            name: "Detail",
            targets: ["Detail"]
        )
    ],
    dependencies: [
    ],
    targets: [
        .target(
            name: "Home",
            dependencies: [],
            resources: [.process("Resources/")]
        ),
        .target(
            name: "Detail",
            resources: [.process("Resources/")]
        )
    ]
)

注意：如果没有为默认的本地化代码提供本地化的内容，编译器会显示警告。这对于确保你不会发布包含基本本地化内容的软件包版本非常有帮助。

支持本地化

可能与你的想法正好相反，把设备系统语言设置为加泰罗尼亚语或西班牙语并且运行 app 内容仍然用英文展示。原因是 Swift 包需要额外的信息去决定使用哪些本地化的内容，就目前来看，如果包里有目标内容，它们将只使用目标的基本本地化，否则使用包的默认本地化。

现在有两种方式我们可以实现本地化：使新的本地化在 app target 中可用或启用混合本地化。

在 app target 中添加新的本地化内容

在 Features Swift 包中启用新的本地化的一种方式是将它们添加到导入功能的 Xcode 项目中。这可以通过进入 Xcode 项目，在项目设置中的 “Info” 一栏，添加本地化支持：

需要注意的是，本地化需要至少一个文件（例如一个空的 Localizable.strings 文件）。在本例中，因为 app target 是用 UIKit 构建的，并且在添加新的本地化时选择了启动 storyboard 进行本地化（如上视频所示），所以已经有一个本地化文件。

现在这将允许包从主包中获取支持的本地化，并选择相应的要使用的资源。

值得注意的是，如果设备有被 app 支持但是包不支持的语言，则后者将会回退到 Package.swift 中提供的 defaultLocalization .

同样的，如果 app 不支持该语言，同样会回退到相同的值。这也是为什么将 defaultLocalization 设置为与主目标基础语言相同，以确保所有页面上的一致性是非常重要的。这也是我更倾向于所有功能分组在一个 Swift 包之下的原因，这样所有页面上的 defaultLocalization 就有了单一真正的来源。