企业官网建设流程全解析

Notchi本地化教程：如何添加新语言支持与区域适配

【免费下载链接】notchinotch app for claude code & codex项目地址: https://gitcode.com/gh_mirrors/no/notchi

Notchi是一款为Claude Code和Codex打造的Notch应用，通过本教程，你将学习如何为Notchi添加新的语言支持，实现应用的区域适配，让全球用户都能获得更好的使用体验。

本地化准备工作

在开始本地化之前，首先需要准备好开发环境和相关文件。Notchi的本地化主要通过Localizable.xcstrings文件实现，该文件位于项目的notchi/notchi/目录下。你可以通过以下命令克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/no/notchi

克隆完成后，找到Localizable.xcstrings文件，该文件是Notchi本地化的核心，包含了应用中所有需要翻译的字符串。

了解Localizable.xcstrings文件结构

Localizable.xcstrings采用JSON格式存储多语言字符串，文件结构清晰，主要包含以下几个部分：

• sourceLanguage：源语言，默认为英语（en）
• strings：包含所有需要翻译的字符串键值对
• 每个字符串条目包含comment（注释）和localizations（各语言翻译）

例如，以下是一个字符串条目的示例：

"%@ API returned HTTP %lld" : { "localizations" : { "en" : { "stringUnit" : { "state" : "new", "value" : "%1$@ API returned HTTP %2$lld" } }, "zh-Hans" : { "stringUnit" : { "state" : "needs_review", "value" : "%@ API 返回了 HTTP %lld" } } } }

添加新语言的步骤

步骤1：确定语言代码

首先，确定你要添加的语言对应的语言代码。例如：

• 法语：fr
• 德语：de
• 西班牙语：es
• 俄语：ru

完整的语言代码列表可以参考Apple的语言和地区代码文档。

步骤2：在Localizable.xcstrings中添加语言条目

打开Localizable.xcstrings文件，为每个字符串条目添加新语言的翻译。例如，为"API Key"添加法语翻译：

"API Key" : { "localizations" : { "en" : { "stringUnit" : { "state" : "needs_review", "value" : "API Key" } }, "fr" : { "stringUnit" : { "state" : "new", "value" : "Clé API" } } } }

步骤3：设置翻译状态

每个翻译条目都有一个state属性，表示翻译的状态：

• "new"：新添加的翻译，需要审核
• "translated"：已翻译，但未审核
• "needs_review"：需要审核
• "reviewed"：已审核

建议在完成翻译后，将状态设置为"needs_review"，以便后续审核。

步骤4：验证本地化内容

添加完成后，需要验证本地化内容是否正确。你可以通过Xcode的本地化预览功能，或者直接在应用中切换语言进行测试。

区域适配注意事项

日期和时间格式

不同地区有不同的日期和时间格式，Notchi使用系统默认的日期时间格式，但你也可以在Localizable.xcstrings中为特定区域自定义格式。例如：

"30d" : { "localizations" : { "en" : { "stringUnit" : { "state" : "new", "value" : "30d" } }, "fr" : { "stringUnit" : { "state" : "new", "value" : "30j" } } } }

货币格式

Notchi中涉及到货币的显示，如"%@ limit"、"%@ remaining"等字符串，需要根据不同地区的货币格式进行调整。例如：

"%@ limit" : { "localizations" : { "en" : { "stringUnit" : { "state" : "new", "value" : "%@ limit" } }, "de" : { "stringUnit" : { "state" : "new", "value" : "%@ Limit" } } } }

布局调整

某些语言的文本长度可能比源语言长，可能会导致界面布局问题。如果遇到这种情况，你可能需要调整相关的布局文件，这些文件位于notchi/notchi/Views/目录下，例如SettingsLayout.swift。

测试与提交

本地测试

在完成本地化后，建议在不同的设备和系统版本上进行测试，确保所有文本都能正确显示，并且界面布局没有问题。

提交贡献

如果你希望将你的本地化贡献给Notchi项目，可以按照以下步骤操作：

1. Fork项目仓库
2. 创建一个新的分支，命名格式为localization-<language-code>
3. 提交你的修改
4. 创建Pull Request，描述你添加的语言和主要修改内容

总结

通过本教程，你已经了解了如何为Notchi添加新的语言支持和进行区域适配。本地化是一个持续的过程，随着应用的更新，可能会有新的字符串需要翻译。希望你能通过自己的贡献，让Notchi惠及更多地区的用户！

如果你在本地化过程中遇到任何问题，可以参考项目的CONTRIBUTING.md文档，或者在项目的Issues中提问。

【免费下载链接】notchinotch app for claude code & codex项目地址: https://gitcode.com/gh_mirrors/no/notchi