管理 Giee 的一些前端相关的仓库
发行版生成工具
Gitee 全站最「渣」仓库,帅到掉渣
码云前端组件库
本文档为码云前端规范文档,覆盖所有码云前端项目,旨在提高前端项目的团队协作效率和可维护性。
在开发新页面或新功能前,应该根据复杂度、扩展性、用途等因素规划仓库,然后在码云前端组名下新建仓库并在新仓库中进行开发。从零开始搭建一个前端项目比较麻烦,你可以基于Vue 仓库模板来搭建项目。
目标仓库:
# 克隆本仓库
git clone git@gitee.com:gitee-frontend/目标仓库.git
# 进入仓库目录
cd 目标仓库名
# 安装依赖
npm install
# 将当前仓库链接到全局 node_modules 目录里
npm link
# 开始构建资源(development 模式)
npm run dev
主仓库:
# 将全局 node_modules 目录中的目标仓库链接链接到当前 node_moudles 目录中
npm link 目标仓库
# 构建资源(development 模式),以将目标仓库的资源复制到主仓库中
npm run dev:main
如果项目已提供 dev-server 支持,则只需在这个项目中运行 deve-server,然后将主仓库的 config.webpack.dev_server.enabled
配置项改为 true
并重启服务器即可。
如果需要将项目作为依赖包发布到 npm 包源,则需要满足以下条件:
npm login
命令登录了这个账号之后在命令行中运行:
# 创建 beta 预发行版
npm run release-beta
# 发布测试版
npm publish --tag=beta
# 创建正式发行版
npm run release
# 发布正式版
npm publish
主仓库:
# 安装刚刚发布的测试版
npm install 目标包@beta
# 或者安装最新正式版
npm install 目标包@latest
私有包的构建产物托管在 git 仓库中,发布就是把本地构建好资源推送到远程 gt 仓库。
# 更新版本号,构建资源
npm version 版本号 -m "chore(release): 版本号"
# 发布
git push origin master --tags
主仓库使用以下命令安装:
npm install git+https://账号:密码@gitee.com/gitee-frontend/目标仓库名.git#v版本号
为什么需要编码规范?有什么意义?按自己的风格来写代码不爽吗?这种问题请自行搜索查阅相关资料。
遵循码云前端的 ESLint 即可。
在遵循 stylelint 的要求的前提下,还需要遵循以下规范:
遵循 commitlint 的规范。该规范下的提交信息适合生成更新日志。
1.x.x-beta.x
,如果当天有多次更新,则应该只递增 beta 后面的编号如果此次改动较大,需要花较多的时间测试,或依赖主仓库的后端新功能以及相关样式文件,必须与后端一同更新上线,则根据包的可见性,将下面对应的流程插入到第 2 步后。
公开包使用 npm 包源,使用 npm publish
发版。
npm version 版本号 -m "chore(release): 版本号
发布 PR 专属版,格式为:当前主版本-pr编号.子版本
,例如:0.1.0-pr5.0
npm publish --tag=pr
命令发布该版本到 npm 包源npm version
生成的提交0.1.0-pr5.0
,递增后则为 0.1.0-pr5.1
私有包使用 git 仓库托管,使用 git tag v版本号
和 git push
发版。
npm version 版本号 -m "chore(release): 版本号
发布 PR 专属版,格式为:当前主版本-pr编号.子版本
,例如:0.1.0-pr5.0
npm install "git+https://账号:密码@gitee.com/gitee-frontend/仓库名.git#v版本号"
npm version
生成的提交0.1.0-pr5.0
,递增后则为 0.1.0-pr5.1