iOS Jenkins自动化打包上传躺坑记

  一说到自动打包很多人想到的就是jenkins,正好这段时间比较闲,我也研究了一下利用jenkins来自动打包上传蒲公英。
我看到网上有很多写Jenkins的文章,但是我发现我按照网上的文章步骤一步一步去弄还是踩了不少坑,费了不少劲,可能是每个人的项目情况背景不一样,所以碰到的问题,处理问题的方法也不一样吧。Jenkins安装网上有很多教程这里我就不说的,我就说说我自己的项目情况,及我在配置的过程中所遇到的问题及如何解决的。
 所以说这篇文章就建立在你已经装好了jenkins环境的基础上的。

项目情况:

  • cocopods代码管理
  • 码云源码管理
  • 上传蒲公英
  • Xcode9.2
  • 打包用的手动签名
1.新建配置流程

浏览器输入:http://localhost:8080 打开jenkins 输入jenkins账号密码

屏幕快照 2018-01-10 下午3.35.47.png
点新建
屏幕快照 2018-01-10 下午3.37.36.png

输入你的项目名称,选择构建一个自由风格的软件项目,然后确认,你就会来到这个页面:

屏幕快照 2018-01-10 下午3.39.56.png

这里我想特别提一下
屏幕快照 2018-01-10 下午3.47.29.png
    general->源码管理->构建触发器->构建环境->构建->构建后操作 我们在执行构建的时候
是按这个顺序去执行的,所以当我们在构建的过程中只要前面的有错,后面的就不会再执行了,比
如我在源码管理这一块配置错了,那么我在构建的时候源码管理后面的就都不会再执行了,你解决
错误的时候就看源码管理的这块就行,执行到哪里有错我们就解决哪里的问题

一.General配置

general 里面都是一些普通的设置,基本不需要做特殊的处理,但是我们在调试jenkins的过程中可能会构建很多次(比如我调通都构建了两百多次,心塞~~),所以我们可以在选择general 里面选择丢弃旧的构建
屏幕快照 2018-01-10 下午3.44.26.png

到这里General配置基本就这么多。

二.源码管理
源码我们先项目用的是码云的git管理,配置如下:


E91D7454-7873-41A1-A5E3-BD9AB7E23D0E.png

选Git->git仓库地址(URL)->验证(Credentials)->需要拉取的分支带啦(这里我拉取的是master代码),一般我们git管理有两种url地址,一种是git@*****.git格式的,一种是https://****.git。这里我选择的是git@的,这种需要ssh验证,需要添加公钥,私钥。而https则需要我在add那里添加账号密码,但是亲测https的即便添加了账号密码也还是没有克隆下来,一直停留在checking那一步没有动了,后面查资料说https的还要做其它操作,因而我放弃了采用了git ssh验证的方式添加公钥私钥。具体操作如下:
  • 打开终端, 输入命令 cd ~/.ssh 进入.ssh文件下,然后输入:ssh-keygen -t rsa -C "账号",按下来按回车会出现给公钥起名,起过名之后再给公钥设置密码(如果不需要设置密码直接按回车),结果如下:


    C8F46B07-3F9A-4C56-86FC-EAD3427BF877.png

    然后ls ,我们就可以看到.ssh 问价夹下多了test跟test.pub两个文件


    屏幕快照 2018-01-11 上午10.03.09.png
  • 码云配置,登录码云,点设置->SSH公钥,添加标题,然后把刚刚生成的test.pub文件内容粘贴到公钥哪里,确认,到此码云配置就OK了


    B0C39F48-D55A-47EA-A641-768B25DD614D.png
  • jenkins配置。回到jenkins源码管理,为Git添加Credentials。点击Add:


    屏幕快照 2018-01-11 上午10.15.07.png

    Kind选择SSH Username with PrivateKey ,用户名可以自己看着填,将刚刚生成的test 文件内容(即私钥)粘贴到Key里面确认添加。源码管理到目前为止就差不多了,我们从git上下载源码的时候由于网速及其它因素,可能时间会比较长,但是Jenkins默认的克隆过期时间为10分钟,所以我们可以设置长一点,我这里设置了50分钟


    屏幕快照 2018-01-11 上午10.22.02.png

三.构建触发器

屏幕快照 2018-01-11 上午10.39.21.png

我这里设置的是每天6点到18点,每隔一小时检查有没有源码更新构建一次,具体的你可以自己定义,网上有很多相关教程
jenkins构建触发器定时任务Build periodically和Poll SCM【转载】
四.构建环境
这块我都是默认的没有做选择,因为我的xcode配置,证书配置都是根据后面的脚本来完成的

屏幕快照 2018-01-11 上午10.45.00.png

四.构建
点击增加构建步骤,执行脚本


屏幕快照 2018-01-11 上午10.46.04.png

为了方便说明我这里建了两个shell,第一个shell是做pod操作,因为我的代码是cocopods管理的,所以在下载完源码后先要执行pod install ,才能继续后续的打包上传


7D7E7235-98FA-4043-B763-54EF5E2654CE.png

先cd到项目响应目录下,这个目录是Jenkins克隆源代码后的目录,然后执行pod install

 cd "${WORKSPACE}/XZXSchool"
 export LANG=en_US.UTF-8
 /usr/local/bin/pod install

第二个shell是打包上传相关的脚本了

