Kesco的编码世界

用Travis CI给Android项目部署Github Release

时至今日，互联网软件的开发和发布，已经形成了一套标准流程，其中一个重要部分就是持续集成(CI)。

平时我工作中CI用得比较多的地方是按照git tag做应用渠道分发打包。最近写了一个拖拽手势Xposed插件SlideBack-Xposed，除了Xposed Module Repo外，我需要一个提供APK对外下载的地方。由于Google Play审核机制收紧了，单纯Xposed插件收录比较麻烦，而我又不想放到国内渠道上，于是我把注意力放到Github Release上。

Github Release是Github推出的一个帮助开发者发布Repo最终软件包给用户的功能。Github Release是根据其Repo的Git标签来排序的，而且目前Github还没有限制Github Release的存储大小，不需担心空间不够用，所以一般情况下，已经可以了。同时，我们利用Travis CI来自动根据我们打的Git Tag来构建APK并Push到自己的Github Release上。

启用Travis CI

Travis CI是比较流行的开源持续构建平台，与Github结合比较紧密，对Github上的开源Repo是免费的，私有Repo收费（Circle CI也不错，而且对Github私有Repo也是免费的）。我们首先在Travis CI上打开对自己项目的Hook开关，那么当你每次Commit Push的时候，CI就会自动运行了。

travis-enable-project

基础构建脚本

Travis CI使用YAML文件作为构建脚本，以最简单Android项目构建APK为例，只需在项目根目录创建.travis.yml文件：

1language: android
2android:
3  components:
4    - build-tools-22.0.1
5    - android-23
6    - extra-android-m2repository
7    - extra-android-support
8script:
9  - ./gradlew assembleRelease

然后git add . && git commit && git push即可。这里解释下，.travis.yml几个关键的Tag：

  1. 因为Repo是Android项目，所以构建语言language选择android。
  2. 选择了Android项目后，就在android中的components的tag中设置Android项目需要的依赖。
  3. Travis CI编译Android实际上也是调用项目中的构建脚本的。现在大部分Android项目都是用Gradle构建的，如果是要打Release版本的APK包，在script加入./gradlew assembleRelease就行了。

不过，实际上，单纯在CI上面打包，其实是没什么用处的，因为Travis CI每次任务完成之后，就会把所有生成的文件清掉，所以我们要把生成的APK传到Github Release上。

发布Github Release

Travis CI默认支持发布到Github Release上，不需要配置别的脚本，相应的YAML配置Tag是这样的：

1deploy:
2  provider: releases
3  api_key: "GITHUB OAUTH TOKEN"
4  file: "FILE TO UPLOAD"
5  skip_cleanup: true
6  on:
7    tags: true

值得注意的一点就是skip_cleanup这个Tag要设置为True，不这样做的话，Travis CI在部署之前就会清空生成的APK文件，那样你就什么都得不到了。api_key是部署到Github Release的凭证，需要开发者自己生成。如果不想那么麻烦的话，可以使用Travis CI提供的travis命令行工具。

travis是用Ruby写的，安装需要系统配有Ruby 1.9以上版本：

1gem install travis -v 1.8.0 --no-rdoc --no-ri

安装完成后，在根目录执行：

1travis setup releases

按照相应的提示，就可以生成相应的部署配置了。完整的.travis.yml文件如下：

 1language: android
 2android:
 3  components:
 4    - build-tools-22.0.1
 5    - android-23
 6    - extra-android-m2repository
 7    - extra-android-support
 8script:
 9  - ./gradlew assembleRelease
10deploy:
11  provider: releases
12  api_key:
13    secure: [生成的token]
14  file: app/build/outputs/apk/app-release.apk
15  skip_cleanup: true
16  on:
17    tags: true

这样，以后在你Repo打git tag并把它Push到Github上后，Travis CI就会自动帮你构建一个Github Release了。

slideback-github-release

等等，难道这样就结束了吗？当然不了，这只是单纯把APK发送到Github Release上去。但是构建APK过程中还有很多问题，比如你在CI构建Release版本的APK的时候，要用到自己签名的密钥，对吧。我们当然不能把密钥的信息公开，那么该怎么做呢？

隐藏签名密钥信息

Travis CI是通过Android项目中的build.gradle的信息来构建apk的，自然我们通过配置build.gradle脚本来签名apk也是很正常的事。但是在公开项目中暴露签名密钥信息是不安全的，有个简单的方法是，让gradle在CI构建的时候从CI的环境变量中读取密钥信息，这样可以降低点风险。

首先，我们先在build.gradle配置签名选项文件：

 1android {
 2    signingConfigs {
 3        release {
 4            storeFile file(".kesco.keystore")
 5            storePassword System.getenv("KEYSTORE_PASS")
 6            keyAlias System.getenv("ALIAS_NAME")
 7            keyPassword System.getenv("ALIAS_PASS")
 8        }
 9    }
10}

像这样的话，gradle在签名的时候会自动从系统读取KEYSTORE_PASS、ALIAS_NAME和ALIAS_PASS三个环境变量。

然后我们在Travis CI上设置KEYSTORE_PASS、ALIAS_NAME和ALIAS_PASS这三个环境变量：

另外，Travis CI在构建Android项目时，默认使用Oracle JDK，但是当我设置CI的环境变量后，构建会报错，所以就把JDK换为OpenJDK了：

1jdk: openjdk7

如果还想更保密点的话，可以将签名密钥keystore文件加密一下，等CI启动的时候再解密，这样会安全些。

以上就是我折腾SlideBack-Xposed项目时总结出来的经验，下面是我项目中完整的.travis.yml文件：

 1language: android
 2jdk: openjdk7
 3android:
 4  components:
 5    - build-tools-22.0.1
 6    - android-23
 7    - extra-android-m2repository
 8    - extra-android-support
 9git:
10  submodules: false
11before_install:
12  - sed -i 's/git@github.com:/https:\/\/github.com\//' .gitmodules
13  - git submodule init && git submodule update
14script:
15  - ./gradlew assembleRelease
16before_deploy:
17  - mv app/build/outputs/apk/app-release.apk app/build/outputs/apk/slideback.apk
18deploy:
19  provider: releases
20  api_key:
21    secure: [Github Token]
22  file: app/build/outputs/apk/slideback.apk
23  skip_cleanup: true
24  on:
25    tags: true

#笔记