使用expo-iap实现iOS应用内购买配置指南

前言

在移动应用开发中，应用内购买(IAP)是重要的盈利模式之一。本文将详细介绍如何在React Native项目中使用expo-iap库配置iOS应用内购买功能。expo-iap是一个优秀的跨平台应用内购买解决方案，支持iOS和Android平台，简化了IAP的实现流程。

第一部分：App Store Connect配置

1. 创建应用记录

在开始编码前，我们需要在苹果开发者后台完成基础配置：

1. 登录App Store Connect
2. 进入"我的应用"部分
3. 创建新应用或选择现有应用
4. 填写完整的应用信息，包括名称、描述、分类等

2. 创建内购产品

内购产品类型选择至关重要，开发者应根据业务需求选择合适类型：

• 消耗型产品：如游戏币、额外生命值等可重复购买的内容
• 非消耗型产品：如解锁高级功能等一次性购买
• 自动续期订阅：如月度会员等定期自动续费服务
• 非续期订阅：如限时会员等需要用户手动续费的订阅

3. 产品详细配置

每个内购产品需要配置以下关键信息：

• 产品ID：采用反向域名格式(如com.yourapp.premium)，确保唯一性
• 参考名称：仅团队内部可见的管理名称
• 定价：选择合适的价格等级或设置自定义价格
• 显示名称：用户可见的产品名称(最多30个字符)
• 描述：清晰说明产品内容(最多45个字符)

4. 提交审核注意事项

首次提交内购产品时需注意：

• 准备1024×1024像素的产品截图
• 确保描述准确反映产品内容
• 审核通常需要1-3个工作日

第二部分：Xcode项目配置

1. 启用内购能力

在Xcode中完成以下步骤：

1. 打开项目工程文件
2. 选择主应用Target
3. 进入"Signing & Capabilities"标签页
4. 点击"+"添加"In-App Purchase"能力

2. 包标识符一致性检查

确保Xcode中的Bundle ID与App Store Connect完全匹配：

1. 检查General标签下的Bundle Identifier
2. 区分开发(Development)和生产(Production)环境配置

3. 代码签名配置

正确的代码签名是内购功能正常工作的前提：

1. 选择正确的开发团队
2. 使用匹配的Provisioning Profile
3. 建议开启Automatically manage signing简化流程

第三部分：测试环境搭建

1. 创建沙盒测试账号

沙盒测试是验证内购功能的关键步骤：

1. 在App Store Connect的"用户和访问"中创建
2. 使用虚构但格式正确的邮箱地址
3. 密码需符合苹果安全要求
4. 测试账号与开发者账号必须分离

2. 设备测试配置

在测试设备上：

1. 完全退出App Store账号
2. 通过Xcode或TestFlight安装测试版本
3. 首次内购时使用沙盒账号登录
4. 注意沙盒环境购买不会产生实际扣款

第四部分：代码集成实现

基础集成示例

import { useIAP } from 'expo-iap';

function PurchaseScreen() {
  const { connected, products, getProducts, requestPurchase } = useIAP({
    onPurchaseSuccess: (purchase) => {
      console.log('购买成功:', purchase);
      // 处理购买成功逻辑
    },
    onPurchaseError: (error) => {
      console.error('购买失败:', error);
      // 处理错误情况
    },
  });

  useEffect(() => {
    if (connected) {
      getProducts(['com.yourapp.premium']);
    }
  }, [connected]);

  // 渲染产品列表...
}

收据验证实现

iOS平台特有的收据验证机制：

const validateReceipt = async (transactionId: string) => {
  try {
    const result = await validateReceipt(transactionId);
    if (result.isValid) {
      // 验证通过，发放商品
    } else {
      // 处理无效收据
    }
  } catch (error) {
    // 网络或验证服务错误处理
  }
};

错误处理最佳实践

针对不同错误代码提供差异化处理：

const handleError = (error) => {
  switch (error.code) {
    case ErrorCode.E_USER_CANCELLED:
      // 用户主动取消，不显示错误
      break;
    case ErrorCode.E_PAYMENT_NOT_ALLOWED:
      alert('当前设备不允许支付');
      break;
    // 其他错误处理...
  }
};

第五部分：常见问题排查

产品无法加载

可能原因：

• 产品ID拼写不一致
• 内购产品未完成审核
• Bundle ID不匹配

解决方案：

• 仔细核对产品ID大小写
• 确保产品状态为"准备提交"或"已批准"
• 检查开发和生产环境配置

沙盒测试失败

典型表现：

• "无法连接到iTunes Store"错误
• 无限加载状态

解决步骤：

1. 确认使用专用沙盒账号
2. 检查设备网络连接
3. 尝试重启设备
4. 在真机测试而非模拟器

第六部分：高级技巧与最佳实践

1. 服务端验证：生产环境务必实现服务端收据验证
2. 本地缓存：缓存购买状态应对应用重启
3. 恢复购买：为非消耗型产品实现恢复功能
4. UI/UX优化：
   • 购买过程中禁用交互
   • 提供明确的加载状态
   • 购买成功后给予视觉反馈

结语

通过本文的详细指导，开发者应能完整实现iOS应用内购买功能。expo-iap库大大简化了跨平台IAP的开发流程，但仍需注意平台差异和苹果的特殊要求。建议在实际开发中充分测试各种边界情况，确保支付流程的稳定性和用户体验的流畅性。