React Native 如何实现拉起App

概述

Xinstall 支持 React Native 应用接入，你可以使用 NPM 包管理器及 React Native 配套工具进行快速集成。 对应的 NPM 包名为：xinstall_react_native，你可以在 这里 找到 NPM 中对应的包页面。

xinstall_react_native 模块封装了 Xinstall 官方 SDK，是集智能传参、快速安装、一键拉起、客户来源统计等功能，帮您提高拉新转化率、安装率和多元化精确统计渠道效果的产品。为用户提供点击、安装、注册、留存、活跃等精准统计报表，并可实时排重，杜绝渠道流量猫腻，大大降低运营成本。 具体详细介绍可前往 Xinstall 官网 进行查看。

如何接入

下面我们介绍如何进行React Native接入：

【重要说明】：从 v1.5.0 版本（含）开始，调用 Xinstall 模块的任意方法前，必须先调用一次初始化方法（init 或者 initWithAd），否则将导致其他方法无法正常调用。

从 v1.5.0 以下升级到 v1.5.0 以上版本后，需要自行修改代码调用初始化方法，Xinstall 模块无法在升级后自动兼容。

1、在 React Native 工程中安装模块

在需要集成的 React Native 工程根目录下，执行：

npm install xinstall-react-native --save

如果该工程使用的 React Native 版本 < 0.60.0 那么需要执行 link 命令：

npx react-native link xinstall-react-native

接下来需要针对 iOS 端进行 pod 安装 xinstall 的包：

// 在 React Native 工程根目录下依次执行
cd ios
pod install
cd ..

【注意】如果 pod install 失败，或者您的 iOS 工程是通过 pod 集成 React Native，那么可以按照如下步骤进行 iOS 端集成：

• 在 ios/Podfile 文件中添加本地 path：

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

• 然后在 ios/ 目录下执行：

  pod install
  

2、创建 Xinstall 应用

进入 Xinstall 官网 注册账号，并在控制台中创建一个对应的应用，应用名字可以任意填写： 

 注意记录 Xinstall 中新创建应用的 appkey（后续配置需要用到）： 

 接入过程中如有任何疑问或者困难，可以随时联系 Xinstall 官方客服 在线解决。

3、初始化配置

3.1、获取必要参数

• appKey：从 Xinstall 平台获取的 AppKey，在上一步骤中可以获取到
• scheme：详细获取位置：Xinstall 应用控制台-> Android下载配置 中获取

3.2、自动初始化 xinstall-react-native 模块

进入 React Native 工程根目录，执行：

npm run initxinstall <appKey> <scheme>

【注意】：appKey 和 scheme 分别替换成 3.1 中具体的值（两边的尖括号不需要，去掉即可）

如果执行这步时，终端中如果因为报错而导致自动初始化失败，那么可以参考这篇文章进行：手动初始化 xinstall-react-native 模块

3.3、Universal links 相关配置（针对 iOS）

Xinstall 通过 Universal links（iOS ≥ 9）技术，在 App 已安装的情况下，从各种浏览器（包括微信、QQ、新浪微博、钉钉等主流社交软件的内置浏览器）拉起 App 并传递动态参数，避免重复安装。

开启 Associated Domains 服务

对于 iOS，为确保能正常使用一键拉起功能，AppID 必须开启 Associated Domains 功能，请到苹果开发者网站，选择 “Certificate, Identifiers & Profiles”，选择 iOS 对应的 AppID，开启 Associated Domains：

为刚才开发关联域名功能的 App ID 创建新的（或更新现有的）描述文件，下载并导入到 Xcode 中（通过 Xcode 自动生成的描述文件，可跳过这一步）：

配置 Universal links 关联域名

在 Xcode 中配置 Xinstall 为当前应用生成的关联域名（Associated Domains）：applinks:xxxx.xinstall.top 和 applinks:xxxx.xinstall.net

具体的关联域名可在 Xinstall管理后台 - 对应的应用控制台 - iOS下载配置 页面中找到

4、导出包上传 Xinstall

代码集成完毕后，需要通过 React Native 导出 iOS 和 Android 离线包（.ipa 和 .apk），并上传 Xinstall 控制台里对应的 App：

示例图片（iOS 端）： 

示例图片（Android 端）： 

上传完包后，需要进入「iOS下载配置」和「Android下载配置」中选择下载的包的版本

示例图片（iOS 端）： 

示例图片（Android 端）： 

注意：每次上传完新的 ipa 或者 apk 包后，均需要进入「iOS下载配置」和「Android下载配置」中重新选择下载的包的版本

三、如何使用

1、快速下载和一键拉起

如果只需要快速下载功能和一键拉起，无需其它功能（携带参数安装、渠道统计），完成初始化配置即可。其他影响因素如下图 

2、初始化 Xinstall 模块

注意：从 v1.5.0 版本开始，在调用 Xinstall 插件的任意方法之前，必须调用一次初始化方法，只需要调用一次即可，不需要反复调用。

v1.5.0 之前的版本会在启动时自动初始化，无需调用，也无法调用。

init

初始化方法。在调用 Xinstall 插件其他方法之前必须调用一次该方法，否则其他方法均无法正常执行。

示例代码

init()

入参说明：无需主动传入参数

回调说明：无需传入回调函数

调用示例

// 在文件头部导入 xinstall 模块
import xinstall from 'xinstall-react-native'
// 在代码中调用 init 方法初始化
xinstall.init();

可用性

Android系统，iOS系统

可提供的 1.5.0 及更高版本

---

更高级的 携带参数安装/唤起、高级数据统计、场景定制统计、广告平台渠道功能、苹果搜索广告(ASA)渠道功能可以看集成文档

三、导出apk/ipa包并上传

参考官网文档

iOS集成-导出ipa包并上传

Android-集成

四、如何测试

参考官方文档 测试集成效果