DCloud 接入指引

获取插件和文档

使用 dcloud 的 5+sdk 集成 openinstall

openinstall 提供第三方插件的方式，简化用户集成，用户只需采用离线打包的方式，按照集成文档集成openinstall提供的插件即可使用openinstall提供的所有功能

一、Android 集成指南

集成 openinstall SDK 到 Hbuilder Android 项目中，请参考Android 集成指南

二、iOS 集成指南

集成 openinstall SDK 到 Hbuilder iOS 项目中，请参考iOS 集成指南

三、插件使用

1. 快速安装

如果只需要快速安装功能，无需其它功能（App传参安装、渠道统计、一键拉起），完成初始化即可（包括iOS.md和Android.md中的初始化工作）

以下功能需引入 JS 文件

<script type="text/javascript" src="./js/openinstall.js"></script>

2. 一键拉起

一键拉起的配置见iOS.md和Android.md相关文档

获取拉起数据

在应用启动时，注册拉起回调。这样当 拉起App 时，会回调传入的方法，并在回调中获取拉起数据

document.addEventListener('plusready',function(){
    plus.openinstall.registerWakeUpHandler(function(data){
                console.log("wakeup : channelCode= "
                    + data.channelCode + ", bindData=" + data.bindData);
                alert("wakeup : channelCode= " + data.channelCode + ", bindData=" + data.bindData);
            });

},false);

3. App传参安装高级版功能

获取安装参数
在应用需要安装参数时，调用以下 api 获取由 SDK 保存的安装参数

function getInstall(){
    plus.openinstall.getInstall(function(data){
        console.log("getInstall : channelCode= "
                + data.channelCode + ", bindData=" + data.bindData);
    }, 8);
}

4. 渠道统计高级版功能

SDK 会自动完成访问量、点击量、安装量、活跃量、留存率等统计工作。其它业务相关统计由开发人员使用 api 上报

4.1 注册统计

请确保在用户注册成功后，调用接口上报注册量

function reportRegister(){
    plus.openinstall.reportRegister();
}

4.2 效果点统计

统计终端用户对某些特殊业务的使用效果，如充值金额，分享次数等等。调用接口前，请先进入 openinstall 管理后台 “效果点管理” 中添加效果点，第一个参数对应管理后台效果点ID

function reportEffectPoint(){
    plus.openinstall.reportEffectPoint("effect_test", 1);
}

四、导出apk/ipa包并上传

  • 代码集成完毕后，需要导出安装包上传openinstall后台，openinstall会自动完成所有的应用配置工作。
  • 上传完成后即可开始在线模拟测试，体验完整的App安装/拉起流程；待测试无误后，再完善下载配置信息。

下面是apk包的上传界面（后台截图）：

上传安装包