1.下载jenkins
http://jenkins-ci.org/content/thank-you-downloading-os-x-installer
安装完之后直接输入http://localhost:8080
即可进入jekins界面,如果不能进入请在终端中输入java -version 查看是否安装jdk和当前系统的java环境版本,确保在java7及以上
如果是采用的war包,需要执行
java -jar jenkins.war -httpPort=10000 (端口号自定义设置)
2.安装插件
打开jenkins后需要安装git plugin、gitlab plugin、github plugin、xcode plugin、credential 和keychain 相关的插件,git plugin安装2.4.0以上,低版本会有问题,具体问题见后面。
3.配置
安装完插件之后需要进行一些配置。
首先要创建一个jenkins任务。
具体创建过程如下所示:
点击左侧的“新建”选项,然后填写item名称,选择“构建一个自由风格的软件项目”。点击确定!
点击确定后进入如下界面
这部分根据需要自己填写,我们的项目暂时没有用到该部分,由于我们的代码由gitlab管理,并且还引入了github上的第三方库,所以在源码管理的时候选择git这个选项
然后填写代码所在的git地址,如[email protected],然后填写Credentials,如果之前没有配置过credentials,可以点击旁边的“Add”,
这里选择 “SSH Username with private key” scope选择Global还是system酌情选择,两者的区别在于Global的credential可以在别的项目中使用,而system的credential只能在本任务中使用。
SSH key 生成方法:
现在本地生成ssh key
ssh-keygen -t rsa -C "email address"
这里的email address替换成自己的email
cat ~/.ssh/id_rsa.pub
将输出的字符串copy
登录gitlab进入ssh key标签页添加sshkey把刚才copy的字符串粘贴即可
使用ssh [email protected]验证
出现welcome to gitLab xxx表示ssh key添加成功
其中id_rsa是默认的路径 ,可以替换成自己的名字
前面提到过如果git plugin的版本过低则会出现如下错误
上面提到我们还引入了github上的第三方库,为了在编译过程中能顺畅的访问github同样要给github添加sshkey ,否则在取第三方库的时候会出现不能连接github的情况。
配置完源代码之后接下来就是配置构建环境。
构建环境的方法有两种,一种是使用xcode插件配置,另一种是直接使用命令行配置,其实两种方法的原理都是一样,只不过使用xcode配置时更直观,命令行直接使用xcodebuild命令配置参数。使用xcode插件来构建时需要上传keychain和配置证书和provisioning profile,这里我们使用命令行的方式来做,直接粗暴!如果使用命令行来做,可以少下载几个插件。
命令行主要使用xcodebuild和xcrun来做。
xcodebuild 的参数包括但不限于以下几个:
-workspace, -target , -configuration, -scheme
在Xcode的product中有许多scheme,-scheme参数用于指定编译时选用哪个scheme
-workspace用于多个工程的情况,尤其是使用了cocopods来管理第三方库时需要设置该参数,举个列子,如果工程中使用了cocopods引入了AFNetworking,在编译时需要加上-workspace参数,否则在链接阶段会报无法链接lAFNetworking.o,使用了workspace需要配合scheme参数,因为使用cocopods集成了第三方控件之后会有多个scheme,所以需要指定一个编译的scheme。
-configuration可以指定编译成Debug还是release。
这些参数都可以在jenkins的xcode插件里配置,需要注意的是不用带后缀,如配置workspace时只需指定AAA即可,不用AAA.xcworkspace,编译器会自动给添加上,但是使用命令行需要自己写后缀。
以下是一段xcodebuild命令的例子:
xcodebuild -scheme Sherlock -workspace Sherlock.xcworkspace -configuration Release build CONFIGURATION_BUILD_DIR=/Users/knight/.jenkins/jobs/Sherlock/workspace/build "CODE_SIGN_IDENTITY=iPhone Developer:xxxx(G2...4M)"
指定code sign identity时要注意唯一性,在keychain中有多个名字一样的证书时,编译过程中会报如下警告:
ambiguous (matches "iPhone Distribution: xxxxxxxx." and "iPhone Distribution:xxxxxxxx" in /Users/knight/Library/Keychains/login.keychain)
编译成功之后是打包ipa,这个过程主要使用xcrun命令,在xcrun过程中会做codesign,用证书给provisioning profile做签名,在此之前需要解锁钥匙串。
xcrun命令举例如下:
xcrun -sdk iphoneos PackageApplication -v /Users/knight/.jenkins/jobs/Sherlock/workspace/build/Sherlock.app -o /Users/knight/Desktop/ipas/Sherlcok_16_2015.11.26.ipa --embed /Users/knight/Desktop/jekinsCI/xcxcxcd.mobileprovision --sign "iPhone Developer: fdafsfdsf (G2…….cC)" --verbose
在打包阶段可能会遇到下面的问题:
error: /usr/bin/codesign --force --preserve-metadata=identifier,entitlements,resource-rules --sign iPhone Distribution:sdfdsfdsfsdffdsfds. --resource-rules=/var/folders/xy/bxy7kp7932jg2cs266dm7prh0000gn/T/2RL2F3s8TI/Payload/Sherlock.app/ResourceRules.plist --entitlements /var/folders/xy/bxy7kp7932jg2cs266dm7prh0000gn/T/2RL2F3s8TI/entitlements_plistFAjhf4Lw /var/folders/xy/bxy7kp7932jg2cs266dm7prh0000gn/T/2RL2F3s8TI/Payload/Sherlock.app failed with error 1. Output:
这个是由于在工程中没有对code sign resource rule path做配置,只要将其配置为$(SDKROOT)/ResourceRules.plist即可,code sign resource rule path在Build settings中设置。
因此要使用命令行来打包可以在构建部分选择Execute Shell
security unlock-keychain -p 'fasfsdf' ~/Library/Keychains/login.keychain
xcodebuild -target Sherlock clean
xcodebuild -scheme Sherlock -workspace Sherlock.xcworkspace -configuration Release build CONFIGURATION_BUILD_DIR=/Users/knight/.jenkins/jobs/Sherlock/workspace/build "CODE_SIGN_IDENTITY=iPhone Developer: dfsadf bfdasin (fdsfsdfdd)"
xcrun -sdk iphoneos PackageApplication -v /Users/knight/.jenkins/jobs/Sherlock/workspace/build/Sherlock.app -o /Users/knight/Desktop/ipas/Sherlcok_16_2015.11.26.ipa --embed /Users/knight/Desktop/jekinsCI/sherlock.mobileprovision --sign "iPhone Developer: dasfsfdf(fdsfdsfsdaf)" --verbose