@tuya-sat/create-micro-app

Saturn - Create Micro App

通过命令行快速生成用于SaaS开发框架开发的微应用模板
土星项目 · 报告问题 · 提交需求

关于 Create-Mirco-App

create-micro-app 是一款通过命令行快速生成微应用模板工具

• 支持生成 react、react-ts、vue、vue-ts 相对应的模板
• 包含布局权限、国际化、组件使用、mock 数据，图片引用等常用功能
• 开箱即用 运行yarn start就可以直接快速预览微应用 Demo
• 支持本地代理，yarn start:proxy就可以代理到域名，运行 SaaS 服务
• 基于 webpack 打包，并可在其中添加个性化配置

关于微应用

• 微应用是 SaaS 开发框架引入的一个概念， 是 SaaS 应用的业务组件
• 详细介绍请看这里

快速开始

安装准备

NodeJs 要求最低版本为v14.0.0

模板命令

默认生成 react 模板

npx @tuya-sat/create-micro-app@latest app

生成 react-ts 模板

npx @tuya-sat/create-micro-app@latest app -t react-ts

生成 vue 模板

npx @tuya-sat/create-micro-app@latest app -t vue

生成 vue-ts 模板

npx @tuya-sat/create-micro-app@latest app -t vue-ts

生成主应用模板

npx @tuya-sat/create-micro-app@latest app -t main

命令

本地开发

配置 mock 数据

字段	类型	备注
mock	boolean	控制整体接口是否开启 mock
api	Api[]	存放所有的 mock 接口

Api

字段	类型	备注
path	string	请求路径
method	HTTP request methods	http 的请求方式
res	Object	返回参数,此处数据结构为开发者自己定义,请求对应接口就返回 res 内所有内容
mock	boolean	控制此接口是否开启 mock

启动项目

yarn start

本地代理 需要配置micro.config.js

yarn statr:proxy

本地代理配置

/** @typedef {import("@tuya-sat/micro-dev-proxy").Config} DebuggerConfig */
/** @typedef {import("@tuya-sat/micro-script/dist/config/webpack.config").WebpackCombineFunction} WebpackCombineFunction */

module.exports = {
  /**@type {DebuggerConfig} */
  debuggerConfig: {
    target: 'xxx', // 需要代理的协议+host
    username: 'xxxx', // 对应域名的超级管理员账户名
    password: 'xxx', //  超级管理员密码
    logSign: true, // 打印请求头
  },
  /**@type {WebpackCombineFunction} */
  webpack(config, { isDev, isBuild }) {
    config.output.publicPath = isDev ? '/' : '.';
    return config;
  },
};

微应用打包

yarn build

扩展命令

命令	简写	类型	默认值	含义
--run	-r	boolean|'norun'	false	值为 norun 时，不安装依赖。值为 true 时，不显示依赖安装过程
--dir	-d	boolean	false	值为 true 时，在当前目录安装
--yes	-y	boolean	false	值为 true 时，使用默认配置安装

联系我们

欢迎在https://github.com/tuya-sat/discuss/issues向我们提交反馈

资源工具

• @tuya-sat/components
• @tuya-sat/sdf-cli
• @tuya-sat/micro-script

License

MIT