前提

本项目在配置jenkins前已配置安装fastlane并自动上传蒲公英，关于fastlane的使用不在本文讨论范围之内。

安装Jenkins

jenkins有几种方式安装，一种是去官网下载dmg安装包(还可以下载.war文件，通过执行命令java -jar jenkins.war安装)，这也是我最先选择的方式，然而此种方式安装确有一些很明显的坑

输入初始密码需要前往/Users/Shared/Jenkins/Home/这个目录下，非Jenkins用户需要给/secrets/增加读权限，然后找到initialAdminPassword文件，打开复制出密码，在初次登入http://localhost:8080时使用
上面的还只是小问题，最大的问题来了。本人正确配置项目后，通过git拉取代码时总是出现timeout超时问题，查询了一堆资料，比如增加超时时间，只拷贝最近一次的代码

git fetch --tags --progress time out.png

然而，并没有什么luan用，通过40+次构建失败，让我认识到此法不通，于是卸载重装
安装包卸载路径： /Library/Application Support/Jenkins/Uninstall.command
brew方式卸载方法：brew uninstall jenkins

推荐的安装方式是通过homebrew安装，此方案安装后以上问题不再出现，其安装目录为/Users/当前用户/.jenkins，隐藏文件需使用命令command+shift+.显示
安装命令: brew install jenkins

你可能需要了解这些gem、brew、rvm、bundle的相关介绍

jenkins+fastlane+git+cocoapods实现iOS持续集成踩坑记录

如果出现以上问题，说明brew版本不匹配，可以执行brew --version命令会自动更新到最新版本

顺利的执行完brew install jenkins，结果发现安装的是2.68版本，根据提示命令更新到新版2.101

启动Jenkins

执行命令jenkins，浏览器打开http://localhost:8080 web页面，粘贴所获的的初始密码

initialAdminPassword.png

插件plugin

我只安装了社区推荐的插件(安装时建议*)，可选插件Xcode integration
与其他文章不同的是，Keychains and Provisioning Profiles Management这个插件我并没有选择安装，原因是这些东西我已经通过fastlane在脚本配置里，无需再另行上传证书及相关设置
如果插件安装失败，可前往http://localhost:8080/pluginManager/available更新插件

系统设置

GitHub设置

如果项目是GitHub私有项目，或是使用github轮询，需要添加GitHub Server及许可证

GitHub Server

github需要授权才能使用相关api，access tokens可在 Settings->Developer settings->Personal access tokens里管理

Personal access tokens.png

配置邮件地址

配置系统管理员邮件地址

这个警告⚠️我是保留的，如果修改为本地127.0.0.1会提示反向代理设置有误
由于本机没有公网ip，所以导致git轮询的方式会不可用，在此记录一下

Extended E-mail Notification

Default Content:

(本邮件是 Jenkins 服务端构建完毕后自动发送，请勿回复)<br/><hr/>

项目名称：$PROJECT_NAME<br/>
Git版本号：$GIT_REVISION<br/>
触发原因：$CAUSE<br/>
构建编号：# $BUILD_NUMBER<br/>
构建状态：$BUILD_STATUS<br/>
构建日志地址：<a href="${BUILD_URL}console">${BUILD_URL}console</a><br/>
构建地址：<a href="$BUILD_URL">$BUILD_URL</a><br/>
本次构建变化：$CHANGES_SINCE_LAST_SUCCESS<br/>

send email success.png

如果出现Failed to send out email javax.mail.AuthenticationFailedException: 535 Error: authentication failed, system busy错误，在确保邮箱已开启SMTP服务情况下，请保证Extended E-mail Notification与邮件通知两者的配置是一致的，并检查密码。
如果提示501错误，这是因为你的系统管理员地址与授权的账号地址不是同一个，需要保持一致。

添加项目地址

私有项目如果报权限问题，最好在本机生成SSH Key，这时你需要去~/.ssh/id_rsa文件里拿取私钥信息，然后加到Global Credentials中即可。

构建Job

通过github构建项并添加源码管理

当然你也可以选择Build periodically或Poll SCM方式

Build periodically：周期构建，它不关心源码是否变化
Poll SCM：定时检查源码变更，如果有更新就checkout最新code下来，然后执行构建动作

* * * * *
第一个*表示分钟，取值0~59
第二个*表示小时，取值0~23
第三个*表示一个月的第几天，取值1~31
第四个*表示第几月，取值1~12
第五个*表示一周中的第几天，取值0~7，其中0和7代表的都是周日

fastlane脚本

