Jenkins+xcodebuild+fir持续集成踩过的坑(Mac)

下载安装Jenkins(Mac)

Jenkins 是基于 Java 开发的,所以需要先安装 Java 环境。然后去 Jenkins 官网下载 Jenkins.pkg 安装包安装。也可以用 Homebrew 安装。具体安装步骤可以参考这个链接的内容(在High sierra系统下,这篇文章中的使用插件来构建项目的操作已经失效了,可以参考原作者文章底部的脚本构建方法):
手把手教你利用Jenkins持续集成iOS项目

安装过程值得注意的地方:

  • 安装完成后,会自动打开 http://localhost:8080 这个地址,如果没有自动打开,请手动打开。接下来会有个重设 Jenkins 密码的界面,提示给出了密码文件的路径,我假设为:/Users/Shared/Jenkins/Home/secrets/initialAdminPassword。 你可以修改./secrets 这个文件夹的访问权限,然后打开。如果仍然打不开的话可以在终端尝试用:cat /Users/Shared/Jenkins/Home/secrets/initialAdminPassword 这个命令来查看。
  • 安装完成会自动创建一个叫 Jenkins 的用户,这个用户有什么作用我还不清楚。
  • 部分教程说接下来的步骤是去“系统管理-管理插件”菜单安装一些插件。我的这个教程是使用 Xcodebuild 脚本打包的,所以不需要以下的插件:Xcode integration 、Keychains and Provisioning Profiles Plugin。

新建一个项目

  • 选择“构建一个自由风格的软件项目”。其中 General 选项的配置没有什么坑,可以参照大多数的教程来做。
  • 源代码管理,只要你的项目管理软件核心使用的是 git,那么这里都可以选择 git 。我以 GitHub 为例,使用用户名密码来获取项目,首先创建一个 Jenkins 的新的证书,也就是类似于账户的东西:
jenkins_add_credential

也有一些公司的 Bitbucket 、 gitlab 项目仓库存在一些个性化权限设置,如果用户名密码方式失败的话,可以考虑试试SSH登录。

jenkins_source-01

“构建触发器”这个选项可以略过,不用选择任何选项

  • 构建触发器,这个配置可以自动触发 Jenkins 打包,也是自动化构建的必须步骤,配置没有什么复杂的,照着教程设置就可以了。我认为第一次配置 Jenkins 的难点在于第一次构建成功,如果第一次手动构建成功了,后续再完善其他配置都水到渠成,所以我建议一开始配置的时候略过“构建触发器”选项,不影响手动构建iOS项目。附上构建触发器的配置教程:构建触发器详解

“构建环境”这里有坑

  • 之前有很多教程让下载 Keychains and Provisioning Profiles Management 插件,然后在此插件中上传 keychain 和 provisioning file 。坑来了,我是 High Seirra + Xcode9.2 的环境,所以我的Mac中没有一个叫 login.keychain 的文件,直接上传 login.keychain-db 的话,这个插件不识别。有的说改名可以,不过我懒得测试了,总之,我放弃了使用这个插件,我选择使用xcodebuild脚本构建。所以我的方案是,“构建环境”这个选项都忽略掉,不用任何设置。

“构建”使用xcodebuild脚本

直接使用xcodebuild构建,关于xcodebuild的基本语法可以参考以下教程:

官方文档

xcodebuild使用总结

xcodebuild构建
xcodebuild clean -project JenkinsDemo/JenkinsDemo.xcodeproj \
                 -scheme JenkinsDemo \

ArchivePath="/Users/shawn/Desktop/JenkinsDemo.xcarchive"
xcodebuild archive  -project JenkinsDemo/JenkinsDemo.xcodeproj \
                    -sdk iphoneos \
                    -scheme JenkinsDemo \
                    -archivePath "${ArchivePath}" \
                    -configuration Debug \

ExportPath="/Users/shawn/Desktop/JenkinsDemo"
ExportOptionsPlistPath="/Users/shawn/Desktop/ExportOptions.plist"
echo "+++++++++++++++++ exportArchive +++++++++++++++++"
xcodebuild -exportArchive -archivePath ${ArchivePath}\
                          -exportPath  ${ExportPath}\
                          -exportOptionsPlist ${ExportOptionsPlistPath}\
                          -configuration Debug \

ipa_path="/Users/shawn/Desktop/JenkinsDemo/JenkinsDemo.ipa"
fir_token="a4a513de2bcd6064a7d******0855378"
fir publish ${ipa_path} -T ${fir_token}
  • 此时点击构建可能会报如下图的错误,提示证书没有找到:
证书错误
  • 这时候需要打开 keychain 助理,把“登录”选项下的你打包需要的证书,拖到“系统”选项下,正常的话输入两次管理员密码就可以了。
移动证书到系统
  • 如下图是不正常的情况,如果拖拽证书的过程中遇到这样的错误,请重启一次电脑,再操作就可以了。我也不知道原因。
移动证书时发生错误
  • 证书移动完毕,应该可以构建成功了。关于 fir 自动上传的脚本,你可以搜索一下,很简单的。

手动构建成功后,表示基本功能已经完成,后续可以完善其他配置

关于Jenkins

在这个持续集成的方案里,Jenkins的主要职责是随时监听代码仓库的变动,一旦代码仓库改动,满足打包要求,就触发自动构建。自动构建的具体实施是依靠 xcodebuild 脚本来实现的。之前有大神做了一下插件来封装了这些脚本,随着系统版本更新,这些插件不能很好工作了,但是脚本是不变的,原理也是不变的。

这次成功实现Jenkins持续集成,我试错了很多次,走了不少弯路,这里记下来共同进步。

jenkins_failed_history
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 218,607评论 6 507
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,239评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,960评论 0 355
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,750评论 1 294
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,764评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,604评论 1 305
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,347评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,253评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,702评论 1 315
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,893评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,015评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,734评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,352评论 3 330
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,934评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,052评论 1 270
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,216评论 3 371
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,969评论 2 355

推荐阅读更多精彩内容