释放 | Releasing
Releasing
本文档描述了发布新版本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/builds
编译发行说明
编写发行说明是在构建运行时保持自己繁忙的好方法。有关现有技术，请参阅发布页面上的现有版本。
小贴士：
- 每个列出的项目都应该引用关于电子/电子的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_BUCKET
ELECTRON_S3_ACCESS_KEY
ELECTRON_S3_SECRET_KEY
ELECTRON_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
