CLI

NpmLicense node (scoped with tag, custom registry) NPM versionCLI 预编译插件 - 图4

为小程序开发定制的命令行工具。以模块化方式处理项目依赖,通过依赖分析得到整个项目的结构,在优化代码后最终生成目标小程序代码。

插件机制上面,采用最新webpack设计的TapableCLI 预编译插件 - 图5插件机制,对于熟悉webpack插件开发的人来说,可以快速上手cli的插件开发。

助力三方开发。对于三方项目而言,往往需要在使用框架的同时再手写脚本,以保证一个项目能编译到多个小程序。2.0在这方便做了改进,利用依赖分析树针对不同合作方输出不同页面,支持一次性将项目编译到出多个小程序,同时支持监听模式下的一对多(可能会内存占用高,慎用)。

独特的依赖分包算法。随着小程序项目的不断迭代,不可避免的体积会越来越大,而分包是唯一解决小程序包大于 2M 的方法。随着而来的问题是如何合理的分配分包和主包的空间,wxa 自研了依赖分包算法,可以将项目依赖合理的分配到分包和主包,最大程度的平衡代码复用和空间分配。

特性

  • 🏄 零配置 标准项目无需任何配置,即可运行。
  • 🚀 依赖分包算法 自研的依赖分包算法,帮助开发者充分的利用分包空间CLI 预编译插件 - 图6
  • 依赖分析 自动分析项目依赖,无需手动 copy 三方依赖到项目中。
  • 🤖 组件库 任意第三方组件库,随时安装使用,完美适配 weui, vant-weapp, wux-weapp, iview-weapp 等组件库。
  • 🖖 Vue单文件 SFC 单文件组件开发,组件和页面可以把js,wxss,wxml,json写在同一个.wxa文件。
  • 🔌 插件机制 利用插件机制,可以定制自己的文件处理流。
  • 💻 编译器 支持ES*, Sass, Stylus 语法。
  • CLI调用 无需打开开发者工具,即可预览、上传代码。✈️
  • 🎯 批量编译 一次性编译出多个小程序或其他平台小程序,高度适用于三方开发或多平台分发场景。

TODO

  • ☑️ 编译到其他小程序平台
  • ☑️ 小程序原生插件开发
  • ☑️ Tree-Shaking

安装

  1. # 使用npm安装
  2. npm i -g @wxa/cli2

提示

@wxa/cli2运行在node环境中,先安装nodeCLI 预编译插件 - 图7

基本用例

  1. 基础编译 wxa2 build

  2. 监听模式 wxa2 build --watch

  3. 指定无效缓存以及打印更详细的构建信息 wxa2 build --no-cache --verbose

  4. 使用模板创建新项目, templateCLI 预编译插件 - 图8 网络环境的关系建议拉取 gitee 源 wxa2 create --repo gitee

  5. 调用微信开发者工具, windows用户需要在 wxa.config.js 设置开发者工具的路径 wechatwebdevtools

    • wxa2 cli -a open: 打开开发者工具
    • wxa2 cli -a preview: 预览项目
    • wxa2 cli -a upload: 上传项目
    • wxa2 cli -a login: 登录微信,previewupload都需要登录微信后操作