1. HBuilder(标准)基座介绍
(1) 点击菜单栏“运行”->“运行到手机或模拟器”,会在手机/模拟器上安装“HBuilder”应用(或者叫HBuilder基座),在应用开发过程中HBuilder/HBuilderX会将应用资源实时同步到基座并刷新,从而实时查看到修改效果。
(2) 这里的“HBuilder”应用(或者叫HBuilder基座)使用的是DCloud申请的第三方SDK配置,开发者设置的第三方SDK配置信息不会生效。如微信分享,分享后显示的来源一定是“HBuilder”。如果开发者希望自己申请的第三方SDK配置生效,则需使用自定义基座,在应用中调用uni-app原生插件也必须使用自定义基座。
2. 自定义基座介绍
(1) 自定义基座是使用开发者申请的第三方SDK配置生成的基座应用,用于HBuilder/HBuilderX开发应用时实时在手机/模拟器上查看运行效果
(2) 在HBuilder/HBuilderX中点击菜单栏“运行->运行到手机或模拟器->制作自定义基座”生成自定义基座安装包
[HBuilder] 19:37:36.837 项目 SOURCE [__UNI__1E9A5AA]打自定义基座包成功:
路径为: G:/liy/projects/uniapp/SOURCE/unpackage/debug/android_debug.apk
选择菜单“运行->运行到手机或模拟器->运行基座选择->自定义基座”后再次运行项目,即可通过自定义基座查看日志
注:自定义基座不可用于正式发布,其脱离HBuilderX无法更新应用资源
(3) 打包成功后需要点击菜单栏“运行->运行到手机或模拟器->运行基座选择->自定义基座”来开启自定义基座功能
(4) 点击菜单栏“运行”->“运行到手机或模拟器”,可实时在手机上查看运行效果
3. 查看基座版本号
onReady:function(){
// #ifdef APP-PLUS
console.log("运行环境版本号(客户端uni-app的基座版本号):" + plus.runtime.uniVersion);
console.log("应用基座版本号(客户端5+运行环境的版本号):" + plus.runtime.innerVersion);//格式为:[主版本号].[次版本号].[修订版本号].[编译代号]
// #endif
},
4. 差别:
(1) uni-app原生插件
必须使用自定义基座,HBuilder基座不支持调用uni-app原生插件。
(2) 地图
应用运行显示效果无差别,地图的配置信息只是校验开发者的合法性。
(3) 登录鉴权
授权页面显示效果不同,HBuilder基座显示的是“HBuilder”应用,自定义基座显示的是开发者配置的应用信息。
(4) 支付
- 支付宝
无差别,支付宝不校验客户端信息。 - 微信支付
HBuilder基座需要使用DCloud的微信支付服务器生成订单才能完成支付,收款方是DCloud申请的账号。
如果应用中需要调试微信支付功能,则需要使用自定义基座,使用从微信申请的配置生成订单,收款方是开发者申请的账号。
(5) 推送
HBuilder基座需要使用DCloud账号登录推送平台才能下发推送消息(目前开发者无法在此环境下发推送消息)。
如果需要调试推送业务,则需要使用自定义基座,开发者登录到推送平台下发推送消息。
(6) 分享
分享后显示效果不同,HBuilder基座显示的分享来源是“HBuilder”应用,自定义基座显示的分享来源是开发者配置的应用信息。
(7) 语音识别
- 讯飞语音识别
无差别 - 百度语音识别
HBuilder基座统一使用DCloud向百度语音云平台申请的配置进行语音识别,所有统计数据在DCloud账号下。
如果仅做简单的语音识别,HBuilder基座可正常使用,如果需要使用百度语音云平台配置生效,则需要使用自定义基座。
(8) 统计
HBuilder基座所有统计数据提交到DCloud申请的统计平台账号下。自定义基座统计数据提交到开发者申请的统计平台账号下。
备注
:使用自定义基座各种SDK配置才能生效, 但是使用自定义基座进行云端打包后,HX提示【自定义基座不可用于正式发布,其脱离HBuilderX无法更新应用资源】,手机安装打出来的包提示【当前应用运行在测试环境,发布正式版请打正式包】。原因是自定义基座和HBuilder自带基座都是用于开发调试。使用自定义基座开发调试uni-app原生插件后,不可直接将自定义基座apk作为正式版发布。云打包时若勾选了“自定义基座”,打出来的是测试包;应该重新提交云端打包(不能勾选“自定义基座”
)生成正式版本,正式包的SDK配置会自动生效。