Expo-IAP 应用内购买生命周期管理完全指南

2025-07-02 11:49:29作者：管翌锬

前言

在移动应用开发中，应用内购买(IAP)是变现的重要方式之一。expo-iap 作为 React Native 生态中优秀的 IAP 解决方案，其生命周期管理是开发者必须掌握的核心概念。本文将深入剖析 expo-iap 的生命周期管理机制，帮助开发者构建健壮的 IAP 功能。

生命周期全景图

expo-iap 的完整生命周期包含以下关键阶段：

初始化阶段：建立与应用商店的连接
产品获取阶段：从商店获取可购买商品信息
购买请求阶段：用户发起购买行为
购买处理阶段：商店处理支付流程
购买更新阶段：应用接收购买状态通知
验证阶段：服务端验证购买凭证（强烈推荐）
交易完成阶段：确认交易完成购买流程
连接管理阶段：应用退出时的资源清理

连接管理机制

自动连接管理（推荐）

useIAP Hook 提供了开箱即用的连接管理能力：

import { useIAP } from 'expo-iap';

function PurchaseScreen() {
  const { connected, products, getProducts } = useIAP();

  useEffect(() => {
    if (connected) {
      // 安全地调用商店方法
      getProducts({ skus: ['premium_monthly', 'coins_100'] });
    }
  }, [connected]);

  return <ProductList products={products} />;
}

自动连接管理包含以下特性：

自动初始化商店连接
自动设置状态观察器
自动管理连接状态
组件卸载时自动清理资源

连接状态类型

开发者需要处理的几种连接状态：

状态	描述	处理建议
未连接	初始状态	显示加载界面
连接中	正在建立连接	显示加载提示
已连接	可进行购买操作	展示商品界面
错误	连接失败	显示错误信息

手动连接管理（高级）

对于需要精细控制的场景，可以使用底层 API：

import { initConnection, endConnection } from 'expo-iap';

class IAPService {
  private observers: Subscription[] = [];
  
  async initialize() {
    try {
      await initConnection();
      this.setupObservers();
    } catch (error) {
      console.error('商店连接初始化失败', error);
    }
  }
  
  private setupObservers() {
    this.observers = [
      purchaseUpdatedObserver(this.handlePurchaseUpdate),
      purchaseErrorObserver(this.handlePurchaseError)
    ];
  }
  
  async cleanup() {
    this.observers.forEach(sub => sub.remove());
    await endConnection();
  }
}

组件生命周期集成

类组件集成方案

class PurchaseComponent extends React.Component {
  private updateObserver: Subscription | null = null;
  
  async componentDidMount() {
    await initConnection();
    this.updateObserver = purchaseUpdatedObserver(this.handlePurchase);
  }
  
  componentWillUnmount() {
    this.updateObserver?.remove();
    endConnection();
  }
  
  handlePurchase = (purchase) => {
    // 处理购买结果
  };
}

函数组件集成方案

function PurchaseComponent() {
  const observers = useRef<Subscription[]>([]);
  
  useEffect(() => {
    const setup = async () => {
      await initConnection();
      observers.current = [
        purchaseUpdatedObserver(handlePurchase)
      ];
    };
    
    setup();
    
    return () => {
      observers.current.forEach(sub => sub.remove());
      endConnection();
    };
  }, []);
}

最佳实践指南

交易处理黄金法则

服务端验证优先：永远不要仅依赖客户端验证结果
及时完成交易：验证通过后必须调用 finishTransaction
处理所有状态：包括待处理、失败、取消等各种状态

// 正确的交易处理流程
const handlePurchase = async (purchase) => {
  try {
    // 1. 服务端验证
    const isValid = await serverValidate(purchase.receipt);
    
    if (isValid) {
      // 2. 发放商品/服务
      await grantPremiumAccess();
      
      // 3. 完成交易
      await finishTransaction({
        purchase,
        isConsumable: true
      });
    }
  } catch (error) {
    // 4. 错误处理
    showErrorToast(error.message);
  }
};

常见错误及解决方案

问题1：重复初始化连接

// 错误示范：每次操作都初始化
async function buyProduct() {
  await initConnection();  // ❌ 不应该在这里初始化
  await requestPurchase(productId);
  await endConnection();  // ❌ 不应该在这里结束
}

解决方案：保持单一持久连接

// 正确做法：使用现有连接
async function buyProduct() {
  if (!connected) return;
  await requestPurchase(productId);  // ✅ 使用已建立的连接
}

问题2：忽略待处理交易

// 错误示范：未检查待处理交易
function App() {
  useEffect(() => {
    initConnection();
  }, []);
  // ❌ 可能遗漏已完成但未处理的交易
}

解决方案：启动时检查待处理交易

// 正确做法：检查历史交易
useEffect(() => {
  const checkPurchases = async () => {
    await initConnection();
    const purchases = await getAvailablePurchases();
    purchases.forEach(processPurchase);  // ✅ 处理所有待处理交易
  };
  checkPurchases();
}, []);