美文网首页
Jenkins+xcodebuild+fir持续集成踩过的坑(M

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

作者: yangXiong01 | 来源:发表于2018-03-14 17:18 被阅读164次

    下载安装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

    相关文章

      网友评论

          本文标题:Jenkins+xcodebuild+fir持续集成踩过的坑(M

          本文链接:https://www.haomeiwen.com/subject/fttqqftx.html