# 快速上手
# 环境准备
# Project setup
npm install
# 更新uniapp底座
注意
npm install后,项目npm run dev跑不动,并无报错,可尝试更新uniapp底座
需要使用node14或以上版本更新,更新完成后可提交package.json文件,node14以下版本拉取文件后,删除node_modules,重新install即可
npx @dcloudio/uvm
# 项目运行(h5/微信小程序/app)
# 运行到 H5 端
npm run dev
# 运行到 微信小程序 端
npm run dev:mp-weixin
运行成功后,再打开一个powershell,执行处理分包命令
npm run async
# 运行到App端
使用HBuilder运行
1. 如果项目中需要使用到附件选择,需要制作自定义基座,步骤为
1)需在开发者后台购买(目前所使用的插件是免费的)相应的原生插件
其中文件选择原生插件链接为:
a. Android 端:https://ext.dcloud.net.cn/plugin?id=5263
b. IOS端:https://ext.dcloud.net.cn/plugin?id=1311
2)购买后,需要填写对应的Android 或 IOS 包名 ,此包名为打自定义基座时设置的包名
3)设置完毕后,在开发者后台 - 我的插件 - 我购买的插件上可以看到购买的插件及对应设置的包名
4)IOS端还需购买证书,此步骤由于条件限制,没有实施过,需自行探索
5)在HBuilder中打开 src/manifest.json 文件,点击App原生插件配置,勾选所需的插件
6)在HBuild上制作自定义基座包:需要注意勾选“打自定义基座”的选项,以及包名与购买插件时设置的包名一致即可
7)等待打包完毕后,一般/dist/文件夹下会生成 debug/android_debug.apk 或 debug/iOS_debug.ipa,即可检测到自定义基座(ps:如果没有生成,则需自行下载下来添加)
8)HBuilder中点击 运行 - 运行到手机或模拟器 - 运行到XXX App基座,选择自定义基座运行即可
2. 如果无需使用到附件选择,则需要前往 src\async-module\components\common\bd-form\components\items\bd-attach.vue 文件内,将其更改为空组件,防止发生错误
# 发布
# 发布H5
npm run build
如果需要打包其他环境(如:xxx)的包:
1. package.json 上新增 build:xxx 的script命令,将build:h5的命令复制一份,如下:
{
"scripts": {
"build:h5": "cross-env NODE_ENV=test UNI_PLATFORM=h5 UNI_OUTPUT_DIR=bdmobile vue-cli-service uni-build --mode test --minimize",
"build:xxx": "cross-env NODE_ENV=test UNI_PLATFORM=h5 UNI_OUTPUT_DIR=bdmobile vue-cli-service uni-build --mode test --minimize",
}
}
2. 复制一份 .env.test 文件,重命名为 .env.xxx 即可配置对应环境的环境变量(注意后缀必须与1中的xxx对应)
3. 运行打包命令
npm run build:xxx
# 发布微信小程序
1. 执行打包命令
npm run build:mp-weixin
2. 执行异步化分包脚本
npm run async:test
3. 使用微信小程序开发者工具打开 dist/build/mp-weixin
4. 使用微信小程序开发者工具进行发布
# 发布APP
使用HBuilder进行生成APK、IPA文件
项目代码目录 →