ios jenkins配置_Jenkins一：iOS自动打包完整实践

后续文章：Jenkins二：参数化构建iOS自动打包

快捷记录：如果jenkins是用dmg安装，因为权限问题不能访问keychain时，每次新添加一个p12文件都要如此，

/Users/管理员用户名/Library/keychains/login.keychain-db

将login.keychain-db复制一份并命名为login.keyain复制到

/Users/Shared/Jenkins/Library/Keychains/login.keychain

同时要在

前言 :

因团队发展涉及到需要把打包工作配置好自动打包后移交给测试团队，网上资料很多，找了几篇文章在我自己的MacBook Pro上跟着一步步安装下来，虽然也遇到几个问题，但很快就找到了解决方案最后成功自动打包成功，于是就在一台专门的打包电脑Mac mini上安装环境，因为都是随机在网上找的资料，结果两次安装环境步骤稍微不一样，第一次是使用homebrew安装的，安装在默认账户下，没遇到什么权限问题，第二次在mac mini上安装使用的是安装包的方式，遇到一系列问题，大部分问题跟权限有关。陆陆续续查找解决构建了200多次，持续了2个周

参考资料：

强烈建议使用homedrew安装会省却很多权限问题，如果用pkg安装包安装，会被权限问题折腾掉半条命

强烈建议二：通过在做Master-Slave配置节点打包时发现使用Tomcat里安装war包的方式安装Jenkins的方式更方便快捷

一、安装jenkins

前提条件：已经安装homedrew、Java

如何在mac上安装java1.8

通过homedrew安装jenkins命令

brew install jenkins

通过homedrew安装后jenkins安装好后所在的位置：

实际安装位置：/usr/local/Cellar/jenkins/

配置文件所在位置：/usr/local/opt/jenkins/

工作空间位置：/Users/用户/.jenkins

进入工作空间位置：cd ~/.jenkins

二、设置开机自启动：

方式一、将启动plist在LaunchAgents创建一个链接镜像(ln是创建一个link的意思)

1.1，创建一个链接到开机启动文件家里

