Java - Android抛弃厌烦的邀请码，我们应该这样做

OpenInstall - Android集成说明

官方地址：http:///www.openinstall.io

开发中，我们经常会遇到填写邀请码的问题？尤其是针对跑市场的人员来说，这更是对业务有极大帮助的，邀请码涉及到公司的业务以及注册量统计等问题。因此OpenInstall公司推出了一款专门应对该问题的一款SDK【OpenInstall】。经过开发实践，发现OpenInstall完全可使用并应用于开发业务中。那么我们应该如何集成并使用它呢？？？

Ps: 该SDK收费标准为8000/year，试用期为1个月

如何把OpenInstall SDK集成到项目中？

1. 首先先按照官方的文档说明进行配置：

• 下载 Android SDK


• 
  导入Openinstall SDK
  将SDK拷贝到项目的libs文件夹中，并导入

dependencies {
    compile files('libs/OpenInstall_vX.X.X.jar')
}

基础配置
在AndroidMaifest.xml中添加权限声明

在AndroidMaifest.xml中设置AppKey

初始化SDK

 public class MyApplication extends Application {
         @Override
         public void onCreate() {
             super.onCreate();
             OpenInstall.init(this);
             //打开调试，便于看到Log
             OpenInstall.setDebug(true);
         }
}

设置scheme
在AndroidMaifest.xml的唤醒页面activity标签中添加intent-filter

个性化安装集成/渠道统计集成
在应用启动页如下调用相关代码，获取安装参数/渠道参数

public class SplashActivity extends BaseActivity implements AppInstallListener {
    @Override
    public void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_splash);
            //获取OpenInstall数据
            OpenInstall.getInstall(this);
    }
    @Override
    public void onInstallFinish(AppData appData, Error error) {
            if (error == null) {
                //获取渠道数据
                Log.d("SplashActivity", "channel = " + appData.getChannel());
                //获取个性化安装数据，需要缓存到本地，需要时就取出来使用
                Log.d("SplashActivity", "install = " + appData.getData());
            } else {
                Log.d("SplashActivity", "error : "+error.toString());
            }
    }
}

一键跳转集成
在唤醒页面如下调用相关代码，获取web端传过来的参数

public class MainActivity extends BaseActivity implements AppWakeUpListener {
    @Override
    public void onCreate(Bundle savedInstanceState) {
            super.onCreate(savedInstanceState);
            setContentView(R.layout.activity_main);
            OpenInstall.getWakeUp(getIntent(), this);
    }

    @Override
    protected void onNewIntent(Intent intent) {
            super.onNewIntent(intent);
            setIntent(intent);
            //此处要调用，否则App在后台运行时，会无法截获
            OpenInstall.getWakeUp(intent, this);
    }
    @Override
    public void onWakeUpFinish(AppData appData, Error error) {
            if (error == null) {
                //能从浏览器中获取到唤醒参数，目前一些浏览器不支持该功能，如UC，绿茶等浏览器
                Log.d("MainActivity", "wakeup = " + appData.toString());
            } else {
                Log.d("MainActivity", "error : "+error.toString());
            }
    }
}

2. 应该在哪里获取安装参数？

ps: 只有在全新安装的时候，才能从AppInstallListener中的AppData中获取到数据！

• 安装参数需要由网页提供WebSDK编写，暂时测试时可以使用官方的测试接口。


• 测试前，我们应该把打包好的应用上传至官方包托管理处。


• 测试时，我们需要从测试链接中获取APP下载链接，下载并安装应用。


• 由接口传入的数据，将会传入AppData对象中,我们需要保存该值到本地。

备注： Web SDK如何集成测试环境？

SDK概述

web sdk用于web页面启动/安装app,并在启动/安装app的同时，向app传递各种自定义参数（通过android/ios sdk可>获取传递的参数）。web sdk可根据不同浏览器的特性，提供完整的app启动与安装的流程，包括微信，QQ等内置浏览器。