释放 | 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

• jenkins.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

编辑发布稿

1. 访问发布页面，您将看到带有占位符发行说明的新版草稿版本。

1. 编辑发行版并添加发行说明。

1. 确保prerelease复选框被选中。对于电子版本> = 1.7，这应该会自动发生

1. 点击“保存草稿”。不要点击“发布版本！

1. 在继续之前等待所有构建通过。

合并临时分支

将临时合并回主，而不创建合并提交：

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