React Native应用内支付库react-native-iap入门指南

React Native应用内支付库react-native-iap入门指南

react-native-iap react-native native module for In App Purchase. 项目地址: https://gitcode.com/gh_mirrors/re/react-native-iap

前言

在移动应用开发中，应用内购买(In-App Purchase)是常见的盈利模式。react-native-iap是一个优秀的React Native库，它可以帮助开发者在iOS和Android平台（包括Play Store和Amazon应用商店）实现应用内购买功能。本文将详细介绍如何开始使用这个强大的工具。

核心功能概述

react-native-iap提供以下核心能力：

• 获取应用内购买商品列表
• 发起购买流程
• 处理购买结果
• 恢复已购买项目
• 订阅管理

需要注意的是，虽然该库处理了客户端的大部分工作，但开发者仍需自行实现服务端验证逻辑，这是确保交易安全性的关键环节。

环境要求

在使用react-native-iap前，请确保满足以下最低版本要求：

• React ≥ 16.13.1
• React Native ≥ 0.65.1

安装步骤

基础安装

通过npm或yarn安装核心包：

npm install react-native-iap
# 或
yarn add react-native-iap

Expo项目配置

对于Expo项目，需特别注意：

1. 无法在Expo Go应用中使用，需要构建自定义客户端
2. 在app.json或app.config.js中添加插件配置：

{
  "expo": {
    "plugins": ["react-native-iap"]
  }
}

支付提供商配置

Android平台支持配置不同的支付提供商：

• 仅Play Store（默认）
• 仅Amazon应用商店
• 两者同时支持

多提供商配置示例：

{
  "expo": {
    "plugins": [
      [
        "react-native-iap",
        {
          "paymentProvider": "both"
        }
      ]
    ]
  }
}

iOS平台配置

安装完成后，执行以下命令完成iOS依赖安装：

cd ios && pod install && cd -

对于iOS 12.x项目，需在Xcode中额外添加SwiftUI.framework（设为Optional）。

Android平台配置

兼容性配置

根据项目使用的支持库版本，需在android/build.gradle中进行相应配置：

Android Support库版本：

ext {
    supportLibVersion = "28.0.0"
}

AndroidX版本：

ext {
    androidXAnnotation = "1.1.0"
    androidXBrowser = "1.0.0"
    minSdkVersion = 24
    kotlinVersion = "1.8.0"
}
dependencies {
    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlinVersion"
}

支付提供商配置

在android/app/build.gradle中配置：

仅Play Store：

defaultConfig {
    missingDimensionStrategy "store", "play"
}

同时支持Play Store和Amazon：

android {
    flavorDimensions "appstore"
    productFlavors {
        googlePlay {
            dimension "appstore"
            missingDimensionStrategy "store", "play"
        }
        amazon {
            dimension "appstore"
            missingDimensionStrategy "store", "amazon"
        }
    }
}

手动安装指南

iOS手动安装

1. 在Podfile中添加：

   pod 'RNIap', :path => '../node_modules/react-native-iap'
   

2. 运行pod install

Android手动安装

1. 在MainApplication.java中添加导入和包注册
2. 在settings.gradle中添加项目引用
3. 在app/build.gradle中添加依赖实现
4. 完成上述支付提供商配置

最佳实践建议

1. 沙盒测试：在开发阶段充分利用各平台的沙盒环境进行测试
2. 收据验证：务必实现服务端收据验证逻辑
3. 错误处理：妥善处理各种购买场景下的错误情况
4. UI/UX设计：遵循各平台的应用内购买设计规范
5. 订阅管理：为订阅型商品提供明确的管理入口

常见问题

Q: 为什么需要服务端验证？ A: 客户端验证可能被篡改，服务端验证可确保交易真实性。

Q: 如何处理跨平台购买？ A: 需要自行实现用户账户系统关联不同平台的购买记录。

Q: 测试时需要注意什么？ A: 使用各平台提供的测试账户，避免使用真实支付方式。

通过本文的介绍，您应该已经掌握了react-native-iap的基本配置方法。接下来可以开始实现具体的购买逻辑和UI界面了。

react-native-iap react-native native module for In App Purchase. 项目地址: https://gitcode.com/gh_mirrors/re/react-native-iap