React Native IAP 在 iOS 中调用 getAvailablePurchases() 的注意事项

在使用 React Native IAP 库进行应用内功能开发时，iOS 平台上调用 getAvailablePurchases() 方法可能会遇到一个常见问题：该方法会多次触发 purchaseUpdatedListener 接收器。本文将深入分析这个问题产生的原因，并提供有效的解决方案。

问题现象分析

当开发者在 iOS 平台上调用 getAvailablePurchases() 方法查询可用项目时，即使没有新的行为发生，purchaseUpdatedListener 接收器也会被多次触发。这会导致应用逻辑混乱，特别是当接收器中包含业务逻辑处理时，可能会引发意外的副作用。

问题根源

这个问题的根本原因在于 iOS 原生 StoreKit 框架的工作机制。在传统的 StoreKit 1 模式下，查询可用记录的操作会触发系统重新验证所有交易记录，从而导致接收器被多次调用。

解决方案

React Native IAP 库提供了两种 StoreKit 模式选择：

1. 使用 StoreKit 2 模式
   这是目前推荐的解决方案。通过以下代码初始化时指定使用 StoreKit 2 模式：

   import {setup} from 'react-native-iap';
   
   setup({storekitMode: 'STOREKIT2_MODE'});
   

   StoreKit 2 是苹果推出的新一代应用内框架，相比 StoreKit 1 有更好的性能和更简洁的API设计。使用此模式可以避免查询操作多次触发接收器的问题。

2. 优化接收器实现
   如果必须使用 StoreKit 1 模式，可以通过以下方式优化代码：

   • 确保 purchaseUpdatedListener 只在应用启动时初始化一次
   • 在接收器内部添加适当的条件判断，避免重复处理相同交易
   • 使用状态管理来跟踪已处理的交易

订阅商品的特殊处理

在实现订阅功能时，开发者还需要注意一个细节：订阅商品的交易完成处理。根据 React Native IAP 的实现，订阅交易完成后返回的对象中可能会包含 isConsumable: true 的标记。这是预期的行为，因为从技术实现角度看，订阅交易的处理方式与消耗型商品类似。

最佳实践建议

1. 接收器放置位置
   建议在应用启动时（如 App.js 或根组件）初始化 purchaseUpdatedListener，而不是在每个需要查询的页面都设置接收器。

2. 避免频繁查询
   尽量减少调用 getAvailablePurchases() 的频率，可以在应用启动时查询一次并缓存结果。

3. 错误处理
   始终为操作添加错误处理逻辑，特别是在接收器中处理交易时。

4. 测试验证
   在沙盒环境中充分测试各种场景，确保接收器按预期工作。

通过以上措施，开发者可以避免 React Native IAP 在 iOS 平台上的接收器多次触发问题，构建稳定可靠的应用内功能。