KeyboardKit 9.1 版本中的本地化展示优化

在键盘应用开发中，本地化处理是一个非常重要的环节。KeyboardKit 作为一个专业的键盘开发框架，在最新发布的 9.1 版本中对本地化展示功能进行了重要优化，特别是针对键盘语言环境的展示方式做出了改进。

背景与问题

在之前的版本中，KeyboardKit 使用 keyboardPresentationLocale 属性来定义如何展示不同的语言环境（locale）。这个属性的默认值是 .current，意味着所有语言环境都会按照当前设备的语言设置来展示名称。例如，在中文设备上，英语会显示为"英语"，法语会显示为"法语"。

然而，这种设计存在一个明显的局限性：开发者无法选择按照语言本身的名称来展示语言环境。比如，英语开发者可能希望在列表中看到"English"而不是"英语"，法语开发者可能希望看到"français"而不是"法语"。

解决方案

KeyboardKit 9.1 版本通过将 keyboardPresentationLocale 属性改为可选类型解决了这个问题。现在，这个属性可以设置为 nil，当它为 nil 时，系统会采用新的展示逻辑：

1. 对于 Locale.ContextMenu 这样的组件，当 keyboardPresentationLocale 为 nil 时，每个语言环境会使用自身的本地化名称来展示
2. 英语会显示为"English"
3. 瑞典语会显示为"svenska"
4. 法语会显示为"français"

这种改变为开发者提供了更大的灵活性，可以根据应用场景选择最合适的展示方式。

实现细节

在技术实现上，这个改动涉及以下关键点：

1. 属性类型变更：将 keyboardPresentationLocale 从非可选类型改为可选类型（Locale?）
2. 默认行为调整：属性默认值从 .current 改为 nil
3. 组件适配：所有使用此属性的组件都需要处理 nil 的情况
4. 回退机制：当属性为 nil 时，组件需要实现合理的回退逻辑

开发者指南

对于开发者来说，现在可以更灵活地控制语言环境的展示方式：

// 使用设备当前语言展示所有语言环境（旧版行为）
contextMenu.keyboardPresentationLocale = .current

// 使用特定语言展示所有语言环境
contextMenu.keyboardPresentationLocale = Locale(identifier: "fr")

// 让每个语言环境使用自己的本地化名称展示（新版功能）
contextMenu.keyboardPresentationLocale = nil

总结

KeyboardKit 9.1 版本的这一改进使得键盘应用的语言环境展示更加灵活和国际化。开发者现在可以根据应用需求选择最合适的展示方式，无论是统一使用设备语言展示，还是保留每种语言的原生名称展示。这一变化特别适合多语言键盘应用，能够提供更加原生的用户体验。

对于正在使用或考虑使用 KeyboardKit 的开发者来说，了解并合理利用这一新特性，可以显著提升键盘应用的国际化水平和用户体验。