Openinstall React Native Plugin

openinstall-react-native 是openinstall官方开发的 React Native 插件，使用该插件可以方便快速地集成openinstall相关功能。

使用 npm 安装插件

在您的项目根目录下执行

npm install openinstall-react-native --save

react-native link

##一、自动集成方式

1. 使用openinstallConfig脚本自动集成代码和部分配置

npm run openinstallConfig <yourAppKey> <yourScheme>
// yourAppKey指的是你在openinstall官方账号后台，创建应用后分配的AppKey
// yourScheme指的是你在openinstall官方账号后台，创建应用后分配的scheme

2. xcode配置（只对iOS） 在 iOS 工程中，如果要使用universal links(通用链接)的拉起功能，需要开启 Associated Domains功能，请到苹果开发者网站，选择Certificate, Identifiers & Profiles，选择相应的AppID，开启Associated Domains。注意：当AppID重新编辑过之后，需要更新相应的mobileprovision证书。(详细配置步骤请看openinstall官网后台文档，universal link关联域名从后台获取)，如果已经开启过Associated Domains功能，进行下面操作：

• 在左侧导航器中点击您的项目
• 选择 Capabilities 标签
• 打开 Associated Domains 开关
• 添加 openinstall 官网后台中应用对应的关联域名（iOS集成->iOS应用配置->关联域名(Associated Domains)）

注意：

• 如果在执行openinstallConfig脚本进行自动集成时发生错误，请使用文档后面的手动集成方式。

• 在 iOS 工程中如果找不到头文件可能要在 TARGETS-> BUILD SETTINGS -> Search Paths -> Header Search Paths 添加如下如路径：

$(SRCROOT)/../node_modules/openinstall-react-native/ios/RCTOpenInstall

使用指南

###1 快速下载 如果只需要快速下载功能，无需其它功能（携带参数安装、渠道统计、一键拉起），完成sdk初始化即可（自动集成方式或手动集成方式）

###2 一键拉起

导入插件

请react native端入口js文件中（例如App.js文件）导入：

import OpeninstallModule from 'openinstall-react-native'

获取拉起参数

通常在 componentDidMount 中监听

componentDidMount() {
  //该方法用于监听app通过univeral link或scheme拉起后获取唤醒参数
  this.receiveWakeupListener = map => {
     if (map) {
	//do your work here
     }        
   Alert.alert('拉起回调',JSON.stringify(map)) 
  } 
  OpeninstallModule.addWakeUpListener(this.receiveWakeupListener)  
}

• 第二个函数返回的是map或字典，包含动态安装参数（data）和渠道参数（channel），注意：只有通过渠道二维码或链接安装app后，才会有渠道参数
• 如果动态安装参数（data）和渠道参数（channel）同时为空，则map返回null

###3 携带参数安装 高级版功能 在需要获取安装参数的位置，导入插件：

import OpeninstallModule from 'openinstall-react-native'

调用如下方法，可重复获取（理论上可在任意位置获取安装参数）：

OpeninstallModule.getInstall(10, map => {
  if (map) {
    //do your work here
  }        
  Alert.alert('安装回调',JSON.stringify(map))     
})

• 第一个传入的参数为超时时长，一般为10s左右，如果只是在后台默默统计或使用，可以设置更长时间；第二个函数返回的是map或字典，包含动态安装参数（data）和渠道参数（channel），注意：只有通过渠道二维码或链接安装app后，才会有渠道参数
• 如果动态安装参数（data）和渠道参数（channel）同时为空，则map返回null
• 对iOS，该方法尽量写在业务场景需要参数的位置调用（在业务场景时，网络一般都是畅通的），例如，可以选择在用户注册成功后调用该方法获取参数，对用户进行奖励。原因是iOS首次安装、首次启动的app，会询问用户获取网络权限，用户允许后SDK才能正常联网去获取参数。如果调用过早，可能导致网络权限还未允许就被调用，导致参数无法及时拿到，误以为参数不存在

###4 渠道统计 高级版功能 SDK 会自动完成访问量、点击量、安装量、活跃量、留存率等统计工作。

####（1）上报注册事件 在用户注册成功时，可调用该方法上报注册事件，需要导入'openinstall-react-native'

OpeninstallModule.reportRegister()

####（2）上报效果点 两个参数分别为 效果点的ID，string类型，以及 效果点的值，为整型，示例：

OpeninstallModule.reportEffectPoint('effect_test',1)

React Native示例demo

• 我们提供了一个demo供开发者参考对照 demo