1、安装
1-1、微信开发者工具
安装最新版本的微信开发者工具(稳定版),是一个exe文件(例如:wechat_devtools_1.03.2010240_x64.exe),初次点进去的时候可能还显示要下载,关掉它一直重启,直至显示“下一步”安装。
记住安装的地址,或者安装完成后,右键“微信开发者工具” ,点击打开文件所在位置即可。
安装完成后,将服务端口打开,否则在启动项目时会提示端口关闭。
设置/安全设置
1-2、HBuilder X
安装最新版本的HBuilder X,通常都是window App开发版。
- 安装完成后,点击运行/运行到小程序模拟器/运行设置。
- 弹出Settings.json文件,选择微信开发者工具安装的地址。
- 配置浏览器的地址,点击运行/运行浏览器/配置web服务器,这个是浏览器exe文件,而不是所在文件夹。
1-3、uni-app环境配置
npm install -g @vue/cli // 安装vue/cli脚手架
2、创建并运行项目
2-1、新建
打开HBuilder X,点击文件/新建/项目
2-2、运行项目
- 浏览器:运行/运行到浏览器/chrome或Firefox
经常提示“浏览器不支持此种类型文件”,有三种原因:
1、没有安装插件:右键以管理员身份运行HBuilder X,点击工具/插件安装,安装以下三个插件后再次重启项目(可能还是会提示“不支持此类文件”,多重启几次)。
2、当前打开的项目并不是根目录,例如打开的是dom,但是project的位置其实是dom/project。
3、根目录是项目根目录,但未展开,如下图
此时就表示启动成功
- 微信开发者工具
点击运行 / 运行到小程序模拟器/微信开发者工具,
报红,但其实微信开发者工具已经启动了,
点击导入按钮,进入到新建的项目目录下的\unpackage\dist\dev\mp-weixin,注意有时候没有\unpackage这层目录,最后点导入即可。 - 运行到手机或模拟器(部分图片来源于网络)
- 使用USB连接电脑与手机,手机提示“正在通过USB充电”,选择MTP模式;
- 打开手机系统,找到“关于手机”/“我的设备”,找到手机版本号,连续快速点击4次以上,会有提示“已经进入开发者模式”;
- 搜索开启开发者选项,分别开启USB调试、USB安装
- 运行到手机或模拟器/运行…,启动终端
- 终端提示“有的手机需要手动安装android_base.apk”程序,打开终端给的链接,将android_base.apk文件发送到手机上,手动安装即可,安装完成后手机上会出现HBuilder X程序,开启它。
- 那么HBuilder X终端会自动刷新,并识别手机中的HBuilder X,如若终端没有刷新,重启即可。
3、打包
- 打开项目文件中的 manifest.json -> H5配置 -> 设置好对应的页面标题、路由模式,注意是否开启https协议;
①基础路径会影响到 引入的静态文件地址
②若使用的域名没有不是https,则取消勾选“启用https协议” - 选择 发行 -> 网站PC web或手机H5 -> 网站域名即发布到线上的域名,注意这里的http和 manifest.json中的【是否开启https协议】要一致
如果是微信小程序,与H5发布差不多,需要配置Appid
打包完成后,Hbuildex会自动打开【开发者工具】,再点击【开发者工具】右上角的发布即可
获取自行用【开发者工具】打开“打包好的文件夹”
打包完成后会生成一个unpackage文件夹,不同端的文件夹名字也各不同
例如H5,微信小程序mp-weixin
- 若打开是一个空白页,是 manifest.json 的运行基础路径改为 ./ 即可,
运行基础路径等同于 webpack.prod.conf.js 中output参数publicPath:’./’;