iOS+Jenkins自动构建

96
Fionashow
2017.08.11 10:06* 字数 1648

iOS Jenkins自动构建

安装

下载安装Jenkins,直接在官网下载安装,此处不累述,网上很多教程.
可以参考http://www.jianshu.com/p/41ecb06ae95f

配置

登入Jenkins页面

  1. 通过http://localhost:8080打开页面进行配置(如果没有另外指定端口,默认端口是8080)

  2. 如果打不开页面,可能是java环境没有安装,需先安装java环境。

  3. 第一次打开会出现下面错误页面


    Jenkins打开出错

按照提示,找到/Users/Shared/Jenkins/Home/secrets 这个目录,这个目录虽然是共享目录,但是有权限限制的,非Jenkins用户没有读写权限的,需要手动需改权限后才能读,打开initialAdminPassword文件,复制出密码,就可以填到网页上去重置密码了。

安装插件

  1. 安装GitLab插件
    因为我们用的是GitLab来管理源代码,Jenkins本身并没有自带GitLab插件,所以我们需要依次选择 系统管理->管理插件,在“可选插件”中选中“GitLab Plugin”和“Gitlab Hook Plugin”这两项,然后安装。
  2. 安装Xcode插件
    同安装GitLab插件的步骤一样,我们依次选择系统管理->管理插件,在“可选插件”中选中“Xcode integration”安装。
  3. 安装签名证书管理插件
    iOS打包内测版时,需要发布证书及相关签名文件,因此这两个插件对于管理iOS证书非常方便。还是在系统管理->管理插件,在“可选插件”中选中“Credentials Plugin”和“Keychains and Provisioning Profiles Management”安装。
  4. 安装FTP插件
    在系统管理->管理插件,在“可选插件”中选中“Publish over FTP”安装。如果要进行安装包的统一管理,需要用到此插件,将文件上传到指定服务器目录.
  5. fir-plugin
    如果要分发到fir.rm,可以安装此插件,但Jenkins插件库本身不提供此插件,可以到fir.rm官网现在此插件后再安装,提供了对应的指导文档.

其他插件是否需要,主要看实际需求,这里只列明必要插件及主要需要使用到的插件.

系统配置

  1. 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,不要用管理员目录,编译时会因为权限问题不通过.

profiles设置
  1. Xcode Builder设置
    系统管理->系统设置

    其中Keychain path设置 ${HOME}/Library/Keychains/login.keychain
    Keychain password为开机密码


  2. 如果用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下载地址及在以上步骤中添加的用户


构建环境设置

  1. 勾选"Keychains and Code Signing Identities",下拉框选择之前设置好的keychain及签名.


  2. 勾选"Mobile Provisioning Profiles",注意Provisioning profile需和所选的证书一一对应


构建设置

  1. 如果项目中用到cocoapads,需要在构建之前进行安装.
    如果没有安装,编译时会报如下错误.



    选在构建步骤中增加执行如下shell脚本的运行.


#/bin/bash -l
export LANG=en_US.UTF-8
cd ${JENKINS_HOME}/workspace/${JOB_NAME}/KOOCAN-PortalCore
/usr/local/bin/pod install
  1. pod命令不识别


解决方案:在系统管理->系统设置 页面设置PATH的值,获取用户目录下的PATH值并在这里设置


  1. 构建步骤增加xcode


这里的Development Team ID给证书的一致,Keychain通过下拉框选择.

如果*.xcworkspace不在Jenkins的job目录下,需要制定路径.


构建过程中出现的一些问题总结

  1. Jenkins xcodebuild There are no schemes in workspace



    解决:

    • xcode中manage schemess


    • 勾选Shared选项


  1. 报错: 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 将钥匙串的开发证书从登陆拷贝到系统目录

  2. 报错: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的描述文件夹

  3. 文件夹中不包含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。

学习笔记