ln -sfv /usr/local/opt/jenkins/*.plist ~/Library/LaunchAgents

1.2：手动启动jenkins

launchctl load ~/Library/LaunchAgents/homebrew.mxcl.jenkins.plist

1.3 手动关闭jenkins

launchctl unload ~/Library/LaunchAgents/homebrew.mxcl.jenkins.plist

1.4 根据需求修改jenkins的启动端口，修改/usr/local/Cellar/jenkins/2.149/homebrew.mxcl.jenkins.plist即可

修改后重新启动可能会报如下错误：

/usr/local/Cellar/jenkins/2.149/homebrew.mxcl.jenkins.plist: Path had bad ownership/permissions

执行以下的两个命令行:

sudo chown root /usr/local/Cellar/jenkins/2.149/homebrew.mxcl.jenkins.plist

sudo chgrp wheel /usr/local/Cellar/jenkins/2.149/homebrew.mxcl.jenkins.plist

方式二(缺点：执行shell的termenal一直在前台运行，不小心关掉了就会停止，有强迫症爱干净的人也不喜欢多一个不能关掉的termenal窗口)

添加一个启动执行的shell文件

2.1：在/usr/local/opt/jenkins创建一个jenkinsBoot.sh文件，内容如下

#!/bin/sh

#默认是8080端口，这里指定为8888端口启动

jenkins --httpPort=8888

2.2：打开系统偏好设置->用户与群组->当前管理员->登录项->+将/usr/local/opt/jenkins/jenkinsBoot.sh加入到这里来

常用默认参数：${WORKSPACE}、${HOME}

查找正在运行的jenkins并关闭：

#查找正在运行的jenkins服务，查看jenkins.war那一行的端口号

ps -ef | grep jenkins

501 82363 22132 0 12:33PM ttys000 0:00.00 grep jenkins

501 926 855 0 Fri06PM ttys002 0:00.00 /bin/sh /usr/local/Cellar/jenkins/2.149/jenkinsBoot.sh

501 xxxx 926 0 Fri06PM ttys002 6:58.53 /usr/bin/java -jar /usr/local/Cellar/jenkins/2.149/libexec/jenkins.war

#关闭jenkins.war那一行的端口号对应的服务

kill -int xxxx

应注意一个读者在配置jenkins环境时，配置keychain时的问题

说明：要jenkins打包iOS的ipa需要苹果系统支持，也就是说安装jenkins的机器是苹果系统或能用jenkins配置一台能访问的苹果系统的电脑作为master机器(本文以默认jenkins所在的机器就是苹果系统)

1、下载发布证书或从开发人员那里拿到导出的发布证书p12

一个苹果证书怎么多次使用——导出p12文件

双击安装证书后，jenkins所在的机器就有发布证书了

login.keychain位置：

/Users/管理员用户名/Library/keychains/login.keychain-db

将login.keychain-db复制一份并命名为login.keyain

描述文件位置：

/Users/管理员用户名/Library/MobileDevice/Provisioning Profiles

(不建议从这里找，因为上传这里的描述文件之后看到的标题也是UUID格式，所以最好单独上传从苹果开发网站下载的描述文件，或者把下面的描述证书拷贝出来改个名再上传)

2、将证书上传到jenkins里

将1中复制的login.keychain上传到这里，如下图所示，

identities：找keychain里这个发布证书的内容

image.png

image.png

#1、切换到jenkins用户下

#[mac终端切换用户](https://blog.csdn.net/doudou19930614/article/details/81410823)

su - Jenkins

#2、创建一个文件夹

mkdir xxx

#3、clone对应的git

git clone xxxxxx

#4、为了不用在每次push到GitHub上时都输入用户名密码

#[mac下git push避免每次都输入用户名和密码的配置](https://www.cnblogs.com/zhaoshunjie/p/6306927.html)

#5、如果有提示需要输入全局的账号和邮箱

# 设置提交代码时的用户信息

git config --global user.name "[name]"

git config --global user.email "[email address]"

#后续其他以jenkins账号操作都正常了

一、使用Jenkins自动打iOS安装包前提条件

1、Mac OS系统(我所使用的是MacBook Pro 和Mac mini)

2、Xcode

3、cocoapods(非必须，如果使用cocoapod管理第三方库才需要)

4、Java

5、sourcetree(git管理工具非必须，我主要用来看代码有没有问题)

6、cornerstone(svn管理工具非必须，我主要用来讲打包的ipa文件上传到SVN上，而不是通常的放到第三方服务器)

7、Jenkins(homebrew安装方式和安装包安装方式两种)

二、使用Jenkins安装包安装方式遇到的问题

1、提示

Failed to connect to repository : Command "git -c core.askpass=true ls-remote -h git@XXXXX:XXXX/XXXX.git HEAD" returned status code 128:

image.png

原因：

由于使用Jenkins安装包安装，不能直接使用http的方式为git地址(why?)，需要切换成ssh地址，ssh地址需要配置秘钥

解决办法：

2、提示

Code Signing Error: No certificate for team 'xxxxx' matching 'iPhone Distribution: xxxxx.' found: Select a different signing certificate for CODE_SIGN_IDENTITY, a team that matches your selected certificate, or switch to automatic provisioning.

原因：

由于使用Jenkins安装包安装，在安装时创建了一个新的用户，默认放在钥匙串里的证书Jenkins这个用户访问不了

解决办法：

将钥匙串下的 登录里的相关证书拷贝到 钥匙串下的 系统里面

3、提示

Run custom shell script '[cp] embed pods frameworks ..... errSecInternalComponent.

/usr/bin/codesign --force --sign DC8791E5F036D9BAAFEC8E347093A20EB435BF0F --preserve-metadata=identifier,entitlements '/Users/Shared/Jenkins/Home/workspace/iOSDev/Release-iphoneos/xxx.app/Frameworks/AFNetworking.framework'

/Users/Shared/Jenkins/Home/workspace/iOSDev/Release-iphoneos/xxx.app/Frameworks/AFNetworking.framework: errSecInternalComponent

Command /bin/sh failed with exit code 1

** BUILD FAILED **

The following build commands failed:

PhaseScriptExecution [CP]\ Embed\ Pods\ Frameworks /Users/Shared/Jenkins/Library/Developer/Xcode/DerivedData/Lottery-dubolgbhbwxukkfsjmthrywdixge/Build/Intermediates.noindex/Lottery.build/Release-iphoneos/xxx.build/Script-79402CD10148DF169F37FF35.sh

(1 failure)

Build step '执行 shell' marked build as failure

[OS X] restore keychains as defined in global configuration

[iOSDev] $ /usr/bin/security list-keychains -s /Users/Shared/Jenkins/Library/Keychains/login.keychain

Finished: FAILURE

image.png

原因一：

解决办法：

看到--force --sign的字样猜测还是权限的问题，于是我把拷贝到钥匙串->系统 下的那个证书设置为 始终信任，顺利解决问题

如果还不可以则：

在xcodebuild -workspace .....前添加一行解锁login.keychain的命令

security unlock-keychain -p 个人的账号登录密码 /Users/Shared/Jenkins/Library/Keychains/login.keychain

原因二：

在要用一个新appleID开发者账号创建一个新target时，电脑的login.kechain-db已经重新生成或者说修改了，但之前配置在Jenkins里的还是旧的，所以需要重新将login.keychain-db复制一份并重命名为login.kehchain上传到Jenkins里忘了在Jenkins配置时Keychains and Provisioning Profiles Management->Keychains

,同时将login.keychain-db、login.keychain拷贝到Jenkins的对应目录下，我的目录为：/Users/xxxx/Library/Keychains -> /Users/Shared/Jenkins/Library/Keychains

4、提示

xcrun: error: unable to find utility "PackageApplication", not a developer tool or in PATH

原因：

新版的Xcode里没有想过的工具库

解决办法：

参考：xcrun: error: unable to find utility "PackageApplication", not a developer tool or in PATH

顺便由于提示warning: PackageApplication is deprecated, use ``xcodebuild -exportArchive`` instead.,这个根据提示替换修改下就好了

5、提示

Build step '执行 shell' marked build as failure

[OS X] restore keychains as defined in global configuration

原因：

Jenkins用户权限比较低，不能使用login.keychain

解决办法：

在xcodebuild -workspace .....前添加一行解锁login.keychain的命令

security unlock-keychain -p 个人的账号登录密码 /Users/Shared/Jenkins/Library/Keychains/login.keychain

6、提示

=== BUILD TARGET xxxx OF PROJECT Lottery WITH CONFIGURATION Release ===

Check dependencies

Code Signing Error: "xxxx" requires a provisioning profile with the Push Notifications feature. Select a provisioning profile for the "Release" build configuration in the project editor.

Code Signing Error: Code signing is required for product type 'Application' in SDK 'iOS 11.4'

** BUILD FAILED **

原因一：

该target的build setting配置不正确，之前是将Code Signing Identity统一配置成iOS Distribution了，这种方式在xcode里手动点击archive打包时没问题，但使用Jenkins自动打包就出报上面的错

image.png

解决办法：

将报错的这个target的build setting设置为精确的描述证书，比如iPhone Distribution: xxxxx,如下图：

image.png

7、提示

error: Unable to create '/Users/admin/Documents/svn/docs/xxxx.ipa'

原因：

这个路径是为了设置将打包出来的ipa安装包自动放到SVN路径下然后自动上传到SVN服务器，但还是由于打包Jenkins用的是一个独立的用户导致的权限问题

解决办法：

将/Users/admin/Documents/svn/docs/这个路径的每一个文件夹都设置为所有用户有读写权限

花了两个周构建几百次的血的教训，建议还是都用homebrew的方式安装少些权限问题

end

配置的参数：

多个scheme的配置

Debug/Release

git分支和tag选择

参数配置的使用页面

完整构建脚本：

# 工程名

APP_NAME="xxxx"

#***************动态配置部分*********************

# 不勾上自动管理证书

CODE_SIGN_DISTRIBUTION="iPhone Distribution: xxxxx"

# 代码文件夹名称,这是由于源码并不在git项目的根目录下

code_folder="xxxx"

#scheme#Info文件名称#保存ipa文件夹

platformParams=(${iOS_PLATFORM//\#/ })

# schema名称

SCHEMECA=${platformParams[0]}

#info.plist文件名称

INFO_FILENAME=${platformParams[1]}

# 输出到svn的文件夹名称

OUT_SVN_FOLDER=${platformParams[2]}

#*************************************

project_path=""

project_infoplist_path="./${code_folder}/Resource/platforms/${INFO_FILENAME}.plist"

#取版本号

bundleShortVersion=$(/usr/libexec/PlistBuddy -c "print CFBundleShortVersionString" "${project_infoplist_path}")

#取build值

bundleVersion=$(/usr/libexec/PlistBuddy -c "print CFBundleVersion" "${project_infoplist_path}")

#取bundleId

bundleId=$(/usr/libexec/PlistBuddy -c "print CFBundleIdentifier" "${project_infoplist_path}")

DATE="$(date +%Y%m%d-%H%M%S)"

#唯一名称ipa、dsYM文件名

UNIQUE_NAME="${APP_NAME}_${SCHEMECA}_${iOS_Release}_V${bundleShortVersion}_${DATE}"

IPANAME="${UNIQUE_NAME}.ipa"

#根据需求定义输入ipa的文件夹位置

PARENT_FOLDER="$HOME/testJenkins/test/study/${OUT_SVN_FOLDER}"

if [ ! -d $PARENT_FOLDER ];then

mkdir -p $PARENT_FOLDER

else

echo dir exist

fi

#要上传的ipa文件路径

IPA_PATH="$PARENT_FOLDER/${IPANAME}"

echo ${IPA_PATH}

echo "${IPA_PATH}">> text.txt

#下面2行是没有Cocopods的用法

#echo "=================clean================="

#xcodebuild -target "${TARGET_NAME}" -configuration 'Release' clean

#

#echo "+++++++++++++++++build+++++++++++++++++"

#xcodebuild -target "${TARGET_NAME}" -sdk iphoneos -configuration 'Release' CODE_SIGN_IDENTITY="${CODE_SIGN_DISTRIBUTION}" SYMROOT='$(PWD)'

#下面2行是集成有Cocopods的用法

echo "=================clean================="

xcodebuild -workspace "./${code_folder}/${APP_NAME}.xcworkspace" -scheme ${SCHEMECA} -configuration "${iOS_Release}" clean

echo "+++++++++++++++++build+++++++++++++++++"

xcodebuild -workspace "./${code_folder}/${APP_NAME}.xcworkspace" -scheme ${SCHEMECA} -sdk iphoneos -configuration "${iOS_Release}" CODE_SIGN_IDENTITY="${CODE_SIGN_DISTRIBUTION}" SYMROOT='$(PWD)' -allowProvisioningUpdates

xcrun -sdk iphoneos PackageApplication "./${iOS_Release}-iphoneos/${SCHEMECA}.app" -o ${IPA_PATH}

#生成dsYM文件

dsymutil "./${iOS_Release}-iphoneos/${SCHEMECA}.app/${SCHEMECA}" -o "${PARENT_FOLDER}/${UNIQUE_NAME}.app.dSYM"

cd "${PARENT_FOLDER}"

if [ ! -d "${UNIQUE_NAME}.app.dSYM" ];then

echo "没有可以压缩的dsYM文件"

else

#压缩dsYM文件

zip -q -r -m -o "${UNIQUE_NAME}.app.dSYM.zip" "${UNIQUE_NAME}.app.dSYM"

#上传dsYM文件到解析平台

#curl -k "https://api.bugly.qq.com/openapi/file/upload/symbol?app_key=xxxxxx&app_id=xxxxxx" --form "api_version=1" --form "app_id=xxxxxx" --form "app_key=xxxxxx" --form "symbolType=2" --form "bundleId=${bundleId}" --form "productVersion=${bundleShortVersion}" --form "channel=xxx" --form "fileName=${UNIQUE_NAME}.app.dSYM.zip" --form "file=@${UNIQUE_NAME}.app.dSYM.zip" --verbose

fi

# 将生成的ipa上传到SVN

#cd "/Users/tony/Documents/svn/docs/svn/"

#svn upgrade

#svn add ${IPA_PATH}

#svn commit -m "add test" ${IPA_PATH}

三、使用homebrew安装方式遇到的问题

二、遇到问题

FATAL: String index out of range: 15

java.lang.StringIndexOutOfBoundsException: String index out of range: 15

at java.lang.String.substring(String.java:1963)

at com.sic.plugins.kpp.provider.KPPBaseProvisioningProfilesProvider.removeUUIDFromFileName(KPPBaseProvisioningProfilesProvider.java:171)

at com.sic.plugins.kpp.model.KPPProvisioningProfile.getProvisioningProfileFilePath(KPPProvisioningProfile.java:76)

at com.sic.plugins.kpp.KPPProvisioningProfilesBuildWrapper.copyProvisioningProfiles(KPPProvisioningProfilesBuildWrapper.java:157)

at com.sic.plugins.kpp.KPPProvisioningProfilesBuildWrapper.setUp(KPPProvisioningProfilesBuildWrapper.java:99)

at hudson.model.Build

AbstractBuildExecution.run(AbstractBuild.java:504)

at hudson.model.Run.execute(Run.java:1794)

at hudson.model.FreeStyleBuild.run(FreeStyleBuild.java:43)

at hudson.model.ResourceController.execute(ResourceController.java:97)

at hudson.model.Executor.run(Executor.java:429)

Finished: FAILURE

这是因为当时没有在Keychains and Provisioning Profiles Management里面上传配置文件导致的，

上传配置文件的方法和上传login.keychain一样，

选择那个配置文件，点击upload，

配置文件存在你电脑的

`/Users/‘电脑用户名称’/Library/MobileDevice/Provisioning Profiles`目录下。

xcrun: error: unable to find utility "PackageApplication", not a developer tool or in PATH

后面根据对比发现新版的Xcode少了这个PackageApplication

先去找个旧版的Xcode里面copy一份过来

放到下面这个目录：

/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/usr/bin/

然后执行命令

sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer/

再执行

chmod +x /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/usr/bin/PackageApplication

遇到问题

Undefined symbols for architecture arm64:

"_OBJC_CLASS_$_XXXX", referenced from:

objc-class-ref in XXXX.o

ld: symbol(s) not found for architecture arm64

clang: error: linker command failed with exit code 1 (use -v to see invocation)

** BUILD FAILED **

原因：

当前target没有把XXXX这个文件的.m文件没有勾选到Target MemberShip中

这种问题特别容易出现在一个项目有多个target的时候

如下：

tmp633006ba.png

解决办法：

将提示的文件勾选到Target MemberShip中

问题：

Warning: unable to build chain to self-signed root for signer "iPhone Distribution: "/Users/Shared/Jenkins/Home/workspace/xxx/Release-iphoneos/xxx.app/Frameworks/AFNetworking.framework: errSecInternalComponent

Command /bin/sh failed with exit code 1

** BUILD FAILED **

如果没有这个插件，先安装插件

Jenkins->Jenkins管理->插件管理->可选插件 输入：Keychains and Provisioning Profiles Management，找到这个插件，然后点击直接安装

tmp316b3fcb.png

原因：

忘记把新添加的p12证书对应的Identity添加到Jenkins->系统管理->Keychains and Provisioning Profiles Management->Add code Signing Identity里，

tmp2cbdfdaa.png

点击：选取文件->Upload->保存

依次将Jenkins所在的机器的login.keychain(/Users/管理员用户名/Library/keychains/login.keychain-db 复制一份改名成成login.keychain)，

需要管理的描述文件xxx.mobileprovision上传保存