miniapps

小程序项目脚手架工具

如何安装

npm i miniapps -g

依赖: Node.js and Git.

功能

miniapp -h

她的贴心之处：

针对新手：

1、自动根据当前开发设备，一个命令即可下载开发者工具 2、在你需要查看官方 API 文档的时候，也只要一个命令即可打开浏览器直接打开对应页面

针对现有的开发开发语言的集成：

1、可以自主地选择创建什么类型的项目，也会自动编译成小程序的特有语法和文件后缀

创建小程序项目

执行 init 命令后，可以看到 目录中生成 src 和 dist 两个文件夹，其中 src 为源码目录，dist目录为编译 src 后生成的目录。dist 目录可用来在小程序开发者工具中打开。

$ miniapp init <project-name>

Example:

$ miniapp init miniapp-demo

编译

首先，先进入执行初始化命令时指定的目录，然后执行 miniapp build 对 src目录内的文件进行编译。miniapp 会根据文件后缀自动进行相应编译，目前支持 sass -> wxss，stylus-wxss，ES6 -> ES5 的编译，编译后的文件在 dist 目录中。

$ cd miniapp-demo
$ miniapp build

监视文件改动

--watch，-w 选项可以让我们在文件发生改动时自动重新编译。

$ cd miniapp-demo
$ miniapp build -w

快速生成 page 目录:

该命令可以快速生成符合微信小程序官方规范的目录结构，并且将新页面自动注册到 app.json 文件中

$ miniapp gen <page_name>

示例:

$ cd miniapp-demo
$ miniapp gen auth

以上命令执行后会自动在 src/pages 和 dist/pages 目录中生成 auth 文件夹：

 └─┬ src
      ├─┬ pages          
      │ ├── auth                
      │ │ ├── auth.js
      │ │ ├── auth.json
      │ │ ├── auth.wxml
      │ │ ├── auth.sass
      ...
 └─┬ dist
      ├─┬ pages          
      │ ├── auth                
      │ │ ├── auth.js
      │ │ ├── auth.json
      │ │ ├── auth.wxml
      │ │ ├── auth.wxss
      ...

安装组件:

除了使用 miniapp gen 来快速生成 page 结构，我们还可以使用 miniapp install 来从 git 安装指定页面，目前所有模块都将在 https://github.com/miniapps-team/ 该项目下获取。

$ miniapp i <widget_name>

示例:

$ cd miniapp-demo
$ miniapp i login

以上命令执行后，会依次执行以下步骤：

1. 从 repo https://github.com/miniapps-team/minapp-widget-login.git 下载。
2. 拷贝 minapp-widget-login repo 中的组件到 src/pages 和 dist/pages 下。

打开 API 文档:

该命令可以通过默认浏览器打开微信小程序官方开发文档页面，方便开发者进行相关 API 查询。

$ miniapp doc 

自动安装开发者工具:

该命令可以通过默认浏览器自动根据系统类型下载对应的微信小程序开发者工具

$ miniapp tool 

FAQ

1、可以自定义组件下载地址吗?

可以，自己配置即可，比如我们默认的，执行：

miniapp i https://github.com/miniapps-team/minapp-widget-login

在 pages 下面会自动出现一个 login 文件夹，而且自动添加到 app.json

2、针对已经有的项目呢？

目前我们依赖 miniapp init 出来的目录源目录和编译后的目标目录，但是我们做了优化：

miniapp gen 会自动判断项目目录结构

3、遇到问题？

欢迎提交 issue

TODO

对老的项目如何兼容工具目录结构（无 src 类）

License

MIT