深入解析hyochan/expo-iap项目中的完整应用内购买商店实现

前言

在移动应用开发中，应用内购买(IAP)是变现的重要方式之一。hyochan/expo-iap项目为React Native开发者提供了跨平台的IAP解决方案。本文将深入解析该项目中完整应用内购买商店的实现方式，帮助开发者理解核心概念和最佳实践。

核心概念

1. 产品类型

应用内购买主要分为两种类型：

• 消耗型产品：如游戏中的金币、道具等，可多次购买
• 订阅型产品：如会员服务，通常有周期性收费

2. 平台差异

iOS和Android平台的IAP实现存在显著差异：

• 购买API调用方式不同
• 收据验证机制不同
• 产品信息结构不同

实现步骤详解

1. 初始化IAP连接

const {
  connected,
  products,
  subscriptions,
  currentPurchase,
  currentPurchaseError,
  getProducts,
  getSubscriptions,
  requestPurchase,
  finishTransaction,
  validateReceipt,
} = useIAP();

这段代码初始化了IAP连接，获取了所有必要的功能方法。

2. 获取产品列表

useEffect(() => {
  if (!connected) return;

  const initializeStore = async () => {
    try {
      await getProducts(productSkus);
      await getSubscriptions(subscriptionSkus);
    } catch (error) {
      console.error('Failed to initialize store:', error);
    }
  };

  initializeStore();
}, [connected]);

在连接建立后，立即获取产品列表和订阅列表。

3. 处理购买请求

const handlePurchase = async (productId) => {
  try {
    if (Platform.OS === 'ios') {
      await requestPurchase({
        request: {
          sku: productId,
          andDangerouslyFinishTransactionAutomaticallyIOS: false,
        },
      });
    } else {
      await requestPurchase({
        request: {skus: [productId]},
      });
    }
  } catch (error) {
    console.error('Purchase failed:', error);
  }
};

注意iOS和Android平台API调用的差异。

4. 完成交易流程

useEffect(() => {
  if (currentPurchase) {
    const completePurchase = async () => {
      try {
        const isValid = await validateReceipt(currentPurchase.id);
        
        if (isValid) {
          await finishTransaction({
            purchase: currentPurchase,
            isConsumable: true,
          });
          
          console.log('Purchase completed successfully!');
        }
      } catch (error) {
        console.error('Failed to complete purchase:', error);
      }
    };

    completePurchase();
  }
}, [currentPurchase]);

收据验证是确保交易安全的关键步骤。

高级实现细节

1. 收据验证

const validatePurchaseReceipt = useCallback(
  async (productId, purchase, validateReceiptFn) => {
    try {
      if (Platform.OS === 'ios') {
        const validationResult = await validateReceiptFn(productId);
        return validationResult.isValid;
      } else if (Platform.OS === 'android') {
        const purchaseToken = purchase.purchaseTokenAndroid;
        const packageName = purchase.packageNameAndroid || 'your.package.name';
        const isSub = subscriptionSkus.includes(productId);

        if (!purchaseToken) {
          console.error('Purchase token is missing for Android purchase');
          return false;
        }

        const validationResult = await validateReceiptFn(productId, {
          packageName,
          productToken: purchaseToken,
          isSub,
        });

        return validationResult.isValid;
      }
      return true;
    } catch (validationError) {
      console.error('Error during receipt validation:', validationError);
      return true;
    }
  },
  [],
);

2. 数据库记录

const recordPurchaseInDatabase = useCallback(
  async (purchase, productId, productsList, subscriptionsList) => {
    try {
      const transactionId = Platform.OS === 'ios'
        ? purchase.transactionId || ''
        : purchase.purchaseTokenAndroid || '';

      // 提取价格和货币信息
      let price = 0;
      let currency = 'USD';
      const product = productsList.find(p => p.id === productId) ||
                    subscriptionsList.find(s => s.id === productId);

      if (product) {
        // 处理iOS和Android不同的价格结构
        // ...
      }

      // 保存到数据库
      await savePurchaseToDatabase({
        productId,
        amount: price,
        currency,
        paymentMethod: Platform.OS,
        transactionId,
        metadata: purchase,
      });
    } catch (dbError) {
      console.error('Error recording purchase in database:', dbError);
    }
  },
  [],
);

3. 订阅状态管理

const updatePremiumStatus = useCallback(async () => {
  try {
    await checkPremiumStatus();

    if (!subscriptionAlertShown.current) {
      subscriptionAlertShown.current = true;
      InteractionManager.runAfterInteractions(() => {
        Alert.alert(
          'Thank You!',
          'Your premium subscription has been activated.',
        );
      });
    }
  } catch (error) {
    console.error('Error updating premium status:', error);
  }
}, []);

最佳实践

1. 始终验证收据：防止欺诈交易
2. 正确处理平台差异：iOS和Android需要不同的处理方式
3. 完善的错误处理：特别是用户取消购买的情况
4. 清晰的用户反馈：购买成功或失败时提供明确提示
5. 数据库记录：保存交易记录用于对账和分析

常见问题解决方案

1. 连接失败：检查网络连接和IAP配置
2. 产品加载失败：确认产品ID是否正确配置
3. 收据验证失败：检查服务器端验证逻辑
4. 交易未完成：确保调用了finishTransaction

总结

hyochan/expo-iap项目提供了完整的应用内购买解决方案，通过本文的解析，开发者可以理解其核心实现逻辑和最佳实践。关键点包括正确处理平台差异、完善的收据验证机制、清晰的用户反馈流程等。这些知识将帮助开发者在自己的应用中实现安全可靠的应用内购买功能。