更新记录

1.46(2021-03-09)

1、可修改下载提示文字; 2、可修改下载提示按钮文字;

1.45(2021-01-26)

1、修复了android自定义图片,某些图片底部出现黑线的问题

查看更多

平台兼容性

Android iOS
适用版本区间:4.4 - 11.0 适用版本区间:9 - 14

原生插件通用使用流程:

  1. 购买插件,选择该插件绑定的项目。
  2. 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
  4. 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择


使用的时候需要判断是android 还是ios平台;

<!--备注:之前有使用我的插件的人,要记得更新下;大家有什么需求可以提给我;有不懂的可以提问-->

//增加接口

关闭弹框:

const upDater=uni.requireNativePlugin("CL-UpDater");

upDater.close();

提示:进度条的主题颜色与升级按钮颜色一致;

app升级逻辑介绍
appUpdate:function(newAppVer,wgtVer)
        {

            let oldAppVer=plus.runtime.version;

            if(oldAppVer<newAppVer)
            {
                     //调用app整包升级;
            }
            else if(oldAppVer==newAppVer)
            {
                //热更新版本号和整包的版本号不一样;
                //第一步要获取本地的wgt版本号;这是异步方法;
                 plus.runtime.getProperty(plus.runtime.appid, function ( wgtinfo ) {

            let oldwgtver=wgtinfo.version;
            if(oldwgtver<wgtVer)
            {
                //调用热更新;
            }

                }); 

        }

使用方法:

1、app整包升级

提示:ios端只需设置苹果商店的链接地址,设置之后会直接跳转到苹果商店中;

  const upDater=uni.requireNativePlugin("CL-UpDater");
                let options={
                    title:"升级",
                    con:"有数据需要更新,请点击升级\n1、优化了某些方案;\n2、优化了某些流程;\n3、完善了支付功能",
                    downUrl:"app下载地址",必填
                    hidCancelbtn:false, 可选//是否隐藏取消按钮;
          btnBgColor:"#ff3300",可选 //设置按钮背景色颜色
          updateBtnText:"升级",可选//升级按钮文字,默认为立即升级
          topImgBg:"topLogo地址" 可选//非必填,用于自定义;自定义方法请参考demo,
                    hidBackBtn:false, //可选 默认为false(即会显示后台更新按钮), 设置android 整包更新弹框是否显示后台更新按钮,这个只有android整包更新才有这个参数,热更新是是无法设置的。
                    verCode:"1.0.1",//最新apk版本号 可选  用于Android整包升级,避免用户取消安装apk时,重复下载问题,如果不传的话,apk将会重新下载,
                    downMsgTip:"资源下载中,请稍后...", //可选(android)
                    goBackBtnText:"进入后台",//可选(android)

                }
                //必需提供下载地址;
                upDater.startUpdate(options,()=>{

                        console.log("弹框关闭了");

                });

2、wgt升级

提示:获取本地热更新的版本号是异步的,因此进行版本比较的时候要注意下;

请参考我提供的demo;

  let options={
                    title:"升级",
                    con:"有数据需要更新,请点击升级\n1、优化了某些方案;\n2、优化了某些流程;\n3、完善了支付功能",
                    downUrl:"http://192.168.31.177/update.wgt",必填
                    updateBtnText:"升级",
                    hidCancelbtn:false //是否隐藏取消按钮;
          btnBgColor:"#ff3300" //设置按钮背景色颜色,
          downMsgTip:"资源下载中,请稍后...", //可选
          topImgBg:"topLogo地址" //非必填,用于自定义;如何自定义图片,请参考我提供的demo;
                }

rootPath 为下载存放地址;(请参考demo);

result 为wgt下载完成之后的安装地址;

 upDater.wgtUpdate(options,rootPath,result=>{
  if(result)
                    {
            let pathNew = plus.io.convertAbsoluteFileSystem(result);

            plus.runtime.install(pathNew, {
              force: false
            }, function() {

              //进行重新启动;
              plus.runtime.restart();

            }, (e) => {

                uni.showToast({
                  title: '安装升级包失败'+JSON.stringify(e),
                  icon: 'none'
                })                          

            },()=>{

                    console.log("弹框关闭了");

            });

    }

})

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问