iOS持续集成—Jenkins(最新最全)

搭建Jenkins前,请确认mac系统上已经搭建好了Java环境。
从零开始一步一步构建,遇到了很多坑,好在最终success了。

一、 搭建Jenkins

1. 安装Jenkins

从官网上下载pkg安装包

这里以jenkis-2.73.3.pkg包为例

安装完成后,Safari可能会自动打开,如果没有自动打开,打开浏览器,输入http://localhost:8080
如果页面提示不能连接服务器的错误,重启电脑。然后再输入http://localhost:8080进入登录页面。
根据提示,找到/Users/Shared/Jenkins/Home/ 这个目录,找到secrets文件,显示简介,设置所有人都可以读与写的权限,并找到initialAdminPassword文件,同样放开权限,复制出密码,登录进去,一路安装过来,输入用户名、密码、邮件等。最后点击Save and Finish。

注意:如果安装之后发现密码忘记了,从initialAdminPassword文件中复制输入也错误,试了很多方法也不管用,那就卸载重装Jenkis然后重启电脑吧。

2. 拷贝文件

2.1

将/Users/用户名/Library的MobileDevice文件夹拷贝到/Users/Shared/Jenkins/Library下

注意:是将MobileDevice这个文件夹拷贝过去,而不是MobileDevice里的文件,/Users/Shared/Jenkins/Library 目录下是没有MobileDevice这个文件夹,所以先创建一个MobileDevice文件夹。

在终端输入:

sudo mkdir /Users/Shared/Jenkins/Library/MobileDevice
sudo cp -r /Users/xxx/Library/MobileDevice/ /Users/Shared/Jenkins/Library/MobileDevice/

注意:曾遇到/Users/xxx/Library/下没有MobileDevice文件夹,原来是新机上没有安装Xcode。

2.2

将/Users/用户名/Library/Keychains/下的login.keychain及login.keychain-db这两个文件拷贝到/Users/Shared/Jenkins/Library/Keychains文件夹下面

注意:Mac OS 10.12以下的没有login.keychain-db这个文件,只需要拷贝login.keychain文件。

在终端输入:

cd /Users/Shared/Jenkins/Library/
sudo mkdir Keychains
sudo cp /Users/xxx/Library/Keychains/login.keychain ./Keychains/
sudo cp /Users/xxx/Library/Keychains/login.keychain-db ./Keychains/

再将这个login.keychain拷贝到桌面上

在终端输入:

sudo cp /Users/jiekangwei/Library/Keychains/login.keychain ~/Desktop/

注意:如果/Users/xxx/Library/Keychains/目录下没有login.keychain这个文件,就复制login.keychain-db文件到指定目录,然后将复制在桌面上的该文件改后缀为.keychain。

3. 钥匙串权限、~/Library权限以及电脑用户管理权限

3.1

打开钥匙串,找到相应的证书

右键密钥显示简介,在访问控制那一项里勾选允许所有应用程序访问此项目,并存储更改。

iOS持续集成—Jenkins(最新最全)_第1张图片

3.2

找到Library资源库文件夹,设置共享与访问权限,everyone读与写都可以


iOS持续集成—Jenkins(最新最全)_第2张图片

3.3

进入mac系统偏好设置 — 用户与群组 — 其他用户 — jenkins ,勾选允许用户管理这台电脑,并右键选择高级选项,将名字改为jenkins

4. Jenkins插件及系统设置

进入管理插件,在可选插件里所有关键字,下载安装插件Keychains and Provisioning ProfilesManagement和 Xcode integration

4.1

iOS持续集成—Jenkins(最新最全)_第3张图片

选取拷 在桌上login.keychain以及项 相对应的Provisioning Profile 并upload

注意:开发证书和provision profile 一定要对应正确,不然命令行打包会认证不了而失败

iOS持续集成—Jenkins(最新最全)_第4张图片

password 一定要填写正确的钥匙串的密码

Code Signing Identity 是从钥匙 找到相应的证书,然后显示简介复制 来,这 Identities 少要填 两项,是因为这 放 个的话后 的设置 Code Signing Identity 能 动对应上。

iOS持续集成—Jenkins(最新最全)_第5张图片

Provisioning Profiles Directory Path 这 项 填写/Users/用户名/Library/ MobileDevice/Provisioning Profiles

注意:路径里Provisioning Profiles是Provisioning\ Profiles

点击Save

4.2

安装完Xcode integration后进 系统设置。

Xcode Builder

