渐进式小程序开发框架

wxa.js

wxa 专注于小程序原生开发，在保留小程序简单入门、快速开发的特点下，提供一系列能力，解决工程化、代码复用的痛点，提高开发效率并改善开发体验。

框架优势

🖖 极速上手 无额外的学习门槛，可以完全使用原生的小程序语法开发。

🏄 零配置 标准项目无需任何配置，即可运行。

🐧 全方位 解决小程序开发中的各种痛点，譬如状态管理、表单校验等。

🚀 依赖分包算法 自研的依赖分包算法，帮助开发者充分的利用分包空间。

➰ 依赖分析 自动分析项目依赖，无需手动 copy 三方依赖到项目中。

🤖 组件库 任意第三方组件库，随时安装使用，完美适配 weui, vant-weapp, wux-weapp, iview-weapp 等组件库。

🚈 低成本 超低迁移成本，原生小程序只需安装好依赖就可以马上在 @wxa/cli2 中跑起来。支持原生和 wxa 混杂开发。

👽 多实例 一次性编译出多个三方项目或其他平台的小程序，如头条小程序。

简介

wxa 是一个 AOP 框架，主要使用 Decorator（运行时改写，拦截）和预编译实现框架功能。

使用 Decorator 实现了：

✅ Fetch 队列管理网络请求，单个请求自动防重。

✅ Router 简洁的 API、预加载特性。

✅ Lock 防止重复执行函数，前端防重利器。

✅ Debounnce 防抖动。

✅ Mixin 混合代码，代码复用。

查看详细的 Class Decorators Method Decorators

预编译方面，实现了对小程序项目的依赖解析，利用依赖树对整个项目进行管理，以此为基础适配了npm、单文件开发、云开发、三方开发。开发语法方面支持最新的 ES*语法（包括 Async/Await）、Sass/Scss、Stylus，有需求的话可以适配更多语法。

Install

使用 yarn 或 npm 全局安装

npm i -g @wxa/cli2

Quick Started

极速新建项目

wxa2 create --repo gitee

开始开发

定义 App 类并导出：

import { App } from "@wxa/core";

@App
export default class Main {
  globalData = {
    userInfo: "Genuifx",
  };
}

定义页面类并导出：

// 引入core包提供的Decorator
import { Page, Debounce } from "@wxa/core";

// 挂载常用的方法到页面类
// 导出一个默认的页面类
@Page
export default class Index {
  // 页面方法用于响应用户操作，函数自动防抖动
  @Debounce(300)
  tap() {
    // 通过$storage缓存数据
    this.$storage.set("TAP", true);
  }
}

默认导出的方法将会自动调用小程序相应的 Page、 Component、 App 方法进行注册。

更完善的文档

极速预览小程序

wxa2 cli --action preview

Contribution

欢迎各种 PR 和 ISSUE

LICENSE

MIT

hm-fannie / wxa