openinstall 的Android集成步骤

2024-11-06 技术教程

openinstall的作用：

第一步：登入openinstall官网，没有账号就注册个

第二步：没有应用就添加一个应用（选择高级版）

第三步：下载导入sdk(其实就一个jar)

将下载的OpenInstall_v2.3.0.jar放入到libs文件夹下，然后在build.gradle下添加：

dependencies{implementationfiles('libs/OpenInstall_v2.3.0.jar')}

第四步：在AndroidManifest.xml中添加权限声明

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

第五步：在AndroidManifest.xml的application标签内设置AppKey

第六步：在application里添加初始化代码

@OverridepublicvoidonCreate(){super.onCreate();if(isMainProcess()){openInstall();}}

//判断是否是主进程publicbooleanisMainProcess(){intpid=android.os.Process.myPid();ActivityManageractivityManager=(ActivityManager)getSystemService(Context.ACTIVITY_SERVICE);for(ActivityManager.RunningAppProcessInfoappProcess:activityManager.getRunningAppProcesses()){if(appProcess.pid==pid){returngetApplicationInfo().packageName.equals(appProcess.processName);}}returnfalse;}

第七步：在AndroidManifest.xml里指定自己的application

<applicationandroid:name=".TestApplication"/>

第八步：实现快速下载

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

第九步：携带参数安装，在application里添加以下代码

privatevoidopenInstall(){//初始化OpenInstall.init(this);//携带参数安装OpenInstall.getInstall(newAppInstallAdapter(){@OverridepublicvoidonInstall(AppDataappData){Log.d(TAG,"appData="+appData);//获取渠道数据channelCode=appData.getChannel();//获取自定义数据try{duanzishou=newJSONObject(appData.getData()).optString("duanzishou");}catch(JSONExceptione){e.printStackTrace();}}});}

第十步：测试携带参数安装

（应用场景就是邀请别人免填邀请码下载安装等，邀请码的信息在链接的自定义参数里，比如下载链接https://app-**********.openinstall.io/channel-landing?phoneNumber=13***********,被邀请的用户安装后，openinstall获取自定义参数，然后可以在注册的时候，通过接口将这个参数值上传到后台服务器）

1.在openinstall官网，点击Android集成，点击APK包，点击上传APK文件

2.在这个界面下面的列表里，点击测试

3.在弹出的框里的key写入在application里写的要获取的自定义的参数名称，点击生成测试连接

4.点击连接跳转到下载apk的界面，点击立即使用，下载apk，安装到手机上

5.删除以前的包，安装下载的包到手机上，打开，看结果（channel没设置，自定义参数获取到了）

第十一步：在需要一键拉起的activity里添加代码

protectedvoidonCreate(BundlesavedInstanceState){super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);OpenInstall.getWakeUp(getIntent(),wakeUpAdapter);}@OverrideprotectedvoidonNewIntent(Intentintent){super.onNewIntent(intent);//此处要调用，否则App在后台运行时，会无法截获OpenInstall.getWakeUp(intent,wakeUpAdapter);}AppWakeUpAdapterwakeUpAdapter=newAppWakeUpAdapter(){@OverridepublicvoidonWakeUp(AppDataappData){//获取渠道数据StringchannelCode=appData.getChannel();//获取绑定数据StringbindData=appData.getData();Log.d("appData","getWakeUp:wakeupData="+appData.toString());}};@OverrideprotectedvoidonDestroy(){super.onDestroy();wakeUpAdapter=null;}

第十二步：在AndroidManifest.xml的唤醒页面activity标签中添加intent-filter（一般为MainActivity）,配置scheme，用于浏览器中拉起

<intent-filter><actionandroid:name="android.intent.action.VIEW"/><categoryandroid:name="android.intent.category.DEFAULT"/><categoryandroid:name="android.intent.category.BROWSABLE"/><dataandroid:scheme="******"/></intent-filter>

第十三步：上传apk，设置自定义参数和值，生成链接和二维码，扫下二维码，手机跳转到链接的界面，点击立即使用，就自动跳转到程序上

第十四步：查看一键拉起的获取的参数的值

第十五步：配置渠道参数

点击渠道管理，添加渠道，然后点击渠道链接显示https://app-*****.openinstall.io/channel-landing?channelCode=00000111（这里有渠道信息channelCode，但是这个链接没有自定义参数，上面有自定义有参数的链接但是没有渠道信息，如果我两个都想要，（这个连接都是后台生成，后台给的，我这里就拼接下）https://app-*********.openinstall.io/js-test/android/1047412755738029502?duanzishou=%E5%A4%A7%E5%BC%A0%E4%BC%9F&channelCode=00000111）

第十六步：将拼接的链接在草料二维码网站（https://cli.im/url）生成二维码

第十七步：扫二维码，下载apk，安装，打开，测试参数有没有获取到

第十八步：注册量统计（看业务需求）

//用户注册成功后调用OpenInstall.reportRegister();

第十九步：看应用统计和渠道报表