填写钥匙串密码

iOS持续集成—Jenkins(最新最全)_第6张图片
5. 新建

5.1

填写名字,选择构建自由风格,点击ok


iOS持续集成—Jenkins(最新最全)_第7张图片

进入Project,进入配置

iOS持续集成—Jenkins(最新最全)_第8张图片

5.2

General

项目名称,这里可以和git项目名称一样,也可以另起一个名称。

iOS持续集成—Jenkins(最新最全)_第9张图片

5.3

源码管理

选择git,然后在Repository URL 上填写git仓库地址


iOS持续集成—Jenkins(最新最全)_第10张图片

选择add

选择SSH Username with private key
Username 为上传到git的用户名,Private Key从id_rsa文件里复制出来


iOS持续集成—Jenkins(最新最全)_第11张图片

5.4

构建触发器,可选填

iOS持续集成—Jenkins(最新最全)_第12张图片

5.5

构建环境

选择Keychains andProvisioning Profiles Management和Mobile Provisioning Profiles


iOS持续集成—Jenkins(最新最全)_第13张图片

Code Signing Identity 第一次不能自动显示出来没关系,保存,然后第二次进来就自动选上了。

5.6

构建

有两种打包方式,一是用Xcode打包,而是用Shell脚本打包,当Xcode版本为9或者以上,应该使用Shell脚本打包。

因为 Xcode 9 默认不允许访问钥匙串的内容,必须要设置 allowProvisioningUpdates 才会允许,但是由于 Xcode integration 插件封闭,并不能对其进行修改加上这个属性,所以使用 Shell 脚本代替插件。

5.6.1
这里先介绍Xcode打包,项目使用的是Xcode 8.1

iOS持续集成—Jenkins(最新最全)_第14张图片

General build settings

这里Target请于Xcode项目中Target的名字对应
Clean before build设置为YES
Configuration选择Release)
Output directory为.ipa的输出路径,可选填

iOS持续集成—Jenkins(最新最全)_第15张图片
iOS持续集成—Jenkins(最新最全)_第16张图片
Code signing & OS X keychain options

teamId 为对应证书括号里面有,如果没找到,请在苹果开发网站登陆进去,从Membership上查看。选择Unlock Keychain,填写钥匙串密码

iOS持续集成—Jenkins(最新最全)_第17张图片
Advanced Xcode build options

Xcode Schema Files 填写Xcode项目的schema
因为项目含有Workspace,所以填写Xcode Workspace File,填写该项目xcworkspace文件的绝对路径
Build output directory 填写${WORKSPACE}/build/ ,这里注意是大括号


iOS持续集成—Jenkins(最新最全)_第18张图片

打开工程,mange schemes,勾选项目schemes对应的shared,该scheme为填写的Xcode Schema Files的内容


iOS持续集成—Jenkins(最新最全)_第19张图片

ok,点击保存,使用Xcode构建配置完毕

5.6.2

选择Execute shell 打包


iOS持续集成—Jenkins(最新最全)_第20张图片

command 写入脚本:

xcodebuild clean -workspace 工程名称.xcworkspace -scheme 工程名称 -configuration Release

xcodebuild archive -workspace 工程名称.xcworkspace -scheme 工程名称 -archivePath 工程名称.xcarchive

xcodebuild -exportArchive -archivePath 工程名称.xcarchive -exportOptionsPlist /Users/用户名/ExportOptions.plist -allowProvisioningUpdates -exportPath ./

ExportOptions.plist 注意大小写,先打包工程,将ExportOptions.plist文件拷贝到/Users/用户名/或者指定的目录,记得脚本中/Users/用户名/ExportOptions.plist 对应的是该文件的路径。

iOS持续集成—Jenkins(最新最全)_第21张图片

iOS持续集成—Jenkins(最新最全)_第22张图片

iOS持续集成—Jenkins(最新最全)_第23张图片

iOS持续集成—Jenkins(最新最全)_第24张图片

Next ,然后Export


iOS持续集成—Jenkins(最新最全)_第25张图片

iOS持续集成—Jenkins(最新最全)_第26张图片

6. 上传

这里把项目上传到fir.im平台为例

之前选择使用命令行

但遗憾的是用终端安装fir-cli总是失败,于是就选择使用fir.im插件

这里选择使用fir.im插件, 进入 官网下载,下载jenkins插件

iOS持续集成—Jenkins(最新最全)_第27张图片

然后进入Jenkins,选择插件管理 — 高级

