功能说明
版本与发布
这是什么
版本是攒在一起发出去的一批改动,比如 0.5.0。
在 QU 里,一个版本就是「一组任务 + 一份单独攒改动的代码」:
- 任务归进某一版,验收后先合进这一版自己的那份代码(叫版本分支),不提前混进正式代码(主线)。
- 每件活交的时候顺手写一句更新日志(中英各一句),版本页里自动攒成这一版的更新日志草稿。
- 你说一句「发 0.5.0」,QU 把这一版合进主线,建好发版任务,交给能发版的那台电脑去做。
什么时候用
- App 这类要打包发布的:攒一版再发,用版本。
- 网站、后端这类改完就能上线的:不用攒,每件验收就上线。在「项目设置 › 规矩」里开着「改完就上线」就行(没设过默认是开的)。
怎么用
版本页
左栏「任务看板」下面一行「版本」,右边写最早那一版还差几件。点进去,每个还没发的版本一栏:
- 栏头一句现状:「还差 3 件」「做完了 · 等发版」;
- 一条进度条:做完 / 已验收等合 / 等你验收 / 在做 / 没开工;
- 属于它的所有任务,每件一句现状;
- 这一版的更新日志草稿。
最右边是已发出的版本,点开能看当时有哪些任务、发出时的更新日志。
看板上「版本 ▾」能只看某一版的任务。
建一版、把任务归进去
- 版本页点「新建版本」,版本号自动按上一版加一;或跟小去说「建一版 0.5.0」。
- 一个任务只归一版:在任务详情「版本」那行选,或在版本页「挂任务进来」。子任务跟着父任务走。
- 归哪一版只听你的,系统不会自己挪。
建议给每一版单开一个话题,这一版的事都在里面说,见 最佳实践。
版本分支
版本分支是这一版单独攒改动的那份代码。
- 要开,在版本页点开这一版「⋯ → 开版本分支」;或者等验收了的活攒起来,小去在「等你处理」里问「给 0.5.0 开版本分支?」,你点「开」。
- 开了以后,这一版的任务验收后先合进版本分支。前一步一交验收,后面等它的活就能接着做,不卡在等你验收上。
- 几版同时做也不串:后面那一版先验收的,标「已验收 · 等合」,等前一版发出去再合进主线。
- 在哪台电脑上做都接得上。
更新日志草稿
- 会话交验收时写一句给用户看的话,中英各一句。
- 按任务类型自动分到「新增 / 改进 / 修复」。
- 会话忘了写的,小去补一句,标黄「小去补的,看一眼」。
- 每句标着是会话写的、小去补的、还是你改的。版本页里能复制、能改。
- 文档、走查、调研这类用户感觉不到的,不写进去。
发版
- 都做完了,版本页显示「可以发了」。
- 跟小去说「发 0.5.0」。QU 先把版本分支合进主线;合上了,自动建一件发版任务交出去,带上这一版的更新日志草稿。
- 也可以在版本页点「发出 0.5.0」:它只建好发版任务,等你交出去才开始。
- 发版任务只交给勾了「能签名发版」的那台电脑(「电脑」页每台的菜单里勾)。一台都用不了就不交,在「等你处理」里问你。
- 发完点「已发版」收尾,能撤;还有没做完的任务,一键挪到下一版。
发版前,看板、任务详情、版本页都能看到合进主线走到哪一步;也能问小去「这版合到哪了」。
只想合进主线、先不发:在「⋯」里选只合不发。
合并时的几道保险
- 交验收前先试合,合不上当场让会话解掉,见 原型与验收。
- 版本合回主线有冲突、原来的会话已经不在了,QU 另开会话来解,发版不卡着等人。
- 项目目录有别的会话或部署在用,先排着,空出来再合。
- 几台电脑改同一个仓库,远端被抢先推了就拉下来重合;有冲突交回会话,从不强推(不会用自己的版本盖掉别人的)。
- 一版的任务都做完、合完,远端的任务分支自动清掉。
常见问题
验收完会不会自动发版? 不会。只有你说发的时候才开始。小去替你发版,要引用你亲手打的那句话。
发版要在哪台电脑上? 勾了「能签名发版」的那台。钥匙串里有 Developer ID 证书的电脑第一次连上时会自动勾上,之后只按你勾的来。
网站项目也要建版本吗? 不用。开着「改完就上线」,每件验收合进主线就算上线了。
能同时做两个版本吗? 能。各开各的版本分支,后面那版等前面那版发了再合进主线。两版改同一块代码时还是会冲突,见 最佳实践。