Zeego 3.0.1发布：全新架构支持与React Native 0.77适配

项目简介

Zeego是一个跨平台的UI组件库，它允许开发者在iOS、Android和Web平台上使用统一的API来创建美观的原生菜单。通过抽象底层平台差异，开发者可以专注于业务逻辑而无需为不同平台编写重复代码。

Zeego 3.0.1核心更新

最新发布的Zeego 3.0.1版本带来了多项重要改进，主要围绕新架构支持和最新React Native版本适配：

1. React Native 0.77全面支持：确保开发者可以使用最新的React Native特性
2. 新架构兼容性：同时支持React Native 0.76和0.77版本的新架构
3. Expo SDK 52适配：完善了对Expo生态系统的支持
4. 事件回调完善：onOpenChange事件现在在所有平台（包括Android）都能正常工作

技术实现细节

此次更新主要基于上游原生库（@react-native-menu和react-native-ios-context-menu）的改进。Zeego团队在此基础上进行了充分测试和配置调整，确保这些改进能够无缝集成到Zeego生态中。

特别值得注意的是，新版本修复了iOS平台上ContextMenu和DropdownMenu组件的onOpenChange事件触发问题，提升了组件的行为一致性。

升级指南

升级到Zeego 3.0.1需要遵循以下步骤：

1. 更新Zeego核心库：

   yarn add zeego
   # 或使用npm
   npm install zeego --legacy-peer-deps
   

2. 更新原生依赖：

   yarn add @react-native-menu@1.2.2 react-native-ios-context-menu@3.1.0 react-native-ios-utilities@5.1.2
   

   注意：依赖版本必须严格匹配，否则可能导致兼容性问题。

3. 重建原生应用：

   • 对于使用Expo的项目，需要在app.config.json中设置expo.newArchEnabled = true
   • 执行预构建命令：

     npx expo prebuild --clean
     npx expo run:ios # 或run:android
     

架构演进与未来规划

Zeego团队原本计划在v3版本中完全重写底层实现，直接使用SwiftUI和Jetpack Compose。但经过深入评估后，决定将这个重大变更推迟到v4版本，主要基于以下考虑：

1. 兼容性考量：SwiftUI实现需要Expo SDK 53+支持，而当前许多项目仍在使用较早版本
2. 功能完整性：某些高级功能（如ContextMenu.Auxiliary）在SwiftUI中实现存在挑战
3. 开发者生态：现有API已被广泛采用，贸然变更会影响现有项目

未来的v4版本可能会带来以下改进方向：

• 更彻底的平台原生实现
• 更优的组件组合能力
• 性能优化和更精简的API设计

升级建议

建议以下情况的开发者尽快升级：

• 正在使用React Native新架构的项目
• 使用React Native 0.77或需要解决原生依赖冲突的项目
• 需要完整onOpenChange事件支持的应用

对于仍在使用较旧版本且运行稳定的项目，可以评估升级的必要性和收益后再做决定。

Zeego 3.0.1的发布标志着这个优秀的跨平台菜单解决方案又向前迈进了一步，为开发者提供了更稳定、更强大的工具来构建高质量的用户界面。