iOS持续集成—Jenkins(最新最全)_第28张图片

选择下载好的fir-plugin-1.9.5.hpi,上传并安装完后

进入项目的配置页面,在构建后操作里选择Upload to fir.im,填写fir.im token


iOS持续集成—Jenkins(最新最全)_第29张图片

好了,点击保存,立即构建吧

如果构建时后台打印出以下信息,恭喜你,你构建成功了


iOS持续集成—Jenkins(最新最全)_第30张图片

二、配置Jenkins错误

1、 拷贝文件错误

Failed to copy /Users/Shared/Jenkins/Home/kpp_upload/xxxx.mobileprovision to /Users/xxx/Library/MobileDevice/Provisioning Profiles/xxxx.mobileprovision

解决:文件拷贝失败。1.查看Library读写权限是否开放;2. 查看系统管理 — Keychains and Provisioning Profiles Management,查看Provisioning Profiles Directory path 是否有误

2、 证书文件找不到

Check dependencies Code Sign error: No matching provisioning profile found: Your build settings specify a provisioning profile with the UUID “75025357-245d-448b-9343-96148a0xxxxx”, however, no such provisioning profile was found.

解决:将/Users/管理员用户名/Library下的MobileDevice文件夹拷贝到/Users/Shared/Jenkins/Library下面

security: SecKeychainUnlock login.keychain: The user name or passphrase you entered is not correct. FATAL: Unable to unlock the keychain.

解决:确认钥匙串密码是正确的

4、 pod没有权限

/Users/xxx/workspace/xxxx/Pods/Target Support Files/Pods-xxxx/Pods-xxxx-resources.sh: line 7: /Users/xxx/workspace/xxxx/Pods/resources-to-copy-DiscoverPanjin.txt: Permission denied

解决:在终端打开项目目录并输入 sudo chmod 777 Pods

5、 使用fir插件上传失败

ERROR: Can not found mapping or dysm file in /Users/Shared/Jenkins/Home/jobs/xxxx/workspace. Deployment failed : Error while get details for update id = xxxxx Build step 'Upload to fir.im' marked build as failure

解决:fir插件版本过低,使用最新fir插件试试

6、使用命令行上传失败

fir p/Users/Shared/Jenkins/Home/jobs/xxx/workspace/build/xxx.ipa -T 4dc6d4c3ebe1969b3c76353514xxxxx /Users/Shared/Jenkins/tmp/jenkins3233517671203652013.sh: line 2: fir: command not found Build step 'Execute shell' marked build as failure

解决:没有安装fir-cli命令

7、

Will not set default: file /Users/Shared/Jenkins/Library/Keychains/login.keychain-db is owned by UID=0, but we have UID=262 security: SecKeychainSetDomainDefault user: write permissions error

解决:进入mac 系统偏好设置 — 用户与群组 — 其他用户 — jenkins ,勾选允许用户管理这台电脑

8、

FATAL: Failed to mkdirs: /Users/xxx/Desktop/ipa java.io.IOException: Failed to mkdirs: /Users/xxx/Desktop/ipa

解决:Output directory 路径错误

9、

FATAL: Build directory does not exist at /$(WORKSPACE)/build. Potential configuration issue. Build step 'Xcode' marked build as failure

解决:Build output directory 填写错误,正确为${WORKSPACE}/build

10、

== Available schemes [workspace] $ /usr/bin/xcodebuild -list -workspace /Users/xxx/workspace/xxxx.xcworkspace xcodebuild: error: '/Users/xxx/workspace/xxxx.xcworkspace' does not exist.

解决:Xcode Workspace File 路径错误

11、

