Skip to content
🛠️基于插件机制的小程序编译开发环境,提供多种工具类
JavaScript CSS
Branch: master
Clone or download
Latest commit fbc44af Jul 9, 2018

README.md

weapp-start

NPM version Build Status NPM downloads Dependencies Status code style: prettier

选择 weapp-start 进行开发的主要理由之一就是一切扩展功能全部组件化,可以随意组合,打造合适自己的开发环境

配合状态管理工具 weappx,再复杂的小程序也可以轻松应

小程序早已原生支持组件化开发,体验下来老牌组件化框架在升级过程中非常不顺利,所以选择使用原生语法进行开发,但是同时有很多非常棒的特性,我希望能保留下来,因此有了这个项目

Why

  • 如果你只是开发一款好用的 小程序,单纯使用 小程序官方文档和规范,我建议你可以尝试本项目,它对于原生小程序开发体验有非常棒的提升

  • 如果你熟悉 vue,并且打算使用它们来兼容小程序的开发,那么我推荐你可以尝试 wepy 或者 mpvue,它们也都超赞

  • 如果你熟悉 react,并且准备一处编写,多端适配,那么我推荐你使用 taro

Features

  • 支持 npm 包引入
  • 支持 promise, async/await 等最新语法
  • 支持多种编译器,如 pug/less/stylus
  • 支持 ESlint
  • 支持本地 mock 数据
  • 支持一键生成项目,组件模版
  • 支持发布前资源压缩
  • 支持自定义插件
  • 多种工具,加速开发

Install

npm i weapp-start -g

查看帮助

weapp-start -h
weapp-start <command> [options]

命令:
  weapp-start dev    watch build
  weapp-start build  打包构建
  weapp-start init   生成模版项目
  weapp-start new    生成模板页面
  weapp-start mock   启动本地mock服务

选项:
  -h, --help     显示帮助信息                                             [布尔]
  -v, --version  显示版本号                                               [布尔]

生成开发模版(项目模板都存放在这里,欢迎小伙伴 pr)

weapp-start init

进入生成目录,安装依赖

npm i

启动实时编译

weapp-start dev

使用微信开发者工具新建项目,项目目录选择刚刚生成的文件夹,会自动导入项目配置

Tips

  • weapp-plugin-require 是基于 commonJS 模块规范的静态处理,也就是说 es6 模块定义的话,需要配合 weapp-plugin-babel 插件使用, weapp-plugin-babel 的顺序要在它之前。

  • 小程序里面对于 require('common.js') 是当做相对路径的,而在 node 中是作为模块查找的,因此应该避免这种隐式的相对路径写法,应该用 require('./common.js') 代替;weapp-plugin-require 对二者做了兼容,不过会发出提示信息要求修改路径

  • weapp-plugin-jsmin 只能对 es5 规范的代码进行压缩,将其顺序至于 weapp-plugin-babel 之后

  • 所有压缩功能的插件,如果想对生成的额外文件进行处理,需要指定参数 extra 为 true

  • 因为小程序的特有运行环境,在兼容外部 npm 包,比如 lodash 的时候,需要做一些 hack 操作,替换文本,但是它们更新太频繁了,精力不够,所以请在主项目锁死版本 lodash 版本号 "lodash": "4.17.5"

Plugins

自定义插件文档 coming...

Utils

Links

  • Contribution
  • Updatelog - 查看packages/xxx/CHANGELOG.md

Cases

License

MIT

You can’t perform that action at this time.