一、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 root@192.168.xx.xx -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的过程,希望多多指点!