# 快速上手

# 环境准备

# 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文件