Skip to content

Latest commit

 

History

History
80 lines (56 loc) · 2.4 KB

CONTRIBUTING.md

File metadata and controls

80 lines (56 loc) · 2.4 KB

如何开发

1. 项目使用 lerna 管理,所有的大包在 /packages,所有的自定义组件包在 /widgets

2. 如何跑起来(以下操作全在根目录)

# 安装依赖,请使用yarn,会去重的安装所有 node_modules (注意安装必须用 yarn,其他命令无所谓)
yarn
# 首次开发需要 build 一下,否则有些仓库的 import 在 dumi 里会找不到
npm run build
# 将文档网站跑起来
npm start

3. 进入文档网站了,如何开发呢?

  • 例如要开发 form-render 在 /docs/form-render/guide 目录下写一个 test.md 文件, 参考 /docs/form-render/guide/new-feature.md 的写法即可。发布前把 test.md 干掉,或者放到不会被展示的文件目录下

  • 提交前注意必须格式化。提交前注意必须格式化。提交前注意必须格式化。请安装 prettier 插件,或者在提交前执行

npm run prettier

4. 重新安装依赖

# 先清空
npm run clean
# 再安装
yarn

注意 lerna clean 不会清除顶层的 node_modules,所以如果因为特殊原因要彻底清空依赖,请执行 rm -rf node_modules

5. 发布

此操作只针对有 npm 发布权限的贡献,进入相应项目的文件夹,例如 form-render,执行 publish

# 进入
cd packages/form-render
# 换版本号、打tag。注意tag要打,便于release note的维护
yarn version --new-version 1.1.0
# 发布
npm publish

发布后记得到 releases 页 补上最新发布日志

6. 实际装包测试(本地 or 发布 beta 版本)

  • 本地测试

推荐一下 yalc。是一个完全可以当做 yarn 来使用,但是发包和装包都在本地的工具,个人调试强烈推荐

  • 发 beta 包

beta 版本的版本号规范为 x.x.x-beta.x,一般用于大功能上线前的真实测试,不会被正常 npm i 安装。 进入 package/form-render 文件夹,执行

# 换版本号、打tag。注意tag要打,便于release note的维护
yarn version --new-version 1.1.0-beta.0
# 发布
npm run beta

7. 分支管理

外部同学请 fork,内部同学请在 dev 分支开发,然后都发 pull-request 到 master 分支,由负责同学审核后合并,master 分支请勿人为去动

8. 如何检验一个 pull request

# ID 为 pr 的 id
git fetch origin pull/ID/head && git checkout FETCH_HEAD