一、安装环境
nodejs,HBuilder
二、创建项目
三、运行项目
本地运行时可以点击运行到浏览器-》chrome即可打开h5应用页面进行调试
uni-app 通过在package.json
文件中增加uni-app
扩展节点,可实现自定义条件编译平台。
扩展新的平台后,有3点影响:
- 可以在代码里编写自定义的条件编译,为这个新平台编写专用代码
- 运行时可以执行面向新平台的编译运行
- 发行时可以执行面向新平台的编译发行
注意只能扩展web和小程序平台,不能扩展app打包。并且扩展小程序平台时只能基于指定的基准平台扩展子平台,不能扩展基准平台。基准平台详见下文。
package.json扩展配置用法:
{
/**
* package.json其它原有配置
* 拷贝代码后请去掉注释!
*/
"uni-app": {// 扩展配置
"scripts": {
"custom-platform": { //自定义编译平台配置,可通过cli方式调用
"title":"自定义扩展名称", // 在HBuilderX中会显示在 运行/发行 菜单中
"browser":"", //运行到的目标浏览器,仅当UNI_PLATFORM为h5时有效
"env": {//环境变量
"UNI_PLATFORM": "", //基准平台
"MY_TEST": "", // ... 其他自定义环境变量
},
"define": { //自定义条件编译
"CUSTOM-CONST": true //自定义条件编译常量,建议为大写
}
}
}
}
}
Tips:
UNI_PLATFORM
仅支持填写uni-app
默认支持的基准平台,目前仅限如下枚举值:h5
、mp-weixin
、mp-alipay
、mp-baidu
、mp-toutiao
、mp-qq
browser
仅在UNI_PLATFORM
为h5
时有效,目前仅限如下枚举值:chrome
、firefox
、ie
、edge
、safari
、hbuilderx
package.json
文件中不允许出现注释,否则扩展配置无效vue-cli
需更新到最新版,HBuilderX需升级到 2.1.6+ 版本
package.json用法:如果没有package.json
,通过命令npm init -y
创建。
删除package.json
初始化配置 ; 直接复制底下代码
"uni-app" : {
"scripts" : {
"dev" : {
"title" : "dev",
"env" : {
"UNI_PLATFORM" : "h5",
"VITE_BASE_API":"http://x.x.x.x:xxxx",
"VUE_APP_UPMS_ADMIN":"MS-UPMS-ADMIN",
"VUE_APP_CALLOUT":"MS-CALLOUT"
}
},
"build:test" : {
"title" : "build:test",
"env" : {
"UNI_PLATFORM" : "h5",
"VITE_BASE_API":"http://x.x.x.x:xxxx",
"VUE_APP_UPMS_ADMIN":"MS-UPMS-ADMIN",
"VUE_APP_CALLOUT":"MS-CALLOUT"
}
},
"build:pro" : {
"title" : "build:pro",
"env" : {
"UNI_PLATFORM" : "h5",
"VITE_BASE_API":"http://x.x.x.x:xxxx",
"VUE_APP_UPMS_ADMIN":"ms-upms-admin",
"VUE_APP_CALLOUT":"ms-callout"
}
}
}
}
运行如图:
四、打包发布H5
1、打开manifest.json文件配置H5
注意如果为./相对路径,一定要设置路由模式为hash模式
2、配置完H5后点击发行,选择自定义发行-》build:pro
填写名称和域名,点击发行
项目中会生成打包文件,但是本地运行不起来
打包完成后如果想在本地预览,需要在该项目的终端全局安装 npm install http-server -g
然后执行http-server,成功后使用下方地址进行访问