唯普前端基础代码库

Changelog · Report Bug · Merge Request · 接口文档

仓库地址

• 源码仓库（内网）：http://test.chevip.com:8090/frontend/chevip-fe-utils

安装使用

1、包安装

npm i chevip-fe-utils

yarn add chevip-fe-utils

pnpm add chevip-fe-utils

2、函数调用

import { mileageFormat } from 'chevip-fe-utils';
...
// 里程格式化
const mileage = '12.34';
console.log(mileageFormat(mileage)); // 输出："12.34万公里"

console.log(mileageFormat('-1')); // 输出："仪表盘已损坏"

开发编译

依赖安装

npm i

代码格式化（已配置 VsCode 保存时自动格式化当前文件）

npm run format

语法检测

npm run lint

单元测试

npm run jest

生成接口文档

npm run docs

编译 TS 文件，生成的 JS 文件会被放到 dist 目录下

npm run build

核心操作

自动化测试（格式化代码+lint）+单元测试

npm test

构建项目（自动化测试 + 编译 TS + 生成接口文档）

npm run release

生成接口文档

npm run docs

NPM 包发布新版本

按照协定，新包发布都使用 release 分支进行！

开始请，请先把代码合并到 release 分支，并切换到 release 分支后再进行以下操作！

步骤1：发布前保证

# 保证所有测试用例都通过且无报错
npm run release

步骤2：npm publish

1. 修改版本号：package.json（版本号遵循 semver 语义化版本号 规范）
2. 生成历史记录：git changelog（如果报错说这个命令不存在，需要先安装插件 git-extras）
3. NPM 新包发布: npm publish（如果是第一次发布，可能需要先登录 npm）

步骤3：代码提交、打 Tag

# release 分支代码更新提交并打 Tag
git release x.y.z

最后一步：代码归档到 main 分支

一切都完成后，请别忘记把 release 分支合并到 main 分支，建议通过 MR 进行合并。

接口文档部署

文档配置在测试环境中，只有内网可以查看。目前代码仓库已配置 CI/CD 自动化部署，只需 Push 到 release 分支即可。