概述
使用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。
Android平台离线生成自定义调试基座
iOS平台离线生成自定义调试基座
HBuilderX基座和自定义调试基座差别
uni-app原生插件
必须使用自定义调试基座,HBuilderX标准运行基座不支持调用uni-app原生插件。