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地址，如git@gitlab.xxx.git,然后填写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 -Tgit@gitlab.xxxx.com验证
出现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
网友评论