localization

本地化 / 多语言

支持语言

• 主语言：简体中文（zh-Hans）
• 次要语言：英文（en）
• 语言文件位置：Resources/zh-Hans.lproj/ 和 Resources/en.lproj/

---

文案管理规范

Key 命名规则

• 所有用户可见文字必须走本地化，禁止硬编码中文或英文字符串
• Key 命名：模块.组件.含义（全小写，点分隔）
• 相同含义的按钮/标签用统一 Key，禁止重复定义

camera.permission.title = "需要相机权限"
camera.permission.message = "请在设置中开启相机权限，以使用录制功能"
camera.button.start = "开始录制"
camera.button.stop = "停止录制"
settings.title = "设置"
settings.button.logout = "退出登录"
paywall.title = "升级 Pro"
paywall.trial.days = "免费试用 %d 天"

---

代码使用

标准用法

label.text = NSLocalizedString("camera.button.start", comment: "录制按钮")

项目封装（推荐）

extension String {
    var localized: String {
        NSLocalizedString(self, bundle: .main, comment: "")
    }

    func localized(with arguments: CVarArg...) -> String {
        String(format: self.localized, arguments: arguments)
    }
}

// 使用
label.text = "camera.button.start".localized
let text = "paywall.trial.days".localized(with: 7)

---

复数处理（.stringsdict）

创建 Localizable.stringsdict

文件位置：Resources/zh-Hans.lproj/Localizable.stringsdict 和 Resources/en.lproj/Localizable.stringsdict

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>%d items selected</key>
    <dict>
        <key>NSStringLocalizedFormatKey</key>
        <string>%#@items@</string>
        <key>items</key>
        <dict>
            <key>NSStringFormatSpecifierKey</key>
            <string>%d</string>
            <key>NSStringFormatValueTypeKey</key>
            <string>d</string>
            <key>one</key>
            <string>%d 项已选中</string>
            <key>other</key>
            <string>%d 项已选中</string>
        </dict>
    </dict>
    <key>%d hours remaining</key>
    <dict>
        <key>NSStringLocalizedFormatKey</key>
        <string>%#@hours@</string>
        <key>hours</key>
        <dict>
            <key>NSStringFormatSpecifierKey</key>
            <string>%d</string>
            <key>NSStringFormatValueTypeKey</key>
            <string>d</string>
            <key>one</key>
            <string>%d hour remaining</string>
            <key>other</key>
            <string>%d hours remaining</string>
        </dict>
    </dict>
</dict>
</plist>