fastlane项目地址：https://github.com/fastlane/fastlane
fastlane相关文档：docs.fastlane.tools

你可以直接使用

IPANAME="jinkens-myapp"
fastlane gym --export_method ad-hoc --output_name ${IPANAME}

来指定打包方式（蒲公英文档），也可以手动配置，以下是我fastlane关于pgy这个action的代码(我的fastlane已通过match自动配置证书，关于这个命令的使用可以查看fastlane match命令)

desc "Submit a new Beta Build to Pgy"
lane :pgy do
  match(type: "adhoc", app_identifier: "com.xxxxxx.ios", readonly: true)
  gym(
    scheme: "xxx",
    silent: true,  # 是否隐藏打包时不需要的信息
    configuration: 'Debug', # 指定打包时的配置项，默认为Release 
    export_method: "ad-hoc", # 指定导出.ipa时使用的方法，可用选项：app-store, ad-hoc, package, enterprise, development, developer-id
    export_options: {
      provisioningProfiles: {
        "com.xxxxxx.ios" => "match AdHoc com.xxxxxx.ios"
      }
    }
  )
  pgyer(api_key: "xxxxxxxxxxxxxxxx", user_key: "xxxxxxxxxxxxxxxxxxx")
end

构建后压缩存档

Archive the artifacts

构建后打包并上传到蒲公英

除了在fastlane安装蒲公英插件的方式，还可以在jenkins中选择安装Upload to pgyer插件

Upload to pgyer

构建后上传fir.im

需要先安装fir-plugin插件

Upload to fir.im

构建后添加邮件通知

Editable Email Notification

点开高级设置Advanced settings...，根据构建状态发信

Advanced settings

执行Job

点击“立即构建”，未加入 fastlane相关控制台输出如下：

first_log.png

Share Scheme

以为这就完了吗？我还真以为这样就搞定了-_-
执行fastlane pgy构建失败！CI下如果使用了workspace，你需要显式的指定一个scheme：

Couldn't find specified scheme 'xxx'.�
Multiple schemes found but you haven't specified one.�
Since this is a CI, please pass one using the `scheme` option�
Couldn't find any schemes in this project, make sure that the scheme is shared if you are using a workspace�
Open Xcode, click on `Manage Schemes` and check the `Shared` box for the schemes you want to use�
Afterwards make sure to commit the changes into version control�

以前在本地运行可没这情况，赶紧按其解决办法在Manage Schemes中将Shared勾选☑️

Manage Schemes.png

别忘了将相关设置上传，以下是我参考[iOS] gitignore 忽略上传pods/cocoaPods 文件修改过的.gitignore文件内容

# Xcode
.DS_Store
*/build/*
*.pbxuser
!default.pbxuser
*.mode1v3
!default.mode1v3
*.mode2v3
!default.mode2v3
*.perspectivev3
!default.perspectivev3
xcuserdata
!xcshareddata
profile
*.moved-aside
DerivedData
.idea/
*.hmap
*.xccheckout
*.xcworkspace
*.xcuserstate
!default.xcworkspace

#CocoaPods
Pods
!Podfile
!Podfile.lock

#Fastlane
!fastlane
!Gemfile
!Gemfile.lock
*.ipa
*.app.dSYM.zip

最大的坑

以上所有讲的都是在本地运行自动化构建，配置低的小伙伴不高兴了，打包????炒鸡卡，于是将项目部署到服务器上了
然而问题来了，我在服务器上运行时发现构建无法成功，提示pod: command not found，于是google了一堆资料，多种方式都没解决，才想到是Linux服务器并没有配置相关的环境，当然不支持brew、rvm、gem、pod、bundle、fastlane这些命令啦，查询*告诉我

蛤？相关的命令行工具只能在Mac环境运行？

所以你需要一台Mac服务器！
故而我现在本地只能手动点构建或者是采用定时构建方式，在开机后自动启用Jenkins
而服务器端虽然可以hook到git commit log，但是无法通过以上脚本运行，干脆就作为邮件发送器算了????

参考资料

手把手教你利用Jenkins持续集成iOS项目
 利用 Jenkins 实现 iOS 自动化构建踩坑记录
 Mac中jenkins的使用——自动构建
 最全Jenkins+SVN+iOS+cocoapods环境搭建及其错误汇总
 Jenkins的几个问题
 jenkins 邮件配置展示change信息
 Jenkins进阶系列之——02email-ext邮件通知模板

jenkins+fastlane+git+cocoapods实现iOS持续集成踩坑记录

前提