Jenkins的安装教程我就不描述了,网上可以搜到,直接从安装好Jenkins开始
准备工作:
第一步:插件的安装
去 https://updates.jenkins-ci.org/download/plugins/ 下载两个插件,分别是token-macro.hpi
和xcode-plugin.hpi
。然后进去 系统管理-管理插件-高级选项-上传插件,分别上传token-macro
以及xcode-plugin
,上传完成功之后点击安装插件 Xocde integration
和Workspace Cleanup Plugin
第二步:上传证书
- 去电脑的
~/Library/Keychains
目录下找到login.keychain
文件,copy一份备用(mac的新系统下是login.keychain-db
文件,同样copy一份,将名称改为login.keychain
) - 去苹果开发者中心下载打包需要用到的描述文件(这里我将Development描述文件和Distribution描述文件都下载了)
- 选择 系统管理 - Keychains and Provisioning Profiles Management 然后分别上传刚才准备的钥匙串文件和描述文件。(描述文件需要填写一个Provisioning Profiles Directory Path,这个path填写Jenkins安装目录下的一个固定文件夹就好了,用来保存上传的描述文件)
第三步: 配置从节点
因为我这边是用一台固定的电脑专门来构建项目,所以创建了一个从节点来构建xcode
项目
- 选择 系统管理-节点管理-新建节点 来创建一个节点,输入节点名称,选择固定节点
-
会跳转到一个节点的详情页面
- 描述:自定义
- 执行器数量:2(可以自定义,但是好像不能太多,表示可同时构建项目数量)
- 远程工作目录:path(这个path指从节点主机上的一个固定目录,用来进行项目构建的工作路径,之后
git clone
的一些项目和ipa包我都保存在这里。ps:最好不要直接选择桌面,因为后面我再构建项目的时候选择了clean before build
,可能会将桌面上的文件给清理了) - 标签:自定义
- 用法:我选中的只允许允许绑定到这台机机器的Job
- 启动方式:
Launch agents via SSH
- 主机:从节点主机的ip
- Credentials: 从节点主机的登录用户名和密码(如果没有Credentials可以点击右侧,创建一个)
- Host Key Verification Strategy:
Non verifying Verification Strategy
- 可用性:尽量保持代理在线
- 环境变量:
键 固定为 PATH
值 命令行执行 echo $PATH 来获取 - Provisioning Profiles Directory Path:选择xcode保存描述文件的路径(一般是
/Users/yourComputerName/Library/MobileDevice/Provisioning Profiles
)
然后点击保存
ok,准备工作都做好了,下面开始创建项目进行构建了
-
点击新建任务,输入任务名称,选择构建一个自由风格的项目,单击确定
-
General
描述随意,勾选了限制项目运行节点(因为我这边指定了节点来构建我所有的项目,标签表达式的内容就是从节点的名称)
-
源码管理
Respository URL填写项目的git地址,Credentials
是一个访问git的凭据,如果没有点击下面的添加凭据
当通过ssh方式去访问git的时候需要我们需要生成一个密钥,这个private Key
就是我们生成的私钥内容。(ps:密钥生成参考https://www.jianshu.com/p/416c20adc188)。剩下的按照图示填写就可以了。
-
构建触发器
我这里都是通过手动来构建,所有都没有勾选,如果有自动构建的需要,可自己选择需要的方式。
-
构建环境
构建环境选择钥匙串和描述文件两个选项就够了,钥匙串和描述文件都是前面准备步骤上传的。(只用选择Keychain
和 Provisioning Profile
两个框 ,剩下的自己会生成)
-
构建
如果你的项目使用了CocoaPods
来管理第三方库,在增加构建步骤的地方选择执行shell,这里需要加上脚本来执行 pod install
,如果没有,这一步忽略不计。脚本内容如下:
#bin/bsah - 1
export LANG=en_US.UTF-8
export LANGUAGE=en_US.UTF-8
export LC ALL=en_US.UTF-8
cd ${WORKSPACE}
pod install --no-repo-update)
增加构建步骤选择
xcode
Developmnet Team ID
是证书的team ID,可以在苹果开发者中心查看,或者在电脑钥匙串,右键点击发布证书,显示简介进行查看,勾选Use Legacy Build System
Clean before build
Xcode Schema File
填写项目的Target Name
就行了 ,勾选Generate Archive
- 根据证书类型和自行选择,我这里是企业证书打包,选择的
enterprise
-
.ipa filename
就是打包的ipa命名 -
Output directory
就是ipa文件输入路径,我这里填写的是一个相对路径(${WORKSPACE}
会指向git clone
到本地项目的根目录下)bundleID
是项目的bundleID
,UUID
是我们前面上传描述文件之后生成的一个UUID
,可以在 系统管理-Keychains and Provisioning Profiles Management 里查看
Keychain path
就是我们之前copykeychain
文件的路径(不出意外应该和我这个一样),密码就是电脑访问钥匙串的密码
接下来这张图,如果你的项目没有使用Cocoapods
或者你的项目的.xcodeproj
文件在项目的根目录下就可以忽略掉
CocoaPods
-
Xcode Workspace File
: 项目的.xcworkspace
文件名称(不用带后缀) -
Build output directory:
ipa的输出目录,和上面ipa的输入路径填写一样就行了
2. 项目的.xcodeproj
文件不在项目的根目录下(嵌套了多层)
需要再xcode Project File
中指定到项目的.xcodeproj
文件才可以:${WORKSPACE}/第一层/第二层/yourProjectName.xcodeproj