SwiftUI开发教程系列 - 第十二章：本地化与多语言支持

news2024/11/13 16:27:20

随着应用程序的全球化需求增加，为了方便不同地区的用户，支持多语言和本地化变得越来越重要。SwiftUI 为开发者提供了便捷的本地化方法，让应用能够根据用户的设备语言自动适配。

12.1 本地化的基本概念

本地化（Localization）指的是将应用程序的内容（如文本、图片和日期格式等）转换为适合特定地区的形式。Apple 的本地化机制依赖于 .strings 文件，用于存储多语言的文本内容。我们可以将应用的文本抽离到 .strings 文件中，让 SwiftUI 根据用户语言自动加载。

12.2 设置项目的多语言支持

在 Xcode 中，我们可以简单地为项目添加多种语言支持：

选择项目文件，进入“Info”标签页。
找到“Localizations”部分，点击 “+” 按钮，添加需要支持的语言（如法语、德语、日语等）。
选择所需文件进行本地化，确保 .strings 文件处于勾选状态。

12.3 创建 Localizable.strings 文件

Localizable.strings 是一个特殊的字符串文件，用于存放不同语言的文本内容。每个语言的 .strings 文件需要放置在相应的语言目录中。

示例：创建 Localizable.strings 文件

假设我们需要将文本 “Hello, World!” 翻译为不同的语言，可以在项目中创建 Localizable.strings 文件并添加以下内容：

英文 (en.lproj/Localizable.strings)

"hello_message" = "Hello, World!";

中文 (zh-Hans.lproj/Localizable.strings)

"hello_message" = "你好，世界！";

这样，当用户设备语言设置为中文时，系统会自动加载中文内容，而英文用户则会看到英文文本。

12.4 使用 NSLocalizedString 实现本地化文本

在 SwiftUI 中，我们可以通过 NSLocalizedString 来加载 .strings 文件中的文本内容。NSLocalizedString 接收一个键值，并根据设备语言查找对应的翻译。

示例：在 SwiftUI 中使用 NSLocalizedString

struct ContentView: View {
    var body: some View {
        Text(NSLocalizedString("hello_message", comment: "A greeting message"))
            .padding()
    }
}

在 NSLocalizedString 中，“hello_message” 是 .strings 文件中的键，comment 参数为编译器提供注释。SwiftUI 会根据用户的设备语言加载正确的文本。

12.5 使用 Text 本地化字符串

SwiftUI 提供了更简便的 Text 初始化方法，直接传入字符串键值即可：

struct ContentView: View {
    var body: some View {
        Text("hello_message")
            .padding()
    }
}

当项目包含 Localizable.strings 文件时，SwiftUI 将自动从 .strings 文件中查找 hello_message 键对应的内容并进行显示。

12.6 本地化其他资源（图片和日期格式）

除了文本，应用中还有其他资源也需要本地化，比如图片和日期格式等。

本地化图片资源

在 Asset Catalog 中添加多语言图片时，可以为每个图片资源添加多个语言版本。Xcode 支持在 Asset Catalog 中直接添加本地化图片。

本地化日期格式

SwiftUI 的 Text 组件支持 Date 格式化显示。我们可以使用 DateFormatter 根据用户的区域设置来自动调整日期格式。

struct DateView: View {
    let date = Date()
    
    var body: some View {
        Text(date, style: .date)
            .padding()
    }
}

在上面的代码中，日期格式会自动根据用户的系统语言和区域设置来调整。

12.7 本地化数字和货币格式

SwiftUI 提供了 NumberFormatter，让数字和货币的显示符合用户所在区域的习惯。以下是一些常见的格式化示例：

示例：本地化数字格式

struct NumberView: View {
    let number: Double = 12345.67
    
    var body: some View {
        Text("\(number, format: .number.precision(.fractionLength(2)))")
            .padding()
    }
}

示例：本地化货币格式

struct CurrencyView: View {
    let amount: Double = 12345.67
    
    var body: some View {
        Text(amount, format: .currency(code: "USD"))
            .padding()
    }
}

通过这些格式化，数字和货币会自动根据用户的地区设置来显示。

12.8 动态切换语言

在某些应用场景中，我们可能希望用户能够在应用内随时切换语言。要实现这一功能，我们可以手动更改语言环境并重载视图内容。

示例：手动切换语言

SwiftUI 没有直接提供动态切换语言的功能，因此需要一些额外步骤。以下代码演示了如何通过更改 Bundle 来手动切换语言：

extension String {
    func localized() -> String {
        guard let path = Bundle.main.path(forResource: "zh-Hans", ofType: "lproj"),
              let bundle = Bundle(path: path) else {
            return self
        }
        return NSLocalizedString(self, bundle: bundle, comment: "")
    }
}

struct LanguageSwitcherView: View {
    @State private var currentLanguage = "en"
    
    var body: some View {
        VStack {
            Text("hello_message".localized())
            Button("切换到中文") {
                currentLanguage = "zh-Hans"
            }
        }
    }
}