React Native App Auth 在 iOS 新架构下的布尔参数传递问题解析

问题背景

在 React Native 生态系统中，App Auth 是一个广泛使用的 OAuth2 和 OpenID Connect 客户端实现库。随着 React Native 0.74 版本的发布，新架构（New Architecture）和桥接模式（bridgelessMode）的引入带来了一些兼容性问题。

核心问题表现

当开发者在 iOS 17.4 环境下，使用 React Native 0.74.1 的新架构并启用桥接模式时，调用 authorize、refresh 和 logout 方法会遇到 Promise 拒绝错误。具体错误信息表明，JavaScript 向 Objective-C 传递 BOOL 类型参数时出现了转换问题。

技术原因分析

这个问题的根源在于 Turbo Modules 在新架构下的类型处理机制发生了变化。在传统的桥接模式下，JavaScript 和原生代码之间的类型转换有一套成熟的机制，但在桥接模式关闭（bridgelessMode ON）的情况下，Turbo Modules 对某些类型的处理方式有所不同。

具体到这个问题，RNAppAuth 模块中定义的方法参数使用了 BOOL* 指针类型，这在桥接模式下会导致类型转换失败。正确的做法应该是直接使用 BOOL 值类型而非指针类型。

解决方案

社区开发者通过 patch-package 提供了一个临时解决方案，主要修改了 RNAppAuth.m 文件中的方法签名，将 BOOL* 指针类型改为 BOOL 值类型。这些修改涉及以下几个关键方法：

1. authorize 方法中的 useNonce、usePKCE 和 prefersEphemeralSession 参数
2. refresh 方法中的 prefersEphemeralSession 参数
3. endSessionWithConfiguration 方法中的 prefersEphemeralSession 参数
4. getExternalUserAgentWithPresentingViewController 方法中的 prefersEphemeralSession 参数

官方修复

项目维护团队在 v8.0.0 版本中正式修复了这个问题。这个版本全面适配了 React Native 的新架构，特别是针对桥接模式下的类型转换问题进行了优化。

开发者建议

对于正在使用 React Native App Auth 的开发者，建议：

1. 如果遇到类似问题，首先检查是否启用了新架构和桥接模式
2. 考虑升级到最新版本的 react-native-app-auth
3. 在升级前，充分测试认证流程的各项功能
4. 关注 React Native 新架构的演进，了解其对现有模块的影响

总结

这个问题展示了 React Native 生态系统中新架构过渡期可能遇到的典型兼容性问题。通过理解底层机制和及时跟进官方更新，开发者可以有效地解决这类问题，确保应用功能的稳定性。