在项目开发过程中，负责的推广二维码模块需要加入openinstall三方框架，该框架可以在推广二维码中搭建一层上下级关系，加上一定的积分奖励，极大地提高了用户的推广热情，并且不同于以往常规的手动填写邀请码，该框架可以实现邀请码免填、携带参数等功能，以下对该框架的使用心得和步骤做下简单的归纳和整理。

1.首先登录openinstall官方平台

链接：https://www.openinstall.io/

2.完成常规的注册登录

3.下载AndroidSDK

4.SDK下载完成解压后，发现是一个jar包

5.将该jar包拷贝到项目project下的libs文件夹中，添加依赖完毕

6.在AndroidManifest清单文件中添加一下相关权限

<uses-permission android:name= "android.permission.INTERNET"/>
<uses-permission android:name= "android.permission.ACCESS_NETWORK_STATE"/>

7.在AndroidManifest清单文件中的application标签内设置AppKey，此处AppKey填写你在控制台新建应用后系统分配的key值

<meta-data
           android:name="com.openinstall.APP_KEY"
           android:value="填写控制台对应应用的Appkey值"/>

8.在应用的自定义Application中初始化

public class MyApplication extends Application{
          public void onCreate(){
                    super.onCreate();
                    if(isMainProcess){
                          //如果应用有多个进程，确保只在主线程中初始化
                         OpenInstall.init(this);
                    }
           }
           public boolean isMainProcess(){
                      int pid= android.os.process.myPid();
                      ActivityManager activityManager= (ActivityManager)getSystemService(Context.ACTIVITY_SERVICE);
                      for(ActivityManager.RunningAppProcessInfo appProcess: activityManager.getRunningAppProcess()){
                                  if(appProcess.pid== pid){                                            returngetApplicationInfo().packageName.equals(appProcess.processName);
                                   }
                      }
                      return false;
            }
}

9.配置一键拉起。

在AndroidManifest的唤醒页面activity标签中添加intent-filter,一般都是启动页面StartActivity,配置schema

<activity
       android:name=".StartActivity'
       android:launchMode="singleTask" >
       <intent-filter>
               <action android:name="android.intent.action.VIEW"/>
               <category android:name="android.intent.category.DEFAULT"/>
               <category android:name="android.intent.category.BROWSABLE"/>
               <data android:schema="填写控制台对应应用的Appkey值"/>
       </intent-filter>
</activity>

10.在我们的需求中，如果推广给新用户，在注册时，要把分享人的手机号同样上传，该手机号就是我们拼接的手机号，这里在注册页面我们通过openinstall提供的方法获取

OpenInstall.getInstall(new AppInstallAdapter(){
         public void onInstall(AppData appData){
               //获取渠道数据
               String channelCode= appData.getChannel();
              //获取自定义数据
               String bindData= appData.getData();
               Log.d("OpenInstall", "getInstall: installData= "+ appData.toString());
         }
})

如果配置无误，返回的参数就是这样的 ,phone即我们拼接的参数，也可拼接多个，字段任意，拼接什么参数返回就是什么参数，之后进行JSONObject解析，就可获取对应字段的值了，之后我们在注册用得到。

11.然后把APP托管到该平台上

12.完成基本的参数配置后，我们进入功能集成环节。

在我们项目需求中，我们需要由H5前端开发给我们提供一个集成openinstall WebBanner的网页链接，前端具体实现我们移动端不了解，只需要把控制台对应应用的webbanner发给他，由其配置后提供一个链接即可

13.等网页这边配置完毕后，拿到链接，打开就是这样的

这个页面的布局可以由UI和H5自定义，这里只是简单一个APP的logo，文字，下面有个“进入”的按钮，具体点击后的功能我们下来再说。

14.接下来，我们给后台给的链接后拼接当前用户登录的手机号，字段任意，比如字段设为phone

http://xxxxxxxxxxxxxxxxxxxxxxxxxxxx?phone=12345678911

     为什么要拼接当前用户登录的手机号（帐号）？这样分享出去的二维码实则就跟该用户绑定了，因此给别人推广成功后，当前用户自动就会成为对方的上级关系，至于具体实现上下级关系的细节，我们下来再陈述。

15.然后把这个拼接后的链接塞到二维码中，这里我用的是zxing框架，具体使用方法就不在这里详述了。

String shareUrl= "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx?phone="+ phoneNumber;
bitmap= ZxingUtils.createQRImage(shareUrl, 250, 250, null);

16.将二维码图片分享出去,这里用的MobShareSDK分享框架，具体使用方法不在这里详述，不熟悉可以看下我之后整理的相关博客。

别人得到二维码图片，通过扫描或者长按识别打开我们拼接参数后的网页。点击 "进入" 按钮。这时会出现两种情况。

1)如果别人手机已安装这款应用，因为我们配置过schema，会自动拉起应用

2)如果别人手机没有这款应用，因为我们托管过app，所以会启动下载，该处也可填写第三方托管平台，比如fir，之后正式上线应用市场比如应用宝之类，再填写正式的下载链接即可。

17.下载完毕后，进入新用户注册，因为我们之前在注册页面已写了获取推广人手机号的步骤，所以请求注册接口时将该参数填入即可，如果用户没有推广人，比如是自己通过其他渠道下载，那该参数就是返回空，不影响注册。

注册成功后，可以在后台检测新用户的上级字段是否有值，有值则成功。

至此全部完成！