Workflows for creator team.

• Mac:

  Install nvm.
  Install Node.js® via nvm:

   nvm install node

  And then in any new shell just use the installed version:

   nvm use node

• Windows:

  Install Node.js®.

cd path/to/repo
npm install

Open package.json and check "workflows_settings" for default settings. If you need, place your settings in settings.js to overwrite the default settings. See settings.js.sample for details.

Deploy Product

该命令会将文件上传到 FTP

npm run upload -- path/to/file --dest TestBuilds/xxx.zip --user Admin --password 123456 --host 127.0.0.1

如果希望在上传前先从 FTP 移除和目标文件版本号相同，只是补丁版本不同的相同文件，可以在最后加上一个参数 --archieve-same-version

npm run upload -- ....  --archieve-same-version

这样一来相关文件就会被移动到 ../Histroy 目录中。

Download

该命令会将文件下载到指定位置，并且解压

npm run download -- --url https://github.com/cocos-creator/hello-world/archive/v1.10.zip --dir ./test

Tag Local

npm run tag-local

此命令将会根据 fireball 下的 package.json 中的 version，自动给所有依赖的 repo（含 cocos2d-x-lite）打上 tag，并且推送到 cocos-creator 远端仓库。

npm run tag-local -- --path path/to/repo

此命令将会根据指定路径下的 package.json 中的 version 来打 tag，并且推送到 cocos-creator 远端仓库。如果是 fireball 仓库，还会同步依赖的 repo（不含 cocos2d-x-lite）。

以下命令全程操作都通过 GitHub API 远程进行，不会影响到本地 git 仓库。所有操作会批量在 fireball 主仓库、2d-x 仓库和 22 个子仓库中进行。

New Branch

该命令会在所有仓库中创建新分支

npm run new-branch -- oldBranchOrTag newBranch

步骤如下

• 遍历所有仓库
  • 创建新分支
• 更新 package.json 中的依赖分支并且提交到主仓库的新分支上

List PR

npm run list-pr

该命令会显示所有 GitHub 上需要合并的 PR。结果将在浏览器中显示。

npm run list-pr -- -s semver

该命令接受一个 semver 作为分支名，如 2.x。

npm run list-pr -- branch1 [...branch2]

该命令可以输入任意多个分支，最后一个分支将用于解析依赖的仓库。

Clean Issue

npm run clean-issue

该命令会列出所有可以关闭的 Issue，结果将在浏览器中打开。判断规则如下：

• 如果有未合并的 PR 关联到 issue 上，则不可关闭
• 如果有提交或者已合并的 PR 关联到 issue 上，则可关闭

Sync Branch

npm run sync-branch [...repos]

该命令会自动同步所有 GitHub 上的所有开发分支（按版本顺序依次合并改动），需要同步的仓库将从 fireball 最新若干个分支中的 package.json 收集而来。

• repos 允许指定只同步哪些仓库。以空格隔开，如 npm run sync-branch fireball engine

Merge Branch

npm run merge-branch -- -b baseBranch -h headBranch

该命令会合并所有仓库中的指定分支。

Delete Branch

npm run delete-branch -- branch [subsequentBranch] [--df] [--du]

该命令会删除 GitHub 仓库上的指定分支，需要同步的仓库将从 fireball 最新若干个分支中的 package.json 收集而来。

• '--df' 命令用于强制删除功能分支
• '--du' 命令用于强制删除未合并的分支

分支删除后，将会打上 tag 用于标记位置。如果该分支有未合并的 PR，会将 PR 的目标分支修改为 subsequentBranch，未指定 subsequentBranch 将终止合并。

Changelog

npm run changelog -- branch [fromTime|fromVersion] [-t (toTime|toVersion)]
npm run changelog -- branch [fromTime|fromVersion] [-r [recordVersion]]

该命令会以 PR 为单位收集改动列表，结果将在浏览器中打开。

• 'branch' 表示版本发布所用分支，所有更早的版本分支上的 PR 也会一同收集。不对分支是否已合并进行检查。
• 'fromTime' 参数指定起始时间，如 2019-04-01T00:00:00。
• 'fromVersion' 参数指定起始版本，将通过版本号（如 2.0.0-alpha.1）来获取指定版本的时间。
• 'toTime' 参数指定结束时间，如果省略则使用当前时间。
• 'toVersion' 参数指定结束版本号，如果省略则使用当前时间。
• 'recordVersion' 参数指定需要保存的版本号，会将当前时间记录到指定版本号，以便后续用于 fromVersion 或 toVersion。当参数省略，将根据 fromVersion 自动 + 1。

如果省略 fromTime 和 fromVersion，将使用匹配此 branch 的上一次版本时间记录。如果找不到匹配此 branch 的版本记录，将收集此 branch 上的所有 PR。

npm run changelog -- -r recordVersion

该命令不会收集改动列表，仅用于记录版本号对应的时间

Tag Version

npm run tag tagName branch [repo]

此命令用于给所有仓库打上 tag。

• 如果 tagName 是一个 semver，并且以 "-xxx" 结尾，则 "-xxx" 将统一替换为 "-dev"，并且清除除了最新 5 个版本以外的所有以 "-dev" 结尾的 semver 的 tag。
• branch 用于指定当前要在哪个分支上创建 tag。
• 如果指定 repo，将只会给该 repo 更新 tag。repo 的格式为 "owner/name"，如 "cocos-creator/cocos2d-x-lite"。

5D

npm run list-5d-pr -- command tag

用于列举 2D、3D 合并需要迁移的 PR，将判断主版本到指定 tag 之间的差异，调用前需要更新主版本到最新。 对于 fireball 仓库，会以 fireball 的 tag 为起始时间，对于其它仓库则以 engine 仓库。 该命令会以 PR 为单位收集改动列表，结果将保存到本地。具体命令请参考源码。