React Native IAPHub 集成指南

1. 项目介绍

React Native IAPHub 是一个开源项目，旨在帮助开发者快速集成应用内购买（In-App Purchase，简称 IAP）功能。它支持各大平台的内购服务，包括 iOS 的 App Store 和 Android 的 Google Play。通过简单的 API 调用，开发者可以轻松实现内购产品的展示、购买和验证等功能。

2. 项目快速启动

环境准备

• React Native 0.60 或更高版本
• Android Studio 或 Xcode（对应平台开发环境）

安装步骤

首先，在你的 React Native 项目中安装 react-native-iaphub：

yarn add react-native-iaphub

或者使用 npm：

npm install react-native-iaphub

接着，根据你的开发环境进行以下操作：

iOS 平台

1. 打开你的 iOS 项目，在 Podfile 中添加以下代码：

   pod 'IAPHUB'
   

2. 运行 pod install 命令。

3. 在 Info.plist 文件中添加 NSAppTransportSecurity 字段，并设置 NSExceptionDomains 为 *.iaphub.com。

Android 平台

1. 在 android/app/build.gradle 文件中添加以下代码：

   implementation 'com.iaphub:react-native-iaphub:2.1.0'
   

2. 同步项目。

初始化和配置

在你的 JavaScript 代码中，配置并初始化 IAPHub：

import Iaphub from 'react-native-iaphub';

Iaphub.init({
  apiKey: '你的API密钥',
  secretKey: '你的密钥',
  env: 'sandbox', // 或 'production'
  platform: 'android' // 或 'ios'
});

3. 应用案例和最佳实践

以下是一个简单的示例，展示如何使用 React Native IAPHub 来展示和购买产品：

import React, { useEffect, useState } from 'react';
import { View, Text, Button } from 'react-native';
import Iaphub from 'react-native-iaphub';

const App = () => {
  const [products, setProducts] = useState([]);

  useEffect(() => {
    // 获取产品信息
    Iaphub.products({
      success: (data) => {
        setProducts(data.products);
      },
      fail: (error) => {
        console.error(error);
      }
    });
  }, []);

  const buyProduct = (productId) => {
    Iaphub.buy(productId, {
      success: (transaction) => {
        console.log('购买成功', transaction);
      },
      fail: (error) => {
        console.error('购买失败', error);
      }
    });
  };

  return (
    <View>
      {products.map((product) => (
        <View key={product.id}>
          <Text>{product.title}</Text>
          <Text>{product.price}</Text>
          <Button title="购买" onPress={() => buyProduct(product.id)} />
        </View>
      ))}
    </View>
  );
};

export default App;

4. 典型生态项目

在 React Native IAPHub 的生态中，你可以找到许多典型的项目，如：

• react-native-iaphub: 核心库，提供内购功能。
• react-native-iaphub-example: 一个简单的示例项目，展示如何使用核心库。
• react-native-iaphub-docs: 官方文档，提供详细的 API 说明和使用案例。

通过上述指南，开发者可以快速集成 React Native IAPHub，实现应用内购买功能，提升应用的用户体验和收入。