React Native Localization Settings 项目中的 iOS 本地化警告问题解析

React Native Localization Settings 项目中的 iOS 本地化警告问题解析

在 React Native 开发中，使用 react-native-localization-settings 插件进行多语言支持时，开发者可能会遇到一个特殊的 iOS 构建警告。本文将深入分析这个问题的成因、影响以及解决方案。

问题现象

当开发者在 Expo 项目中使用 react-native-localization-settings 插件配置多语言支持后，向 App Store 提交应用时会收到如下警告信息：

ITMS-90176: Unrecognized Locale - The locale names used in localization directories at [Payload/AppName.app/base.lproj] are invalid. iTunes supports BCP47 but not the UN M.49 specification.

这个警告指出 iOS 应用构建过程中生成的本地化目录使用了不被 iTunes 支持的格式。具体表现为在应用的 .app 包内存在一个 base.lproj 目录，而苹果推荐使用 BCP47 标准的语言标识符。

问题根源

经过分析，这个问题主要由以下两个因素导致：

1. Base 语言目录问题：插件默认会创建一个 "Base" 语言目录，这不符合苹果推荐的 BCP47 标准语言标识规范。

2. Xcode 项目配置：插件在 Xcode 项目的 knownRegions 配置中自动添加了 'Base' 区域，而实际上应该只包含开发者指定的语言代码。

技术背景

在 iOS 开发中，本地化资源通常存储在 .lproj 目录中，目录名应为标准的语言代码（如 en.lproj、fr.lproj）。苹果推荐使用 BCP47 标准（如 en-US、zh-Hans）来命名这些目录。

"Base" 是一个特殊标识，传统上用于存放默认资源，但在现代 Xcode 项目中，苹果更推荐使用开发者指定的主要语言作为默认资源，而不是使用 "Base"。

解决方案

社区贡献者提出了有效的修复方案，主要修改包括：

1. 将 sourceLanguage 从硬编码的 "Base" 改为使用开发者指定的第一个语言
2. 从 knownRegions 数组中移除 'Base'，只保留开发者配置的语言
3. 从 Localizable.xcstrings 文件中移除 base 本地化条目

这些修改确保了项目完全符合苹果的最新本地化规范，同时保持了插件的核心功能。

最佳实践建议

对于使用 react-native-localization-settings 插件的开发者，建议：

1. 确保语言代码使用标准的 BCP47 格式（如 en-US 而非简单的 en）
2. 将主要语言放在配置数组的第一位，因为它将被用作 sourceLanguage
3. 定期更新插件版本以获取最新的兼容性修复

总结

本地化是移动应用开发中的重要环节，遵循平台规范可以避免许多潜在问题。react-native-localization-settings 插件的这一修复展示了开源社区如何快速响应和解决兼容性问题。开发者应当关注这类警告信息，即使它们不影响构建结果，也能帮助提升应用的标准化程度和未来兼容性。