rror Domain=IDEProfileLocatorErrorDomain Code=1 "No profiles for 'xxxxxxx' were found" UserInfo={NSLocalizedDescription=No profiles for 'xxxxxxx' were found, NSLocalizedRecoverySuggestion=Xcode couldn't find any iOS Ad Hoc provisioning profiles matching 'xxxxxxx'. Automatic signing is disabled and unable to generate a profile. To enable automatic signing, pass -allowProvisioningUpdates to xcodebuild.

解决:打包工程导出ipa时选择手动选择证书

12、

+ xcodebuild -exportArchive -archivePath /xxx.xcarchive -exportPath -exportOptionsPlist /Users/xxx/exportOptionsPlist.plist
xcodebuild: error: The flag -exportOptionsPlist is required when specifying -exportArchive.
Build step 'Execute shell' marked build as failure

解决:拷贝到指定路径的ExportOptions.plist 名称大小写错误

13、

create and update profiles, app IDs, and certificates. For manually signed targets, xcodebuild will download missing or updated provisioning profiles. Requires a developer account to have been added in Xcode's Accounts preference pane. -allowProvisioningDeviceRegistration Allow xcodebuild to register your destination device on the developer portal if necessary. This flag only takes effect if -allowProvisioningUpdates is also passed. Build step 'Xcode' marked build as failure

解决:脚本上缺少allowProvisioningUpdates这一句

14、

$ /usr/bin/xcodebuild -scheme xxxx -workspace /Users/用户名/workSpace/xxxx/xxx.xcworkspace -configuration Release clean archive -archivePath "/Users/Shared/Jenkins/Home/workspace/xxx/build/xxxx.xcarchive" "BUILD_DIR=/Users/Shared/Jenkins/Home/workspace/xxx/build/" DEVELOPMENT_TEAM=EFL2T3NT3W -exportArchive -exportPath /Users/Shared/Jenkins/Home/workspace/xxx/build/ -exportOptionsPlist /Users/xxx/options.plist
xcodebuild: error: The flag -scheme cannot be specified along with -exportArchive.

或者

[iOS Panjin] $ /bin/sh -xe /Users/Shared/Jenkins/tmp/jenkins410183735701877848.sh
+ echo '================= Clean一下 ================='
================= Clean一下 =================
+ xcodebuild clean -workspace .xcworkspace -configuration -target
xcodebuild: error: If you specify a workspace then you must also specify a scheme.  Use -list to see the schemes in this workspace.
Build step 'Execute shell' marked build as failure
Build step 'Xcode' marked build as failure

或者:

[iOS xxx] $ /bin/sh -xe /Users/Shared/Jenkins/tmp/jenkins8239787762841783385.sh
+ xcodebuild clean -workspace .xcworkspace -scheme -configuration
xcodebuild: error: '.xcworkspace' does not exist.
Build step 'Execute shell' marked build as failure

或者:

+ xcodebuild -exportArchive -archivePath /xxx.xcarchive -exportOptionsPlist /Users/xxx/ExportOptions.plist -allowProvisioningUpdates -exportPath ./
error: archive not found at path '/xxx.xcarchive'
Build step 'Execute shell' marked build as failure

解决:用脚本构建时,脚本输写有误

15、

+ xcodebuild -exportArchive -archivePath xxxx.xcarchive -exportOptionsPlist /Users/xxx/ExportOptions.plist -allowProvisioningUpdates -exportPath ./
error: archive not found at path '/Users/Shared/Jenkins/Home/workspace/xxx/xxx.xcarchive'
** EXPORT FAILED **

Build step 'Execute shell' marked build as failure

解决: /Users/Shared/Jenkins/Home/workspace/ 下.xcarchive 文件名称有误,或者.xcarchive文件路径有误

16、

Error Domain=IDECodesignResolverErrorDomain Code=1 "No certificate for team 'xxxxx' matching 'DB8C944F71D475DE773696BD637xxxxxxx' found" UserInfo={IDEProvisioningError_UserInfoKey_IDEProvisioningErrorSpecifier=DB8C944F71D475DE773696BD6374C5xxxxx, NSLocalizedDescription=No certificate for team 'xxxxx' matching 'DB8C944F71D475DE773696BD6374C5BBxxxxxxx' found, NSLocalizedRecoverySuggestion=Specify a different signing certificate for "signingCertificate" in your Export Options property list., IDEProvisioningError_UserInfoKey_IDEProvisioningErrorTeam=, IDEProvisioningError_UserInfoKey_IDEProvisioningErrorPlatform=com.apple.platform.iphoneos, IDEProvisioningError_UserInfoKey_IDEProvisioningErrorAction=5}

解决:keychains下的provisioning profile 对应不上 certificate证书,把钥匙串相应的证书删掉,重新从苹果商店下载证书和provisioning profile,在Jenkis —系统设置— Keychains and Provisioning Profiles Management插件里全部删除,执行前文 2、拷贝文件 操作,然后upload新的login.keychain和provisioning profile

关注微信公众号:iOSSir,每日更新苹果资讯、技术干货!


iOS持续集成—Jenkins(最新最全)_第31张图片
公众号二维码.jpg

原文地址:https://www.jianshu.com/p/9cb3d8c8c78d

你可能感兴趣的:(iOS持续集成—Jenkins(最新最全))