Uniapp自定义基座说明

2022-07-22 13:52:25 浏览数 (1)

概述

使用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原生插件。

0 人点赞