iOS+Jenkins+gogs+webhook 自动化集成方案

111

前言
　　每次打包给测试工程进行测试，都要在电脑上编译->导出ipa->上传svn->告知测试人员。每次迭代的时候都进行着重复的工作，身为一个高效率的码农，我寻找一个可以自动化的工具帮我做这件事，就有了文中的方案了。

搭建

安装Jenkins
　　Jenkins需要依赖java，需要需要下载JDK，安装完JDK就可以去Jenkins官网下载War包。
　　JDK下载传送门
　　
Jenkins下载传送门
　　下载war放在一个自己喜欢的路径放着，然后进入该目录运行启动命令，可以自定义端口号启动，命令如下
java -jar jenkins.war --httpPort=8888　　启动后打开浏览器输入http://localhost:8888 ，首次启动需要重置密码，Jenkins默认的配置目录
cat ～/.jenkins/secrets/initialAdminPassword　　复制该密码进入输入框即可登录，然后设置一下账号密码，选择一些插件。如果提示offline的话，就跳过选择插件直接进入首页。
　　
为了解决无法获取插件列表问题，可以在系统管理->插件管理->高级->升级站点里面更换成http://updates.jenkins-ci.org/update-center.json这个站点即可获取到插件列表。
　　我只是安装了Generic Webhook Trigger插件。在可选插件里面搜索你想要安装的插件进行安装即可。
　　这样Jenkins工具就配置完成了。

Gogs的配置
　　我是使用Gogs进行代码托管。如果是用svn进行代码管理的话，可以百度一下，有很多相关的教程。
　　在git仓库里面设置一下webhook。

　　因为我们在Jenkins安装的webhook插件的接收地址是http://192.168.1.91:8888/generic-webhook-trigger/invoke?token=<在Jenkins上填写的令牌>
　　选择接收数据格式为json,只触发push时间。

配置Jenkins任务

新建任务

　　填入对应代码的项目名称。
　　
这里可以选择构建一个自由风格的软件项目去重新配置，也可以选择复制一个已经存在的任务去配置。然后点击确认。

配置任务

• 　　通用
  
  
  
  　　可以勾选丢弃旧的构建。
  
  
• 　　源码管理
  
  
  
  　　选择Git，并添加对应的项目的URL，添加对应的git账号。分支名填$ref。为什么要填这个，等一下就会说明。分支名是让Jenkins选用该分支进行构建。
  　　
  Additional Behaviours附加行为选择Clean before checkout、Check out to specific local branch，分支名填写**。
  
  
• 　　构建触发器
  
  
  
  　　Gogs所push的json格式可以在传送门这里查看。部分字段如下。如果不是使用Gogs的话，可以到对应工具的官网寻找。
  
  
  
  　　其中的ref字段就是该push事件的分支。我们可以根据这个字段去区分需要自动化构建的分支。比如我们的develop分支是不需要进行构建的，master分支是需要构建的。
  　　令牌填写项目名，用于唯一标识这个job，请记住不能重复。
  　　
  勾选Generic Webhook Trigger ，添加post content parameters，变量名为该job的一个环境变量，在job的其他位置可以用$***的形式引用，好比如刚刚的$ref。
  　　
  Expression选择Jsonpath，用jsonpath的语法去匹配对应的字段名。
  　　
  Optional filter用于区分触发构建的。这里用分支名来区分是否进行构建。我用这个正则^\S*release|beta|alpha$去只监听release、beta、alpha三个分支,这里根据自己的实际情况去修改。
  
  
• 　　构建
  　　其实可以安装xcode插件去进行构建的，但是配置xcode插件有点麻烦，我放弃了，选择使用shell脚本，这样可以很大程度自定义。使用xcode插件的可以自行百度。部分脚本如下。
  configuration="Release"　　
  
  　　
  ipa_version=$(git symbolic-ref --short -q HEAD)
  　　
  
  　　
  bundle_version=""
  　　
  if [[ $ipa_version = 'alpha' ]]; then
  　　configuration="Debug"
  　　bundle_version=$(/usr/libexec/PlistBuddy -c "Print CFBundleVersion" $infopl_path)
  　　
  elif [[ $ipa_version = 'beta' ]]; then
  　　configuration="Release"
  　　bundle_version=$(/usr/libexec/PlistBuddy -c "Print CFBundleVersion" $infopl_path)
  　　
  elif [[ $ipa_version = 'release' ]]; then
  　　configuration="Release"
  　　bundle_version=$(/usr/libexec/PlistBuddy -c "Print CFBundleShortVersionString" $infopl_path)
  　　
  else
  　　exit 0
  　　
  fi
  　　
  
  　　
  archivePath="${BUILD_PATH}/${ipa_version}/${JOB_NAME}.xcarchive"
  　　
  
  　　
  tempPath="${BUILD_PATH}/${ipa_version}/temp"
  　　
  
  　　
  xcodebuild clean -scheme $JOB_NAME -configuration $configuration
  　　
  projectPath=$(find $WORKSPACE  -name "*.xcworkspace" -maxdepth 1)
  　　
  
  　　
  if [[ -n $projectPath ]]; then
  　　xcodebuild archive -workspace ./${JOB_NAME}.xcworkspace/ -scheme ${JOB_NAME} -archivePath ${archivePath} -configuration $configuration
  　　
  else
  　　projectPath=$(find $WORKSPACE  -name "*.xcodeproj" -maxdepth 1)
  　　xcodebuild archive -project $projectPath -scheme ${JOB_NAME} -archivePath ${archivePath} -configuration $configuration
  　　
  fi
  　　
  
  　　
  xcodebuild -exportArchive -archivePath ${archivePath} -exportPath ${tempPath} -exportOptionsPlist ${exportOptionsPlist}
  　　xcode8以后使用xcodebuild进行导出ipa的时候需要提供exportOptionsPlist。导出development、ad-hot、AppStore的plist内容是有点不一样的，具体可以手动导出对应的包，里面会有exportOptionsPlist的，参照弄就好了。
  
  
• 　　构建完成后
  　　可以上传到ftp或者分发到蒲公英，然后发一封邮件给相应的人员，告知他们。我这些操作是构建脚本里面一块弄了。也可以使用Jenkins的一些插件去帮助你。
  
  

最后
　　希望本文能帮到一些同学。