释放 | Releasing (Guides: Development) – Electron 中文开发手册
释放 | Releasing (Guides: Development) - Electron 中文开发手册
本文档描述了发布新版本Electron的过程。
创建一个临时分支
从中创建一个新分支master。命名它release或任何你喜欢的。注意：如果要创建一个补丁包发布，你看看1-6-x，1-7-x等来代替master。
git checkout master git pull git checkout -b release
创建此分支是为了防止任何合并的PR在创建临时发布分支和CI构建完成之间潜入发布的预防措施。
检查现存的草稿
上传脚本查找现有的草稿版本。为防止您的新版本打破现有草稿，请检查发布页面并确保没有草稿。
碰撞版本
运行该bump-version脚本，传递major，minor或patch作为参数：
npm run bump-version -- patch git push origin HEAD
这将增加几个文件中的版本号。见这次碰撞举个例子。大多数发布会是patch水平的。升级到Chrome或其他主要更改应该使用minor。欲了解更多信息，请参阅电子版本。
等待构建
脚本Bump创建的提交消息中出现的单词bump-version将触发发布过程。要监视构建过程，请参阅以下页面：适用于Mac和Windows的208.52.191.140:8080/view/All/buildsjenkins.githubapp.com/label/chromium/用于Linux
编译发行说明
编写发行说明是在构建运行时保持自己繁忙的好方法。有关现有技术，请参阅发布页面上的现有版本。小贴士：每个列出的项目都应该引用关于电子/电子的PR，而不是一个问题，也不是像libcc那样的其他回购的PR。在引用PR时不需要使用链接标记。类似的字符串#123会自动转换为github.com上的链接。要在每个Electron版本中查看Chromium，V8和Node的版本，请访问atom.io/download/electron/index.json。
修补程序发布
对于patch发行版，请使用以下格式：
## Bug Fixes * Fixed a cross-platform thing. #123 ### Linux * Fixed a Linux thing. #123 ### macOS * Fixed a macOS thing. #123 ### Windows * Fixed a Windows thing. #1234 ## API Changes * Changed a thing. #123 ### Linux * Changed a Linux thing. #123 ### macOS * Changed a macOS thing. #123 ### Windows * Changed a Windows thing. #123
次要版本
对于minor发行版（通常是Chromium更新，也可能是节点更新），例如1.8.0，使用以下格式：
**Note:** This is a beta release. This is the first release running on upgraded versions of Chrome/Node.js/V8 and most likely will have have some instability and/or regressions. Please file new issues for any bugs you find in it. This release is published to [npm](https://www.npmjs.com/package/electron) under the `beta` tag and can be installed via `npm install electron@beta`. ## Upgrades - Upgraded from Chrome `oldVersion` to `newVersion`. #123 - Upgraded from Node `oldVersion` to `newVersion`. #123 - Upgraded from v8 `oldVersion` to `newVersion`. #9116 ## Other Changes - Some other change. #123
编辑发布稿
访问发布页面，您将看到带有占位符发行说明的新版草稿版本。编辑发行版并添加发行说明。确保prerelease复选框被选中。对于电子版本> = 1.7，这应该会自动发生点击“保存草稿”。不要点击“发布版本！ 在继续之前等待所有构建通过。
合并临时分支
将临时合并回主，而不创建合并提交：
git merge release master --no-commit git push origin master
如果失败，则通过master和rebuild重新绑定：
git pull git checkout release git rebase master git push origin HEAD
运行本地调试版本
运行本地调试版本来验证您是否实际构建了您想要的版本。有时候，你认为你正在为新版本做一个发布，但实际上并不是。
npm run build npm start
确认窗口正在显示当前更新的版本。
设置环境变量
您需要设置以下环境变量才能发布发布。向另一位团队成员索取这些凭据。ELECTRON_S3_BUCKETELECTRON_S3_ACCESS_KEYELECTRON_S3_SECRET_KEYELECTRON_GITHUB_TOKEN-具有“回购”范围的个人访问令牌。你只需要做一次。
发布该版本
该脚本将下载二进制文件并生成Node-gyp在Windows上使用的节点头文件和.lib链接程序，以构建本机模块。
npm run release
注意：许多Python发行版仍旧附带旧的HTTPS证书。你可能会看到一个InsecureRequestWarning，但它可以忽略不计。
删除临时分支
git checkout master git branch -D release # delete local branch git push origin :release # delete remote branch
在npm上推广发布
新版本以beta标签发布到npm 。除非有充分的理由，否则每个版本最终都应该升级到稳定版本。通常在晋升前两周左右发布新闻。在推广发布之前，请检查是否存在针对该版本的任何错误报告，例如标有的问题version/1.7.x。向Slack的用户询问他们是否正在成功使用测试版本也不错。在任何特定时间查看测试版和稳定版：
$ npm dist-tag ls electron beta: 1.7.5 latest: 1.6.11
将beta版推广到stable（又名latest）：
npm dist-tag add electron@1.2.3 latest
