iOS自动化打包分发
为什么要自动化
- 节省时间,快速迭代: 减少重复繁琐的过程,本地继续编码,使用工具自动拉取远程库代码后打包
- 纠错: 打包出错,会自动查找到编译错误
- 快速分发多个版本: 配置好不同分支的打包策略,可以将打包任务移交测试,分工更明确
工具
- Jenkins CI
- Flow CI
- Travis CI
- Hudson CI
- Circle CI
本文只关注 Jenkins 的使用
Jenkins 的三种安装方式
- war
- pkg
- homebrew
推荐使用 homebrew
jenkins 安装
1、正确安装Homebrew的方式
2、安装: brew install jenkins
3、终端启动命令: jenkins
4、浏览器访问jenkins地址: http://localhost:8080/ , 如果不能正常访问,要么Java环境出问题,要么jenkins没有启动; Java环境的去官网下载最新的jdk安装;jenkins开关命令
5、 正常的浏览器启动页面是如下的
根据提示修改文件夹权限,获取密钥,登录jenkins
6、安装插件 ,Jenkins功能很多以来相应的插件,简化了接入的难度
最好先跳过这一步,因为电脑环境问题,有些插件是需要翻墙安装,所以导致jenkins安装插件的时候,会卡在一个地方,然后就一直卡着,我安装过多次jenkins,因为这个问题,我习惯于跳过插件安装,先登录配置好环境,然后再手动安装插件!!!!!!!!!
如果出现一只卡死在安装插件的界面,关机重启,重新启动Jenkins后,登录http://localhost:8080 进入管理员注册页面
7、 管理员注册
要牢记这个名称,如果是自己测试用,直接用 admin admin 这种更简单的组合.
8、 进入首页,首先将需要安装的插件 再次补充全
需要的插件如下
-
Git,Gitlab,SVN,SSH Credentials用于授权后拉取远程库的代码 -
Keychains and Provisioning Profiles Management: 证书与描述文件的管理 -
Xcode integrationXcode打包的插件,所以iOS的打包只能部署在Mac系统 -
Cocoapods如果项目使用了cocoapod插件 来获取依赖库 -
Mailer Plugin用来发送通知邮件 -
fir-plugin用来将ipa包分发到fir.im上面,或者使用蒲公英(只能是脚本)也可以 -
Post-Build Script Plug-in脚本插件
9、配置项目的访问ssh私钥
根据图上的路径
添加SSH的私钥, 一般你项目的访问私钥是 ~/.ssh/id_rsa 这个文件,如果没有配置,则询问你的源代码的管理员
如果私钥是错误的,则配置项目的时候会出现下面的错误
所以务必要明白,项目的私钥是如何配置的. 需不需要口令码!!!
如果是公司项目,询问运维,当然一般运维会搭建jenkins(iOS必须要在Mac电脑上面搭建,如果是给JAVA使用,一般用linux,不能打包iOS).
自己的项目,不论是在Coding,Github,Gitlab 都可以在页面上查找对应的SSH添加,以明确将要在jenkins使用的ssh私钥是什么
10、配置项目依赖的证书与描述文件
进入后的界面是
主要有两个步骤,
①是 上传钥匙串的 login.keychain , mac地址~/Library/Keychains/
② 设置参数
注意 证书的名称就是本机钥匙串,安装后的证书简介的 常用名称
描述文件的地址 一般是 ~/Library/MobileDevice/Provisioning Profiles
不过我多次尝试 发现配置项目的时候 并没有得到描述文件,后面只能用脚本自己打包的
11、创建新的项目
选择项目的类型
进入项目的配置页面
丢弃旧的构建 ,可以自己定义策略
设置 源码的 拉取, 这一步 主要是可能卡在 私钥的配置上面,所以一定要明确SSH的配置(见上面的说明)
构建触发器 , 这里主要是 定时去 自动化打包项目
构建环境, 主要配置的是 证书与描述文件
下面是正确的环境链接在此,我不知道是不是xcode8之后才有的这问题,还是我使用homebrew确实获取不到.
Xcode的配置
具体配置
钥匙串 选择配置好的钥匙串
其他的编译打包参数 , 如果使用了cocoapods还需要指定具体的一些参数,并且执行脚本,拉取依赖的远程库
最最重要的来了,打包的脚本
如果使用了 cocoapods 则需要提供拉取依赖库的代码 否则请忽略这一步(比如我们叮叮暂时没有)
分别是 指定这是一个脚本(截图有问题,应该是#bin/bash -l), podfile文件的 中文格式编码, 切换到podfile的路径下,拉取依赖的pod
具体的代码如下
脚本① 样本 xcodebuild -workspace "demo.xcworkspace" -sdk iphoneos -scheme "targetName" -configuration 'Release Adhoc' CODE_SIGN_IDENTITY="keychain中证书代号名称" SYMROOT='$(PWD) 这里 -workspace "demo.xcworkspace"是使用cocoapods的样本, 没有使用就像下面的 -project "project的路径"
if [ -d "${WORKSPACE}/builds" ]; then rm -rf ${WORKSPACE}/builds; fi;
mkdir ${WORKSPACE}/builds;
if [ -d "${WORKSPACE}/builds/${BUILD_NUMBER}" ]; then rm -rf ${WORKSPACE}/builds/${BUILD_NUMBER}; fi;
mkdir ${WORKSPACE}/builds/${BUILD_NUMBER};
xcodebuild -project ${WORKSPACE}/ProjectName/ProjectName.xcodeproj
-scheme "ProjectName"
-sdk iphoneos
archive -archivePath ${WORKSPACE}/builds/${BUILD_NUMBER}/archive
CODE_SIGN_IDENTITY="iPhone Developer: xxxx"
注意 scheme 一定还要勾选 分享
并且注意 不同的打包method 要对应好.
脚本② xcodebuild官方文档
xcodebuild -exportArchive
-archivePath ${WORKSPACE}/builds/${BUILD_NUMBER}/archive.xcarchive
-exportOptionsPlist ${WORKSPACE}/ProjectName/ProjectName/ExportOptions_development.plist
-exportPath ${WORKSPACE}/builds/${BUILD_NUMBER}/${JOB_NAME}_${BUILD_NUMBER}.ipa
PROVISIONING_PROFILE="iPhone Developer: xxxx"
这里有一个注意点 就是 exportOptionsPlist ,需要自己在项目中配置 相应的信息
一切顺利就可以正常打包了
后面就是打包后 上传到 fir.im或者是蒲公英 给测试团队 .
还有就是 邮件通知
12、 正常使用
点击进入控制台输出,查看运行的细节
团队的使用
1、 设置一个 局域网的固定访问地址
公司内其他同事就可以通过这个地址,访问jenkins 自己去配置项目,进行打包
2、 设置jenkins运行电脑的安装工作目录 为 分享目录
同事可以通过Finder 访问共享的电脑,找到manajay名称的电脑,选择连接,可以设置密码,我直接让同事可以以客人的身份,无密码访问jenkins下的 workspace目录.
这样即使 上传失败,自己可以获取到ipa包,自己分发.
3、 jenkins 设置成,开机自启的程序 brewed-jenkins小插件
补充另一种打包方式 fastlane
如果你的项目使用的是 fastlane那就简单很多了.
- match 配置证书与描述文件
- gym 负责打包
- pgyer 负责分发测试, fastlane有个蒲公英的插件,亲测有bug,所以我还是用的脚本
整个打包上传脚本,注意如果使用了fastlane就不需要配置证书的钥匙串,上面的xbuild脚本了.
#bin/bash -l
pwd
export LANG=en_US.UTF-8
export LANGUAGE=en_US.UTF-8
export LC_ALL=en_US.UTF-8
echo "pod 更新项目依赖 ----开始----"
/usr/local/bin/pod update --verbose --no-repo-update
echo "pod 更新项目依赖 ----结束----"
cd fastlane
pwd
echo "fastlane 打包命令-----开始-----"
fastlane development
echo "fastlane 打包命令-----结束-----"
echo "pyger 上传命令-----开始----"
sh ./deploy_pgyer.sh
echo "pyger 上传命令-----结束----"
待完成的
- 测试蒲公英分发
curl -F "file=@/tmp/example.ipa" -F "uKey=" -F "_api_key=" https://qiniu-storage.pgyer.com/apiv1/app/upload - 添加
webhooc自动触发构建
参考链接
iOS持续集成:Jenkins+GitLab+蒲公英
史上最全Jenkins+SVN+iOS+cocoapods环境搭建及其错误汇总
使用Jenkins搭建iOS/Android持续集成打包平台
关于持续集成打包平台的Jenkins配置和构建脚本实现细节
牛人总结的自动化打包脚本
webhooc自动触发打包
iOS 持续集成系列 - 自动化 Code Review
丢弃xcodebuild,用fastlane打包
蒲公英上传app
fir.im Jenkins 插件使用方法
flow.ci iOS 证书设置指南
iOS 项目 Build 失败的常见原因
iOS自动构建以及打包命令
记录一次 xcodebuild 无法生成 dSYM 文件 的解决步骤
iOS构建自动化打包脚本