解决 Swift String Catalog 无法移除语言问题终极指南

2024-12-14 04:10:00

解决Swift String Catalog无法移除语言问题

在iOS应用开发中，使用String Catalog进行本地化是一种常见做法。但有时，开发者可能会遇到无法从应用设置中移除已添加语言的问题。即使已从项目中删除相关本地化文件和配置，这些语言仍旧显示在应用设置中。本文将深入探讨此问题的原因，并提供一系列解决方案。

String Catalog的本地化信息缓存在多个地方，包括设备本身、构建产物以及Xcode缓存。因此，仅删除项目中的本地化文件并不足以彻底移除语言。此外，旧版本的应用安装包残留也可能导致问题。

以下是一些行之有效的解决方案，用于解决Swift String Catalog无法移除语言的问题。

Xcode构建过程中会生成中间文件和缓存，这些文件可能包含旧的本地化信息。清理构建文件夹可以确保下一次构建使用最新的配置。

操作步骤:
1. 关闭Xcode。
2. 前往项目所在目录。
3. 找到DerivedData文件夹并将其删除，或清空其内容。
4. 也可以通过快捷键 Shift+Command+Option+K 清理构建文件夹。
5. 重新打开Xcode并重新构建项目。

卸载应用并重新安装可以清除设备上旧的本地化缓存。

Info.plist 文件中的 CFBundleLocalizations 键定义了应用支持的语言。确保此键值列表中仅包含所需的语言。

操作步骤:
1. 在Xcode中打开 Info.plist 文件。
2. 找到 Localization native development region 键值，并修改成需要的语言，比如 en 。
3. 找到 Localizations 键（也可能显示为 CFBundleLocalizations）。
4. 移除不需要的语言代码。
```
<key>CFBundleLocalizations</key>
<array>
    <string>en</string>
    <string>fr</string>
</array>
```
5. 保存 Info.plist 文件并重新构建应用。

String Catalog 的核心是 .xcstrings 文件。通过直接编辑此文件，可以移除不需要的语言。

操作步骤:
1. 在Xcode中，右键点击 .xcstrings 文件，选择 "Open As" -> "Source Code"。
2. 在文本编辑器中打开 .xcstrings 文件。
3. 找到不需要的语言对应的 <string> 标签并删除。
```
/* Class = "UIButton"; normalTitle = "Hello"; ObjectID = "abc-123-def"; */
"abc-123-def.normalTitle" = "Hello";

/* Class = "UIButton"; normalTitle = "Bonjour"; ObjectID = "abc-123-def"; */
"abc-123-def.normalTitle" = "Bonjour";
```
上述代码片段中包含了英语和法语的键值对，如果想删除法文，可以直接删除下面带有 "Bonjour" 字样的行。
4. 保存 .xcstrings 文件并重新构建应用。

有时，项目文件 .xcodeproj 中可能残留了本地化信息。

操作步骤:
1. 关闭 Xcode。
2. 右键点击 .xcodeproj 文件，选择 "Show Package Contents"。
3. 在文本编辑器中打开 project.pbxproj 文件。
4. 搜索包含已移除语言代码的字段，例如 developmentRegion 或 knownRegions ，将其删除。
5. 保存 project.pbxproj 文件，重新打开Xcode并构建应用。
注意，手动编辑 project.pbxproj 文件存在风险，务必备份项目文件。