1.0.3 • Published 11 months ago

rcli-vue3 v1.0.3

Weekly downloads
-
License
MIT
Repository
github
Last release
11 months ago

rcli-vue3

rcli-vue3 是一个基于 Webpack 的打包工具,它利用插件机制封装了各种 JavaScript 应用的配置,选择和安装合适的插件即可开始构建你的应用。

安装

  • latest 稳定版: [sudo] npm install rcli-vue3 -g

node.js 版本

  • ^12.0.0 || >= 14.0.0

快速开始

  1. 创建目录 mkdir rkit-app && cd rkit-app
  2. 初始化工程 rcli-vue3 init 选择模版
  3. 安装依赖 npm install
  4. 启动服务 npm run dev 初始化结束后,项目中会生成一个名为 rkit.config.js 的配置文件:

hooks

新增 hooks 配置

hooks:{
  brefore: (config) => {},  //编译前钩子
  after: (config) => {} //编译后钩子
}

支持国际化打包

domainList: [{
  domain: `/[/test.xxx.comn`, //域名
  path: 'en', //目录
  isBuild: true // 是否编译
}]
// 生成目录为dist/en/xxxx(版本号)
// 注意:如何domainList存在isBuild为true的选项时会覆盖publicPath打包结果

支持强制 DIFF 流程

  • 请在 rkit.config.js 中配置,例如: projectName: 'easyLoan'
  • 分支生成的 DIFF,必须在 codereview 平台被他人通过才能进行 npm run build
  • npm run build
    • 选择分支可以指定分支 md5 作为版本号
    • 选择部署环境,bate 为线下环境,production 为线上环境

注:老版本中,原有的build/prod.env.js已经废弃,更新 1.2.7 后即可删除

支持同步静态文件

  • 请在 rkit.config.js 中配置,例如: syncHost: '10.1.1.1'
  • 运行rcli-vue3 sync,将会上传到配置的syncHost该主机内,并在控制台返回存储路径

支持同步 SourceMap 到 Sentry

运行 rcli-vue3 sync --sentry将上传并发布 sentry 版本,发布版本为最近一次 npm run build 的版本和环境变量,写入在.sentryVariable 中

在项目中引入 Sentry SDK 可以使用以下环境变量作为标识:

  • process.env.VUE_APP_DEPLOY_ENV :部署环境
  • process.env.VUE_APP_DEPLOY_VESION :当前项目版本号

注:npm run build 将会自动生成.sentryVariable用于存储版本信息,请加入到.gitignore中避免上传到 git 仓库

.sentryVariable

rcli-vue3 build 支持手动传入 branch、envs 字段

配置文件选项 参考

https://cli.vuejs.org/zh/config/#%E5%85%A8%E5%B1%80-cli-%E9%85%8D%E7%BD%AE

命令 rcli-vue3 help

  • init - 初始化项目
  • serve - 启动服务
  • build - 生产环节编译
  • inspect - 生存 webpack 配置
  • lint - 检测代码
  • sync - 上传静态文件和 sourcemap

change log

1.修复 staticPath 文件缺少冒号问题
2.新增 hooks 配置 3.config 文件生成样式文件顺序错乱的问题,新增 pc 模版 4.新增强制 codereview 流程 5.新增上传静态文件到远程主机 6.删除上传 soucemap 到 sentry 服务 7.rcli-vue3 build 流程新增非必传字段--branch--envs 8.rcli-vue3 build 命令的传参--mode,新增 mode 类型为test, 用于线下联调、提测环境打包,区分线上, 上线时打包可以不传或者传production

线下联调、提测使用:
    rcli-vue3 build --mode test

上线使用:
    rcli-vue3 build
    rcli-vue3 build --mode production

9.domainList 配置项修改,新增 businessType 配置,上传不同的仓库 10.支持传入 md5 版本号,直接构建生成该版本号的包文件

命令:rcli-vue3 build [--md5] [--branch] [--envs]
示例:rcli-vue3 build --md5=1bf7979d844af11509554fef7cefdb95 --branch=20230516_test --envs=online
说明:上面的示例是使用分支为20230516_test的代码生成md5版本号为1bf7979d844af11509554fef7cefdb95的包文件