Jenkins

原文地址：LoveDev

Jenkins 是一款领先的开源自动化服务器，提供了数百个插件来支持任何项目的构建，部署和自动化

前往官网下载最新的 war 包，war 包使用起来比起安装到系统中方便一些，这篇文章中用到的是 2.46.2 版本的 war 包

启动命令：

# --httpPort 参数可以指定启动的端口，避免端口冲突
$ java -jar jenkins.war --httpPort=1111

初次进入 Jenkins 时需要初始密码，密码会在启动日志中打印出来：

Jenkins initial setup is required. An admin user has been created and a password generated.
Please use the following password to proceed to installation:

f1bfd39676da4339afbb93dd3e07606b

This may also be found at: /home/.jenkins/secrets/initialAdminPassword

进入以后会有两个选项，建议选择左边的一个，会安装一些常用的插件，然后就是创建账号，创建账号的时候命令行可能会报 403 错误码，此时需要进入 系统管理 -> Configure Global Security，关闭 防止跨站点请求伪造 选项

进入首页之后，需要在 Global Tool Configuration 中配置 JDK、Gradle 信息

Global Tool Configuration

JDK和Gradle的配置最好跟项目中使用的相同，我的配置如下：

JDK Gradle

编译 Android 项目怎么能少得了 SDK，SDK 的配置需要到 系统设置 中配置：

系统设置

在 全局属性 中增加键值对，我的配置如下：

ANDROID_HOME

随便配置一下插件 Extended E-mail Notification：

邮件通知

到此，编译环境配置完成，接下来需要创建项目并配置项目，首先点击新建创建一个自由风格的软件项目：

创建项目

创建完成后会自动跳转到项目的配置界面，里面有很多的配置项，该文章只介绍一些必须的配置项，日后会陆续更新补充

配置源码管理

源码管理

点击 Add 按钮可以添加密钥：

添加密钥

配置构建触发器

构建触发器

配置 Gradle

点击 增加构建步骤，选择图中选项：

增加构建步骤

具体配置：

Invoke Gradle script

Tasks 选项里面的内容可以根据自己的需求填写

邮箱通知插件

全局的邮件插件已经配置过了，现在需要在项目中进行具体的配置，配置步骤很简单：

邮箱通知配置

邮件通知内容模板：





${ENV, var="JOB_NAME"}-第${BUILD_NUMBER}次构建日志



    
        
            (本邮件是程序自动下发的，请勿回复！)
        
        
            
                    构建结果 - ${BUILD_STATUS}
                
        
        
            

            构建信息
            
        
        
            
                
                    项目名称 ： ${PROJECT_NAME}
                    项目描述 ： ${JOB_DESCRIPTION}
                    构建编号 ： 第${BUILD_NUMBER}次构建
                    触发原因： ${CAUSE}
                    下载地址： http://fir.im/t6k7
                    构建日志： ${BUILD_URL}console
                    构建  Url ： ${BUILD_URL}
                    项目  Url ： ${PROJECT_URL}
                
            
        
        
            Changes Since Last
                        Successful Build:
            
        
        
            
                
                    历史变更记录 : ${PROJECT_URL}changes
                
 ${CHANGES_SINCE_LAST_SUCCESS,reverse=true, format="Changes for Build #%n:
%c
",showPaths=true,changesFormat="[%a]
%m",pathFormat="    %p"}
            
        
        
            构建日志 (最后 100行):
            
        
        
        
            ${BUILD_LOG, maxLines=100}

上传APK到fir

官方文档在这里

这里具体介绍一下怎么上传 git 中的 commit 信息到fir，需要用到 Environment Injector Plugin 插件，具体步骤如下：

输出 commit 文件内容，增加构建步骤 -> Execute shell ->在Command输入以下内容（注意替换Jenkins的username，password，IP，端口）：

CHANGELOG=$(curl -u username:password "http://localhost:8080/job/$JOB_NAME/$BUILD_NUMBER/api/xml?wrapper=changes&xpath=//changeSet//comment" | sed -e "s/<\/comment>//g; s///g; s/<\/*changes>//g" | sed '/^$/d;G')
echo CHANGELOG=$CHANGELOG > change_log_vars

设置 commit 文件参数：增加构建步骤->Inject environment variables->在Properties File Path输入change_log_vars
输出 commit 作者文件内容：增加构建步骤->Execute shell->在Command输入以下内容：

CHANGEAUTHOR=$(curl -u username:password "http://localhost:8080/job/$JOB_NAME/$BUILD_NUMBER/api/xml?wrapper=changes&xpath=//changeSet//fullName" | sed -e "s/<\/fullName>//g; s///g; s/<\/*changes>//g" | sed '/^$/d;G')
echo CHANGEAUTHOR=$CHANGEAUTHOR > change_author_vars

设置 commit 作者文件参数：增加构建步骤->Inject environment variables->在Properties File Path输入change_author_vars
最后设置到 fir 插件中：增加构建后操作步骤->Upload to fir.im，然后在Build Notes中输入:

$CHANGELOG
by $CHANGEAUTHOR

最后上一张 fir 插件的配置图：

commit 信息提取

fir 插件配置

常见问题

构建失败

  Fix the issues identified by lint, or add the following to your build script to proceed with errors:
  ...
  android {
      lintOptions {
          abortOnError false
      }
  }
  ...

已经提示了怎么处理该错误，在 Gradle 文件中加入提示的代码即可

测试邮件发送失败

Failed to send out e-mail

javax.mail.AuthenticationFailedException: 535 Error: authentication failed

    at com.sun.mail.smtp.SMTPTransport$Authenticator.authenticate(SMTPTransport.java:809)
    at com.sun.mail.smtp.SMTPTransport.authenticate(SMTPTransport.java:752)
    at com.sun.mail.smtp.SMTPTransport.protocolConnect(SMTPTransport.java:669)
    at javax.mail.Service.connect(Service.java:317)
    at javax.mail.Service.connect(Service.java:176)
    at javax.mail.Service.connect(Service.java:125)
    at javax.mail.Transport.send0(Transport.java:194)
    at javax.mail.Transport.send(Transport.java:124)
    at hudson.tasks.Mailer$DescriptorImpl.doSendTestMail(Mailer.java:581)
    at java.lang.invoke.MethodHandle.invokeWithArguments(MethodHandle.java:627)
    at org.kohsuke.stapler.Function$MethodFunction.invoke(Function.java:343)

认证失败，注意配置邮箱的密码并不是登录密码，而是授权码

搭建CI环境