Expo模块自动链接中glob排序问题解析

背景介绍

在Expo生态系统中，expo-modules-autolinking是一个关键组件，负责自动发现和链接React Native模块。最近从fast-glob切换到glob包的决定，虽然看似简单，却引发了一个值得注意的兼容性问题。

问题本质

问题的核心在于两个glob实现返回文件顺序的差异：

• fast-glob返回文件时按字母升序排列
• glob返回文件时按文件系统顺序（通常是无序的）

这种差异在大多数情况下不会造成问题，但当第三方模块包含多个.podspec文件时，会导致自动链接器选择不同的文件。

技术细节分析

在iOS模块解析过程中，expo-modules-autolinking会查找模块目录下的所有.podspec文件，然后简单地取数组中的第一个元素。当glob实现改变后，"第一个"文件的定义也随之改变。

以Notifee模块为例：

• 包含两个podspec文件：RNNotifee.podspec和RNNotifeeCore.podspec
• 在SDK 52中使用fast-glob时，会选择RNNotifee.podspec
• 在SDK 53中使用glob时，可能选择RNNotifeeCore.podspec

影响范围

这个问题会影响所有满足以下条件的第三方模块：

1. 包含多个.podspec文件
2. 这些文件有不同的功能或配置
3. 模块功能依赖于特定的podspec文件被选中

解决方案

临时解决方案

对于受影响的模块，可以手动指定podspec路径，绕过自动发现机制。

长期解决方案

Expo团队可以考虑以下改进方向：

1. 对glob结果进行显式排序，确保一致的顺序
2. 实现更智能的podspec选择逻辑，而不仅仅是取第一个
3. 提供配置选项让开发者指定优先选择的podspec

最佳实践建议

对于模块开发者：

• 尽量避免发布包含多个podspec的模块
• 如果必须包含多个，确保它们功能完全一致
• 考虑使用条件逻辑而不是多个文件

对于应用开发者：

• 升级前检查依赖模块是否受此问题影响
• 在CI中增加podspec选择的验证
• 关注Expo官方文档中的兼容性说明

总结

这个案例展示了看似无害的依赖项变更如何引发意想不到的兼容性问题。它强调了在大型生态系统中，即使是微小的实现细节也可能产生广泛影响。对于Expo用户来说，理解这些底层机制有助于更好地诊断和解决类似问题。