iOS Jenkins自动构建
安装
下载安装Jenkins,直接在官网下载安装,此处不累述,网上很多教程.
可以参考http://www.jianshu.com/p/41ecb06ae95f
配置
登入Jenkins页面
通过http://localhost:8080打开页面进行配置(如果没有另外指定端口,默认端口是8080)
如果打不开页面，可能是java环境没有安装，需先安装java环境。
-
第一次打开会出现下面错误页面
Jenkins打开出错
按照提示，找到/Users/Shared/Jenkins/Home/secrets 这个目录，这个目录虽然是共享目录，但是有权限限制的，非Jenkins用户没有读写权限的,需要手动需改权限后才能读,打开initialAdminPassword文件，复制出密码，就可以填到网页上去重置密码了。
安装插件
- 安装GitLab插件
因为我们用的是GitLab来管理源代码，Jenkins本身并没有自带GitLab插件，所以我们需要依次选择 系统管理->管理插件，在“可选插件”中选中“GitLab Plugin”和“Gitlab Hook Plugin”这两项，然后安装。 - 安装Xcode插件
同安装GitLab插件的步骤一样，我们依次选择系统管理->管理插件，在“可选插件”中选中“Xcode integration”安装。 - 安装签名证书管理插件
iOS打包内测版时，需要发布证书及相关签名文件，因此这两个插件对于管理iOS证书非常方便。还是在系统管理->管理插件，在“可选插件”中选中“Credentials Plugin”和“Keychains and Provisioning Profiles Management”安装。 - 安装FTP插件
在系统管理->管理插件，在“可选插件”中选中“Publish over FTP”安装。如果要进行安装包的统一管理,需要用到此插件,将文件上传到指定服务器目录. - fir-plugin
如果要分发到fir.rm,可以安装此插件,但Jenkins插件库本身不提供此插件,可以到fir.rm官网现在此插件后再安装,提供了对应的指导文档.
其他插件是否需要,主要看实际需求,这里只列明必要插件及主要需要使用到的插件.
系统配置
-
Keychains and Provisioning Profiles Management配置
系统管理->Keychains and Provisioning Profiles Management,进入Keychains and Provisioning Profiles Management页面，点击“浏览”按钮，分别上传自己的keychain和证书。
上传成功后，我们再为keychain指明签名文件的名称。点击“Add Code Signing Identity”，最后添加成功后如下图所示：
Keychains配置
Keychain其实在/Users/管理员用户名/Library/Keychains 目录下,名字为login.keychain或login.keychain-db(名字的差异跟mac系统版本有关). 如果上传login.keychain-db文件提示文件不匹配类似错误时,可以将login.keychain-db名称改为login.keychain后上传.当把这个Keychain设置好了之后，需要手动做一些拷贝动作:将这个Keychains拷贝到/Users/Shared/Jenkins/Library/Keychains这里，(Library是隐藏文件)。MobileDevice文件也直接拷贝到/Users/Shared/Jenkins/Library/MobileDevice文件目录下(实际是拷贝对应目录下的Provisioning Profiles)。
注意: Provisioning Profiles设置路径时指定/Users/Shared,不要用管理员目录,编译时会因为权限问题不通过.
-
Xcode Builder设置
系统管理->系统设置
图
其中Keychain path设置 ${HOME}/Library/Keychains/login.keychain
Keychain password为开机密码
如果用git下载代码,配置private key.
举例中是用的码云管理代码.
- sudo su - jenkins //切换到jenkins用户
- mkdir .ssh
-
ssh-keygen -t rsa //生成 ssh key,复制 xxx.pub 公钥到 git 服务器上即可
码云添加公钥
在Jenkins管理页面，选择“Credentials”，然后选择“Global credentials (unrestricted)”，点击“Add Credentials”，如下图所示，我们填写自己的SSH信息，Private Key选择第三个"From the Jenkins master ~/.ssh",然后点击“Save”，这样就把SSH添加到Jenkins的全局域中去了。
完成以上步骤,就基本完成了Jenkins的设置,接下来就是创建工程了.
创建工程
工程创建跟普通Jenkins工程一致,这里主要提出需要特别注意的点.
git代码库位置设置
填写git下载地址及在以上步骤中添加的用户
构建环境设置
-
勾选"Keychains and Code Signing Identities",下拉框选择之前设置好的keychain及签名.
-
勾选"Mobile Provisioning Profiles",注意Provisioning profile需和所选的证书一一对应
构建设置
-
如果项目中用到cocoapads,需要在构建之前进行安装.
如果没有安装,编译时会报如下错误.
选在构建步骤中增加执行如下shell脚本的运行.
#/bin/bash -l
export LANG=en_US.UTF-8
cd ${JENKINS_HOME}/workspace/${JOB_NAME}/KOOCAN-PortalCore
/usr/local/bin/pod install
-
pod命令不识别
解决方案:在系统管理->系统设置 页面设置PATH的值,获取用户目录下的PATH值并在这里设置
-
构建步骤增加xcode
这里的Development Team ID给证书的一致,Keychain通过下拉框选择.
如果*.xcworkspace不在Jenkins的job目录下,需要制定路径.
构建过程中出现的一些问题总结
-
Jenkins xcodebuild There are no schemes in workspace
解决:
-
xcode中manage schemess
-
勾选Shared选项
-
报错: No signing certificate "iOS Development" found: No "iOS Development" signing certificate matching team ID "28SDX923G4" with a private key was found.
解决:https://stackoverflow.com/questions/41617743/jenkins-error-no-signing- certificate 将钥匙串的开发证书从登陆拷贝到系统目录报错:No profiles for 'com.sowell-tech.ShareSDKDemo.HelloWord' were found: Xcode couldn't find a provisioning profile matching 'com.sowell-tech.ShareSDKDemo.HelloWord'.
解决:1.保证teamID填写正确 2.将工程本身的描述文件复制到Jenkins的描述文件夹文件夹中不包含project 或 workspace文件
报错:xcodebuild: error: The directory /Users/Shared/Jenkins/Home/workspace/Demo1 does not contain an Xcode project or workspace.
解决:在构建步骤,Advanced Xcode build options设置Xcode Workspace File的值,值为 *.xcodeproj的绝对路径,不需要后缀.
重命名打包文件+版本号
#/bin/bash -l
export LANG=en_US.UTF-8
# app重命名
plist=${JENKINS_HOME}/workspace/${JOB_NAME}/KOOCAN-PortalCore/KOOCAN-PortalCore/Info.plist
buildver=$(/usr/libexec/PlistBuddy -c "Print CFBundleShortVersionString" "${plist}")
date=`date +"%Y%m%d"`
# 上传到蒲公英
cd ${WORKSPACE}/build
mv `find . -name *_Release.ipa |awk -F '/' '{print $2}'` `find . -name *_Release.ipa | awk -F '/' '{print $2}' | awk '{print substr($0,0,length-12)}'`_${buildver}_${date}_Release.ipa
APPNAME=`find . -name *_Release.ipa`
echo "APPNAME=${APPNAME}"
curl -F "file=@${APPNAME}" -F "uKey=*" -F "_api_key=*" https://qiniu-storage.pgyer.com/apiv1/app/upload
jenkins管理员用户忘记密码
打开JENKINS_HOME/config.xml文件，修改<useSecurity>true</useSecurity>的值为false，然后重新启动Jenkins.
命令如下：
停止Jenkins：sudo launchctl unload /Library/LaunchDaemons/org.jenkins-ci.plist
启动Jenkins: sudo launchctl load /Library/LaunchDaemons/org.jenkins-ci.plist
重新启动后不需要账号密码可以登陆Jenkins。
