Expo-IAP 迁移指南：从 react-native-iap 平滑过渡

前言

在 React Native 生态系统中，应用内购买(IAP)功能是许多商业化应用的核心需求。本文将详细介绍如何从 react-native-iap 迁移到更现代的 expo-iap 解决方案。expo-iap 作为新一代的 IAP 库，提供了更简洁的 API 设计、更好的 TypeScript 支持以及更完善的错误处理机制。

迁移前的准备工作

在开始迁移前，建议开发者：

1. 备份当前项目代码
2. 确保测试环境配置完整
3. 记录当前 react-native-iap 的版本号
4. 准备测试用的商品 ID 和订阅 ID

核心差异概述

1. 包管理变化

# 旧方案
npm install react-native-iap

# 新方案
npm install expo-iap

2. 上下文管理简化

expo-iap 移除了必须的上下文包装器(Context Wrapper)，使集成更加简单：

// 旧方案需要包装整个应用
const AppWithIAP = withIAPContext(App);

// 新方案直接使用hook即可
const { connected } = useIAP();

3. 错误处理增强

expo-iap 引入了专门的错误类型 IAPError，提供更结构化的错误信息：

try {
  await requestPurchase({sku: 'product_id'});
} catch (error) {
  if (error instanceof IAPError) {
    console.error(`平台: ${error.platform}, 错误码: ${error.code}`);
  }
}

详细迁移步骤

第一步：依赖更新

1. 移除旧包并安装新包：

npm uninstall react-native-iap
npm install expo-iap

2. 对于iOS项目，更新Pod依赖：

cd ios && pod install && cd ..

第二步：导入语句更新

将所有 react-native-iap 的导入替换为 expo-iap：

// 替换前
import { useIAP, withIAPContext } from 'react-native-iap';

// 替换后
import { useIAP } from 'expo-iap';

第三步：移除上下文包装器

查找并移除应用中所有的 withIAPContext 包装：

// 替换前
export default withIAPContext(App);

// 替换后
export default App;

第四步：更新Hook使用

虽然 useIAP hook 的基本功能相同，但 expo-iap 提供了更好的类型支持和额外方法：

const {
  connected,          // 连接状态
  products,          // 商品列表
  getProducts,       // 获取商品方法
  currentPurchase,   // 当前购买项
  // ...其他属性
} = useIAP();

第五步：增强错误处理

利用新的错误类型改进错误处理逻辑：

useEffect(() => {
  if (currentPurchaseError) {
    if (currentPurchaseError.code === 'E_USER_CANCELLED') {
      alert('您已取消购买');
    } else {
      alert(`购买失败: ${currentPurchaseError.message}`);
    }
  }
}, [currentPurchaseError]);

API 变化详解

主要方法对比

功能	react-native-iap	expo-iap
初始化连接	initConnection	自动管理
获取商品	getProducts	相同API
发起购买	requestPurchase	相同API
完成交易	finishTransaction	相同API

新增实用方法

expo-iap 增加了平台专属的收据验证方法：

// iOS收据验证
const iosValid = await validateReceiptIos({
  receiptBody: receipt,
  password: '共享密钥'
});

// Android收据验证
const androidValid = await validateReceiptAndroid({
  packageName: '应用包名',
  productToken: '购买令牌'
});

迁移测试策略

基础功能测试

async function testBasicFlow() {
  try {
    const products = await getProducts({skus: ['test_product']});
    if (products.length > 0) {
      await requestPurchase({sku: 'test_product'});
    }
  } catch (error) {
    console.error('测试失败:', error);
  }
}

错误场景测试

1. 测试无效商品ID
2. 测试网络断开情况
3. 测试用户取消购买流程
4. 测试重复购买场景

常见问题解决

类型不匹配问题

如果遇到TypeScript类型错误，更新类型导入：

// 替换前
import { Product } from 'react-native-iap';

// 替换后
import { Product } from 'expo-iap';

购买事件处理

如果之前使用独立事件处理器，建议迁移到hook方式：

// 旧方案
const subscription = purchaseUpdatedListener(handlePurchase);

// 新方案
const { currentPurchase } = useIAP();
useEffect(() => {
  if (currentPurchase) handlePurchase(currentPurchase);
}, [currentPurchase]);

性能优化建议

迁移后可以实施的优化：

1. 商品缓存：合理利用 hook 自带的缓存机制
2. 按需加载：只在需要时获取商品信息
3. 错误边界：为关键购买流程添加错误边界处理
4. 日志记录：完善购买流程的日志记录

迁移后检查清单

1. [ ] 所有导入语句已更新
2. [ ] 上下文包装器已移除
3. [ ] 错误处理逻辑已增强
4. [ ] 测试用例全部通过
5. [ ] 生产环境验证完成

总结

从 react-native-iap 迁移到 expo-iap 是一个值得投入的过程。新库提供了更简洁的API设计、更好的开发体验和更可靠的错误处理机制。按照本文的步骤进行迁移，可以确保平稳过渡，同时为应用带来更好的内购体验。

对于复杂场景或特殊需求，建议详细阅读 expo-iap 的官方文档，充分利用其提供的各种高级功能。迁移完成后，您将拥有一个更稳定、更易维护的应用内购买实现方案。