Uniapp自定义基座说明

概述

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