如何为Tuist搭建的应用配置多语言国际化支持

1. 准备本地化资源 #

• 在项目根目录新建本地化资源存放目录，推荐命名为Resources/Localizations
• 按需要支持的语言新建对应后缀为.lproj的文件夹，例如简体中文对应zh-Hans.lproj、英文对应en.lproj
• 将各语言对应的Localizable.strings、InfoPlist.strings等本地化文件放入对应语言的.lproj目录中

2. 编辑Project.swift配置 #

在你的项目配置文件中，给对应App Target的resources配置项添加本地化资源路径，参考配置如下：

let project = Project(
    name: "你的项目名称",
    targets: [
        Target(
            name: "你的App目标名",
            platform: .iOS,
            product: .app,
            bundleId: "com.your.bundleid",
            // 其余基础配置省略
            resources: [
                // 递归匹配所有本地化资源
                .glob(pattern: "Resources/Localizations/**")
            ],
            // 可选：配置项目默认开发语言
            settings: .settings(base: [
                "DEVELOPMENT_LANGUAGE": "zh-Hans"
            ])
        )
    ]
)

• 路径后的**通配符会递归匹配该目录下所有子文件，Tuist会自动识别.lproj格式的文件夹为本地化资源，无需逐个语言单独配置
• 如果有xib、storyboard类型的本地化资源，直接放入对应.lproj目录即可，无需额外修改配置

3. 验证配置生效 #

• 执行tuist generate命令重新生成Xcode项目
• 打开生成的Xcode项目，进入项目设置的「Info」标签，确认「Localizations」列表已包含所有你配置的支持语言
• 任意打开一个.strings文件，查看右侧文件检查器的「Target Membership」选项，确认文件已关联到对应的App目标

注意事项 #

• 不要直接在生成的Xcode项目中修改本地化配置，所有调整都需要在Project.swift中完成，否则下次执行tuist generate时手动修改的内容会被覆盖
• 如果需要开启Base国际化，只需新增Base.lproj目录存放基础界面文件，同时在settings配置中添加USE_BASE_INTERNATIONALIZATION = "YES"即可

内容的提问来源于stack exchange，提问作者Björn Lindner