Xcode jenkins+gitlab本地服务器+蒲公英 自动化打包构建

一、Jenkins简介

       Jenkins是一个广泛用于持续构建的可视化web工具，即各种项目的”自动化”编译、打包、分发部署。Jenkins可以很好的支持各种语言（比如：Java,C#,PHP等）的项目构建，也完全兼容ant、maven、gradle等多种第三方构建工具，同时跟svn、Git能无缝集成，也支持直接与知名源代码托管网站，比如github、bitbucket直接集成。

二、Jenkins的安装

       1、Jenkins本身是用java语言开发的，所以安装Jenkins之前，需要安装JDK，建议安装1.8.x版本，太高版本的话会不支持。

       2、进入Jenkins的官网https://jenkins.io/index.html，然后下载并安装Jenkins。安装完成后会进入 http://localhost:8080/ 这个页面。

进入上述页面后需要填入密码，使用终端输入命令：cat /Users/Shared/Jenkins/Home/secrets/initialAdminPassword 回车后会出现一段密码，填入即可。

   如果出现上述页面，则需要先设置权限 。终端cd到目录下，执行chmod -R 777  secrets

3、接着会出现下载插件的页面，默认下载即可。

   4、下载完成后，刷新页面会进入注册管理员账号的页面。填入信息，注册好账号。

    5、账号保存完成之后就会进入主页面。

三、Jenkins使用

       1、需要安装一些插件用来支持iOS+git打包，gitlab、Xcode integration、Keychains and Provisioning Profiles Management等插件。下图可以搜索插件名来安装插件。

      2、配置Xcode开发证书

           点击系统管理->Keychains and Provisioning Profiles Management   

此处需要上传login.keychain 文件在/Users/xxx/Library/Keychains，然后将开发证书名和生产证书名都复制过来添加。然后配置文件的路径/Users/Shared/Jenkins/MobileDevice/Provisioning Profiles。这里需要将/Users/xxx/Library下的MobileDevice文件夹和Keychains文件夹都拷贝到/Users/Shared/Jenkins这个目录下。

    3、点击新建任务

新建完成后，进入配置页面

撸主公司是搭建的本地git服务器，因此源码配置跟线上稍微有些不一致。此处填入源码地址，分支填入自己需要打包的分支名。Credentials此处需要配置账号密钥。

点击add添加账号私钥。

如何获取本地私钥？使用终端登录服务器 ：ssh [email protected] -p6xx22   服务器地址以及端口号，接着输入密码，cd到密钥目录获取密钥，拷贝出来填入上图中的private key就可以了。

建好这个账号之后选择这个账号就不会报错了，否则会连不到源码库。

4、构建设置

       由于撸主是Xcode 9.x使用Xcode构建一直无法成功，因此这里使用脚本来构建。点击增加构建步骤->执行shell。填入命令

security unlock-keychain -p 123456 /Users/Shared/Jenkins/Library/Keychains/login.keychain

xcodebuild -archivePath "/Users/Shared/Jenkins/Home/jobs/xxx/workspace/build/xxx.xcarchive" -workspace xxx.xcworkspace -sdk iphoneos -scheme "xxx" -configuration "Release" archive

xcodebuild -exportArchive -archivePath "/Users/Shared/Jenkins/Home/jobs/xxx/workspace/build/xxx.xcarchive" -exportPath "/Users/Shared/Jenkins/Home/jobs/xxx/workspace/build/xxx_Release" -exportOptionsPlist '/Users/Shared/Jenkins/Home/jobs/xxx/ExportOptions.plist' -allowProvisioningUpdates

第一行命令是解锁钥匙串，第二行命令是打包，第三行命令是输出ipa包，第三行需要配置一个plist文，这个文件包含了证书和bundle identify信息。可以在本地用Xcode打包来输出一个，此处根据不同的plist文件中的不同证书可配置development，adhoc，appstore，enterprise不同的包。

    5、上传到蒲公英分发平台。

    在系统设置->插件管理中下载 pyger插件，在增加构建步骤选择upload to pgyer with apiV1/apiV2

以上就是一个完整的构建步骤了。

四、可能遇到的问题。

1、codesign unknown error -1=ffffffffffffffff Command /usr/bin/codesign failed with exit code 1，这种情况是证书识别错误。

     解决方法：1、检查/Users/Shared/Jenkins目录下的Keychains和MobileDevices的配置文件，可以重新从/Users/xxx/Library/下拷贝覆盖。

                        2、证书解锁，登录钥匙串，将证书设置为允许所有程序访问

2、撸主使用Xcode9.x，使用Xcode构建一直无法成功，因此才改成使用xcodebuild命令打包。

以上，就是我搭建Jenkins+git+pgyer的过程，希望多多指点！