首页 APP开发 正文内容

uni-app 开发 APP 时,自定义调试基座的作用以及配置方法

2023年10月19日 , , , 2,411

用 uni-app 来开发 APP 几乎都会用到自定义调试基座,本文讲述如何操作。

什么是自定义基座

我们在使用 uni-app 开发原生 APP 时,如果没做任何配置,默认都是在官方的标准基座中打开。但如果我们要引入原生插件,或者是配置 APP 的版本号等应用级别的需求时,就需要根据自己的开发需求,打包自定义基座。

测试或者跑 demo 时可以用官方的基座,但自己开发 APP,就必须打包自己的基座,才能配置 APP 的图标、使用的原生插件等。可以说是一个跳不过的功能点。

如何打包自定义基座

以打包安卓 APP 自定义基座为例,我们在 HbuilderX 的「运行」菜单中,找到「制作自定义调试基座」,然后就会弹出下面这个界面:

制作自定义调试基座
制作自定义调试基座

我们需要准备好证书等资料,详情可以参考 uni-app 官方的方法。凡是下面这些配置更改,都要重新打包自定义基座:

  • App名称、图标、封面 splash、包名、证书等
  • App 模块配置、三方 sdk 配置(如微信、推送、地图、语音识别等三方sdk配置)
  • App 权限配置
  • uni 原生插件有变动
  • 其他 manifest.json 文档提到的需打包生效的配置,比如 APP 版本号等

打包自定义基座成功之后,HBuilderX 会自动将生成后的 apk 和 ipa 的包存放在项目目录 /unpackage/debug 路径下,文件名分别为 android_debug.apkiOS_debug.ipa。接下来我们要做的就是运行项目时,选择运行到自定义几座。

选择项目运行到自定义基座
选择项目运行到自定义基座

注意事项

自定义运行基座是测试版,只用来在本地开发调试项目,不可直接正式发版使用,正式发版时需要按正常打包方式重新打包。