#钥匙串路径  这几句的意思是允许访问钥匙串,因为我们在打包的时候需要访问钥匙串 用里面的证书文件
KEY_PATH="/Users/Shared/Jenkins/Library/Keychains/login.keychain"
/usr/bin/security unlock-keychain -p ***(密码) ${KEY_PATH}
/usr/bin/security set-key-partition-list -S apple-tool:,apple:,codesign: -s -k ***(密码) ${KEY_PATH}
/usr/bin/security set-keychain-settings ${KEY_PATH}
#工程名
APP_NAME="XZXSchool"
#目标名
##
CONFIGURATION="Release"
#证书
CODE_SIGN_DEVELOPER="iPhone Developer: **** (****)"
#info.plist路径
project_infoplist_path="${WORKSPACE}/XZXSchool/XZXSchool/Info.plist"
#取版本号
bundleShortVersion=$(/usr/libexec/PlistBuddy -c "print CFBundleShortVersionString" ${project_infoplist_path})
DATE="$(date +%Y%m%d)"
IPANAME="${APP_NAME}_V${bundleShortVersion}_${DATE}.ipa"
#要上传的ipa文件路径
IPA_PATH="${WORKSPACE}/ipa"
#rm -rf $IPAPATH
#mkdir -pv $IPAPATH
ARCHIVE_NAME="${APP_NAME}.xcarchive"
#workspace路径
WORKSPACE_PATH="${WORKSPACE}/XZXSchool/XZXSchool.xcworkspace"
#echo "+++++++++++++++++clean+++++++++++++++++"
#ExportOptions.plist文件生成,我们可以在Xcode中选好证书,按平时的流程手动打包,打包成功后会有一个ExportOptions.plist文件,我们将这个文件复制到下面这个相应目录下就行,然后我们的jenkins 就会自动打包一个跟我们手动打包的流程一样的IPA包
ExportOptionsPlistPath="${WORKSPACE}/ExportOptions/ExportOptions.plist"
xcodebuild -workspace ${WORKSPACE_PATH} -scheme "${APP_NAME}"  clean
#echo "+++++++++++++++++Build+++++++++++++++++"
xcodebuild -workspace ${WORKSPACE_PATH} -scheme "${APP_NAME}" -sdk iphoneos -configuration 'Release' CODE_SIGN_IDENTITY="${CODE_SIGN_DEVELOPER}" 
#echo "+++++++++++++++++Run+++++++++++++++++"
xcodebuild archive  -workspace ${WORKSPACE_PATH} \
                    -scheme ${APP_NAME} \
                    CFBundleVersion=${bundleShortVersion} \
                    -destination generic/platform=ios \
                    -archivePath ${IPA_PATH}/${ARCHIVE_NAME}\               
xcodebuild -exportArchive -archivePath ${IPA_PATH}/${ARCHIVE_NAME}\
                          -exportPath ${IPA_PATH}\
                          -destination generic/platform=ios\
                          -exportOptionsPlist ${ExportOptionsPlistPath}\
                          -allowProvisioningUpdates
                      



#蒲公英上的User Key

uKey="*****************"

#蒲公英上的API Key

apiKey="*******************"

#蒲公英密码

PASSWORD="********"

#MSG=git log -1 —pretty=%B

#执行上传至蒲公英的命令

echo "++++++++++++++upload+++++++++++++"

curl -F "file=@${IPA_PATH}/XZXSchool.ipa" -F "uKey=${uKey}" -F "_api_key=${apiKey}" -F "updateDescription=${MSG}" -F "password=${PASSWORD}" http://www.pgyer.com/apiv1/app/upload

记住里面所有的路径都是jenkins目录下的项目路径。打包上传脚本大致就是这些。但我们写完后还是发现会报错

  • 问题1
    iOS编译签名文件找不到

Check dependencies
Code Sign error: No codesigning identities found: No codesigning identities (i.e. certificate and private key pairs) that match the provisioning profile specified in your build settings
(“testxxxxx_Distribution_inhouse_01”) were found.

原因是jenkins以jenkins用户身份运行,iOS项目编译用的签名文件要从安装证书时的用户目录
~/Library/MobileDevice/Provisioning Profiles
拷贝到
/Users/Shared/Jenkins/Library/MobileDevice/Provisioning Profiles

  • 问题2
    iOS编译证书找不到

Check dependencies
Code Sign error: No codesigning identities found: No codesigning identities (i.e. certificate and private key pairs) that match the provisioning profile specified in your build settings
(“testxxxxx_Distribution_inhouse_01”) were found.

没找到证书,打开“钥匙串访问”,从“登录”拷贝安装的证书到“系统”下

  • 问题3
    User interaction is not allowed.

Signing Identity: "iPhone Distribution: ****************** Co., Ltd."
Provisioning Profile: "************"

/usr/bin/codesign --force --sign ************************************ --entitlements /Users/Shared/Jenkins/Home/workspace/****/build/**************.build/Release-iphoneos/*************.build/****.***.****--timestamp=none /Users/Shared/Jenkins/Home/workspace/********/build/Release-iphoneos/****.app

/Users/Shared/Jenkins/Home/workspace/*****/build/Release-iphoneos/****.app: User interaction is not allowed.
Command /usr/bin/codesign failed with exit code。

拷贝~/Library/Keychains/login.keychain到
Users/Shared/Jenkins/Library/Keychains/login.keychain

暂时先总结这么多,如果按照步骤还有啥不懂的,有问题的,留言看到我会回复的

推荐阅读更多精彩内容