基于Jenkins的CocoaPods化iOS项目构建＋蒲公英/FIR系统发布

本文以本地和Git为例，结合CocoaPods，简单介绍了如何用jenkins来进行CI编译并上传蒲公英和Fir生成相应二维码的流程。

准备工作

首先，去Jenkins主页下载war包进行本地编译，网址为：https://jenkins.io/index.html 这里，笔者以LTS Release的2.7.2.war包为例

Jenkins下载页面

下好了war包后，运行War包，并设置其端口号，命令如下：

java -jar jenkins.war --httpPort=8888

运行后命令行如下图所示：

Jenkins 运行状态

http://localhost:8888

之后根据页面提示，输入密码并且创建账户后，即可打开Jenkins主页。

配置工作

配置工作里主要进行插件的安装，插件安装方法为： 系统管理 －－>管理插件，选可选插件，选择对应插件后点击直接安装即可。

插件界面

以iOS的持续集成为例，推荐安装的插件为：

• build timeout plugin This plugin allows builds to be automatically terminated after the specified amount of time has elapsed.
• Checkstyle Plug-in This plug-in collects the Checkstyle analysis results of the project modules and visualizes the found warnings.
• Credentials Binding Plugin Allows credentials to be bound to environment variables for use from miscellaneous build steps.
• description setter plugin This plugin sets the description for each build, based upon a RegEx test of the build log file.
• Email Extension Plugin This plugin is a replacement for Jenkins's email publisher
• Git Changelog Plugin creating JIRA filter URL based on commit messages containing JIRA ticket keys in the GIT history
• GitHub Organization Folder Plugin Scan entire GitHub organization for buildable branches and pull requests, in repositories. See Pipeline as Code solution page for more details.
• Gitlab Hook Plugin Enables Gitlab web hooks to be used to trigger SMC polling on Gitlab projects
• GitLab Plugin This plugin integrates GitLab to Jenkins by faking a GitLab CI Server.
• Gradle Plugin This plugin allows Jenkins to invoke Gradle build scripts directly
• HTML Publisher plugin This plugin publishes HTML reports.
• Keychains and Provisioning Profiles Management This plugin integrates management of keychain and provisioning files for iOS and OSX projects.
• Log Parser Plugin Parse the console output and highlight error/warning/info lines.
• Pipeline A suite of plugins that lets you orchestrate automation, simple or complex. See Pipeline as Code with Jenkinsfor more details.
• Post-Build Script Plug-in PostBuildScript makes it possible to execute a set of scripts at the end of the build.
• Project Description Setter Set the project description from a file in the workspace
• Publish Over FTP Send build artifacts over FTP
• Subversion Plug-in This plugin adds the Subversion support (via SVNKit) to Jenkins.
• Timestamper Adds timestamps to the Console Output.
• Workspace Cleanup Plugin This plugin deletes the project workspace after a build is finished.
• Xcode integration This plugin provides builders to build xcode projects, invoke agvtool and package .ipa files

创建任务

在Jenkins主页点击新建，输入Job名后，选择第一项：构建一个自由风格的软件项目

Paste_Image.png

之后进入配置页面，按照下图来进行配置：

Jenkins配置 part1

配置管理配置部分按下图填写：

Jenkins配置 part2

CocoaPods配置

选择构建-->增加构建步骤-->Execute Shell，再对应pod的代码填写进去：

CocoaPods配置

Command里必须要的是pod install，其他视项目结构而定。例如笔者的项目由于podfile文件在子目录之中，所以先执行CD [子目录名]进入子目录再执行。

Warning：

• 在Jenkins中设置CocoaPods配置之前请务必保证本地CocoaPods可以正常工作。这里默认你的CocoaPods已经执行过了pod setup这些步骤了。
• CocoaPods的Execute Shell一定要在XCode配置之前执行。（点击左侧的拖动bar，可以自由调整插件顺序）
• 目前Jenkins上虽然有CocoaPods的插件，但是功能有限，不推荐使用

XCode General配置

先进行添加：选择构建-->增加构建步骤-->XCode

Paste_Image.png

General Build Settings

在target处填写XCode项目的target名称。如果不知道名称，去项目目录下运行xcodebuild -list进行查看； Configuration设置为Debug或者Release，取决于你想要什么样的版本； ipa filename pattern:可以定制ipa的名称，例如yourIPAname_${VERSION}_${BUILD_DATE} Output directory设置ipa的路径。

General Setting

配置证书

Code signing & OS X keychain options设置如下：

Code Siging设置

Code Sign Identity填写证书的名称（请查看你的Keychain里对应iPhone Developer证书的名称，包括括号里的内容） unlock Keychain，在Keychain Path里填入在项目中倒入的开发者证书的keychain。如果不知道在哪儿，可以试试：

default : ${HOME}/Library/Keychains/login.keychain

Password是你的登陆密码

XCode 高级设置

XCode Schema File：如果不知道名称，去项目目录下运行xcodebuild -list进行查看； SYMROOT：填写你想设置的SYMROOT，例如${WORKSPACE}/build/ Custom xcodebuild arguments:XCode配置参数，可以参考下图的设置 XCode Workspace File：如果需要运行workspace，请选择项目下对应的*. xcworkspace文件 XCdoe Project Directory：填写项目路径 XCode Project File：填写Project文件所在路径

高级设置

开发者证书导入

XCode此时应该导入开发者证书：

• 从苹果开发者官网：官网地址,导入Certificates和Provisioning Profiles证书或密钥：

Apple Developer 应该保证XCode的General窗口箭头位置没有黄色的惊叹号：

General

集成蒲公英发布系统：

点击增加构建步骤-->Execute shell，创建脚本窗口：

QQ20160826-1.png

在脚本里填写如下格式代码：

curl -F "file=@${WORKSPACE}/ipa/helloJenkins.ipa" -F "uKey=xxxx" -F "_api_key=xxx" https://www.pgyer.com/apiv1/app/upload

其中，file是ipa文件的路径，记得要带@；uKey与F_api_key是蒲公英系统上的userKey与apiKey，蒲公英官网注册好后填写完全即可。

选择增加构建后操作步骤--> Set Build Description,如下图所示：

SetBuild

在Description中填写Image的对应地址即可：

image

点击OK，编译即可。然后进入Console页面去查看。 成功后应该如下图所示：

Paste_Image.png

集成fir.im发布系统

集成fir比集成蒲公英更加简单，因为官方有jenkins插件。直接安装后配置其apiKey即可。 参考fir官网对其的介绍页面

集成Git

取消掉XCode对应设置

如果确定要通过Git来构建，先取消掉之前的Advanced Xcode build options步骤，方法是清除Advanced Xcode build options内部的所有配置

更改源码管理

随后，回到源码管理，将选项由none改为Git，填入Git项目地址。这里以public项目为例，所有下面的credentials不用填写。如果是private，则需要填写git的用户名密码。

Git选项

参数化构建

想要达到根据具体分支构建的目的，需要添加对应插件Git Parameter Plugin 之后进入配置页面：

添加参数

在添加参数页面中设置 Git Parameter

之后按照下图所示进行设置：

Git Parameter 配置

之后要在下面的 源码管理 Git配置页面中Branch的对应字段填写你在Git Parameter中Name上所写的名字，如下所示：

源码管理中git的设置

希望小文能给各位的工作带来帮助！