wap-cli
小程序 命令行工具
缘由:
github 上 labrador 和 wepy ,两个框架已经对小程序的开发已经封装得非常优雅了,并且支持NPM 包、优化小程序API、有状态管理。
但我个人实在不太想除了小程序的API之外,再去了解一套框架的API 了。
我的需求很简单:
- 统一代码风格
- 编译前检查可能存在的错误
- 样式文件可使用变量
- 样式文件引用的图片可自动base64化
- 可配置忽略一些文件,不交给开发者工具打包
所以自己实现了这么一套,因为还是自用,可配置的东西不多。需要更高的自定义化,推荐使用上面两个库,或者自己fork
一份修改吧。
作用:
- 创建小程序项目
- 新建小程序页面
开发流程
- 使用
npm install wap-cli -g
全局安装wap命令行工具
wap create 你的项目名称
创建项目npm run dev
进入开发模式- 使用IDE 打开代码,使用
微信开发者工具
打开dist
目录,查看效果- 在
微信开发者工具
的设置
-编辑器
中勾选文件保存时自动编译小程序
,可实现自动刷新。注意:其它选项请不要勾选!!!
- 在
- 开发过程中可使用
wap g 你的页面
新建页面,在新建的文件中编写你的代码,保持即可看到效果- 因为小程序每个页面需要4个文件,分别是
.js
,.json
,.wxml
,.wxss
文件,直接使用wap g my/index
命令,将会在pages
文件夹在生成my
文件夹,并生成index.js
,index.json
,index.wxml
,index.less
文件;并且会在app.json
的pages
自动添加文件路径。
- 因为小程序每个页面需要4个文件,分别是
- 开发完成,使用
npm run build
进行打包npm run build
与npm run dev
的区别在于,build
命令会压缩代码量
微信开发者工具
项目初始化后用 IDE打开项目根目录。
安装完依赖后使用 npm run dev
,然后打开微信web开发者工具
新建项目,本地开发目录选择 dist
目标目录。
请务必先进行 npm run dev
命令后再打开微信开发者工具
。
注意事项:
微信开发者工具
中项目
栏取消勾选开启ES6 转ES5
、开启代码压缩上传
,因为wap
都做了这些事件,让微信开发者工具
重复操作可能会导致不可预知的错误!!- 不要直接修改
dist
目录下代码,因为每一次修改代码wap
都会修改dist
目录下的文件,在dist
目录下修改的代码会被重置。 微信开发者工具
的设置-编辑器
中打开文件保存时自动编译小程序
,可实现实时预览。- 开发完成使用
npm run build
命令后,微信开发者工具
可能会报错,这是因为wap
在 执行build
时会删掉整个dist
文件,此时重启微信开发者工具
即可。