如何使用Travis CI来做GitHub的Release自动发布

### 起因
由于GitHub在国内越来越难访问了，甚至于Release都是托管在亚马逊AWS下，访问起来更是问题了，十几KB甚至几KB的速度已经是惯例了，想上传个Release都得上传半天。其实这个上传脚本我很早之前就在用了，近期有空就刚好做成一个傻瓜式自动脚本供给其他的项目用。

### 食用演示

注意，本文不会对`git` `github` `travis-ci` `yaml`等相关知识做过多解释，需要读者有一定的基础。

#### 创建仓库
首先我们新建一个测试演示的空仓库
![](https://storage.liesauer.net/2020/02/3869113721.png)

#### 创建构建脚本
然后新建一个测试用的`.travis.yml`，重点在`deploy`配置
```yaml
language: minimal

deploy:
  provider: script
  script: curl https://raw.githubusercontent.com/liesauer/github-release-cli/master/scripts/github-auto-release.sh -L --output github-auto-release.sh && chmod +x github-auto-release.sh && bash ./github-auto-release.sh
  on:
    all_branches: true
    tags: true

```
![](https://storage.liesauer.net/2020/02/2642893879.png)

然后我们进去travis-ci.com看一下，根据构建日志提示，我们发现`deploy`并没有被触发，这是因为我们的`deploy`条件是必需发布了`tag`才有效。
![](https://storage.liesauer.net/2020/02/3165669387.png)

#### 发布TAG
我们给仓库加一个`tag`再试试
![](https://storage.liesauer.net/2020/02/1573228587.png)

然而我们可以发现构建失败了，这是怎么回事呢
![](https://storage.liesauer.net/2020/02/1971790270.png)

根据构建日志提示，我们是少设置了一个环境变量`GITHUB_TOKEN`，我们必须设置这个环境变量，脚本才能对仓库进行Release的操作，否则是无权限操作的。
![](https://storage.liesauer.net/2020/02/3581966278.png)

#### 创建ACCESS TOKEN
我们进入GitHub的`Settings->Developer settings->Personal access tokens`，然后新建一个，要注意的是`write:packages`一定要勾上，然后其他的两项会自动帮你勾上的，不用管，直接提交。添加完后将其复制。
![](https://storage.liesauer.net/2020/02/3766351938.png)

#### 添加环境变量
我们回到travis-ci.com，进入到项目设置中，添加一个名叫`GITHUB_TOKEN`的环境变量，将刚刚生成的token粘贴进去就行了。
![](https://storage.liesauer.net/2020/02/1669801971.png)

#### 重新构建
我们点击travis-ci.com项目的重新构建，等待其完成，然后我们进入GitHub项目的Release页面，发现已经成功发布了Release。
![](https://storage.liesauer.net/2020/02/2950931392.png)

#### 自定义Release信息
由于这是傻瓜式自动脚本，所以并没有提供自定义标题的功能，标题固定为`tag`的名字，无法自定义，但是Release的信息却可以自定义，只要我们commit的时候，使用以下格式进行提交，脚本会自动提取，若未提供此格式，则以整条commit信息作为Release信息上传
```markdown
commit信息

### Release

自定义release信息
```

如下图所示，我们的commit信息为`Create test.txt`，但是额外提供了`# Release`格式的信息，当我们推送此commit且添加tag时，发布的Release信息则使用自定义的信息。
![](https://storage.liesauer.net/2020/02/2388210039.png)

重新加一个tag触发构建
![](https://storage.liesauer.net/2020/02/2391620258.png)

效果如下
![](https://storage.liesauer.net/2020/02/2789891128.png)

#### Pre-Release发布
只要`tag`中含有`alpha` `beta` `rc`，即可自动识别为`Pre-Release`发布，如下图所示。
![](https://storage.liesauer.net/2020/02/1929473793.png)

#### 文件上传
本脚本会将项目`Build/Release`下的所有文件视为上传文件。
下面我们来演示一下文件的上传，由于我们的测试仓库没有构建脚本，无法生成文件，所以我们就只能自己上传文件来演示下，实际使用中只要把生成的文件拷贝至项目`Build/Release`下即可。

上传一个测试文件到`Build/Release`下
![](https://storage.liesauer.net/2020/02/2743912632.png)

发布Release效果如下
![](https://storage.liesauer.net/2020/02/1944864425.png)

#### 最终可达成效果
当你构建脚本写好后，Travis CI写好后，只需以下操作即可傻瓜式上传Release
```shell
git add .
git commit
# 不提供-m参数会进入vim模式，可支持换行信息

# XXX改动
# # Release
#
# ## 更新
# 1. XXX功能更新

# 保存退出
git tag vx.y.z[-beta]
git push
git push --tags
```