概述
使用HBuilder/HBuilderX开发应用时,可在手机/模拟器上查看运行效果,点击菜单栏“运行”->“运行到手机或模拟器”使用。
此功能会在手机/模拟器上安装“HBuilder”应用(或者叫HBuilder标准运行基座),在应用开发过程中HBuilder/HBuilderX会将应用资源实时同步到基座并刷新,从而实时查看到修改效果。
上述HBuilder标准运行基座,是由DCloud提前打包好的,使用的是DCloud申请的第三方SDK配置,manifest里大多数设置都无法动态生效,需要再次打包才可以生效。
例如微信分享,不管开发者在manifest里如何配置,使用HBuilder标准运行基座分享后显示的来源一定是“HBuilder”。
但开发者真实打包后的手机应用又无法通过运行方式来调试,这导致涉及manifest配置的内容调测变的很困难。
为了解决manifest配置相关调试的便利性问题,DCloud提供了制作自定义运行基座的功能,也就是开发者可类似DCloud一样,自己做一个运行基座,里面使用的是自定义的manifest配置。
开发者打包了自定义运行基座,就可以把这个基座运行到手机/Android模拟器上,进行日志查看。
在uni-app应用中调用uni-app原生插件也必须使用自定义调试基座。
使用自定义调试基座
自定义调试基座是使用开发者申请的第三方SDK配置生成的基座应用,用于HBuilder/HBuilderX开发应用时实时在真机/模拟器上查看运行效果。(注:iOS仅支持真机运行自定义基座,不能使用xcode模拟器运行自定义基座)
- 在修改好manifest配置后,在HBuilder/HBuilderX中点击菜单栏“运行”->“运行到手机或模拟器”->“制作自定义基座”生成自定义基座安装包:
- 打包成功后需要在以下位置确保开启自定义调试基座功能:
- 然后就可以像运行到HBuilder标准运行基座那样,运行你的工程到手机/Android模拟器上,查看控制台日志信息。
注意:自定义调试基座是测试版,不可直接商用(使用自定义调试基座覆盖安装apk不会更新应用资源,并且有toast警告)。正式发版时需要按正常打包方式重新打包。
离线生成自定义调试基座
可使用离线SDK打包生成自定义调试基座,生成后将apk和ipa包存放在项目目录/unpackage/debug目录下,文件名分别为android_debug.apk和iOS_debug.ipa。
HBuilderX基座和自定义调试基座差别
uni-app原生插件
必须使用自定义调试基座,HBuilderX标准运行基座不支持调用uni-app原生插件。
地图
应用运行显示效果无差别,地图的配置信息只是校验开发者的合法性。
登录鉴权
授权页面显示效果不同,HBuilderX基座显示的是“HBuilder”应用,自定义调试基座显示的是开发者配置的应用信息。
支付
- 支付宝
无差别,支付宝不校验客户端信息。 - 微信支付
HBuilder基座需要使用DCloud的微信支付服务器生成订单才能完成支付,收款方是DCloud申请的账号。
如果应用中需要调试微信支付功能,则需要使用自定义调试基座,使用从微信申请的配置生成订单,收款方是开发者申请的账号。
推送
HBuilderX基座需要使用DCloud账号登录推送平台才能下发推送消息(目前开发者无法在此环境下发推送消息)。
如果需要调试推送业务,则需要使用自定义调试基座,开发者登录到推送平台下发推送消息。
分享
分享后显示效果不同,HBuilder基座显示的分享来源是“HBuilder”应用,自定义调试基座显示的分享来源是开发者配置的应用信息。
语音识别
- 讯飞语音识别
无差别 - 百度语音识别
HBuilder基座统一使用DCloud向百度语音云平台申请的配置进行语音识别,所有统计数据在DCloud账号下。
如果仅做简单的语音识别,HBuilder基座可正常使用,如果需要使用百度语音云平台配置生效,则需要使用自定义调试基座。
友盟统计
HBuilder基座所有友盟统计数据提交到DCloud申请的友盟统计账号下。
自定义调试基座统计数据提交到开发者申请的友盟统计账号下。