iOS 自动打包总结 fastlane +svn+jenkins +上传蒲公英

国际惯例.jpg

写在前面

  iOS 开发同学在开发过程中都会遇见的一个问题就是重复给测试同学打测试包,打包的过程虽说没有难度,但是程序员都是很拒绝这种重复而没技术含量的工作,虽说我们是码农,但是我们还是希望自己的工作是 去改变世界的!所以这种无聊的工作我们能偷懒就偷懒吧。

  公司控制发版和测试的工具使用的一直是 jenkins ,之前也有接触,但是只局限于 web 页面和服务器端发版提交,懂得一些基础配置。来到公司后,技术总监决定 iOS 也要实现自动打包,方便管理,然后我就接了这个锅!!!

首先你需要一台 mac , 用你自己的或者是公司能提供一台 mac mini 来充当发版服务器是最好的了,部署 jenkins 的工作我就不具体细说了,虽繁琐,但是不难。下面是我找到部署 jenkins 的文章
mac 下使用 jenkins 自动打包
mac 环境下如何配置 jenkins

  • jenkins 配置好后登录会进入这个页面(需要安装好 xcode 插件,我们依次选择系统管理->管理插件,在“可选插件”中选中“Xcode integration”安装,如使用的是 git 管理还需要安装对应的插件)
    屏幕快照.png

当然在你那是什么项目都没有的,部署好以后先不用管,我们先配置好打包需要的环境,再来部署 jenkins。

  • 首先介绍一下 Fastlane

fastlane 是一套工具,帮助你简化和自动化 App 发布或部署的过程,将之变成一条平直的工作流。通过 fastlane,你可以实现 持续分发(CD,一种用于自动化和改进软件分发过程的设计实践)。 通过 fastlane 内置的工具,你可以创建一个由 build task (又叫做 lane)构成的有序列表,你只需要点击一个按钮就可以将 App 发布到 App 商店。你可以节省大量的时间,用于提升软件质量,或者缩短团队中发布者的发布周期。

Fastlane是用Ruby语言编写的一套自动化工具集和框架,每一个工具实际都对应一个Ruby脚本,用来执行某一个特定的任务,而Fastlane核心框架则允许使用者通过类似配置文件的形式,将不同的工具有机而灵活的结合在一起,从而形成一个个完整的自动化流程。

通过 fastlane 内置的工具,你可以创建一个由 build task (又叫做 lane)构成的有序列表,你只需要点击一个按钮就可以将 App 发布到 App 商店。你可以节省大量的时间,用于提升软件质量,或者缩短团队中发布者的发布周期。

官网链接点这里(翻墙)
gitHub点这里

Fastlane 安装

  • 打开终端输入
xcode-select --install

若是出现下图,则说明你之前安装过;没有的话按照步骤安装即可


屏幕快照 .png

如果没有安装过则会出现以下安装页面
屏幕快照.png
  • 输入 以下命令查看 ruby 版本要求2.0及其以上版本
ruby -v

出现以下页面就是以安装过了,
屏幕快照.png

没有安装版本太低或者是没有安装的同学请自行百度安装,这里就不过多赘述。

  • 上述问题都解决后就需要安装 fastlane
sudo gem install fastlane --verbose

如果出现以下错误:

ERROR:  While executing gem ... (Errno::EPERM)
    Operation not permitted - /usr/bin/rougify

则输入以下命令

 sudo gem install -n /usr/local/bin fastlane
  • 检查 fastlane 是否正确安装,输入以下命令
fastlane --version

我的是 fastlane 2.89.0

蒲公英插件的安装

  • 打开终端,进入你的项目工程的根目录,输入以下命令:
fastlane add_plugin pgye

出现以下界面

Plugin 'fastlane-plugin-pgyer' was added to './fastlane/Pluginfile'
It looks like fastlane plugins are not yet set up for this project.
fastlane will create a new Gemfile at path 'Gemfile'
This change is necessary for fastlane plugins to work
Should fastlane modify the Gemfile at path 'Gemfile' for you?
(y/n)

输入 y 点击回车出现

Installing plugin dependencies...
Successfully installed plugins

搞定!!!

Fastlane 配置

  • 打开终端,cd 到工程的根目录,输入以下命名初始化 fastlane
fastlane init

中间会让你输入苹果开发者账号的账号和密码,之后会在你项目工程的目录下生成一个fastlane文件夹,里面有Fastlane的配置文件,一个是Appfile文件,一个是Fastfile文件(如果要上传AppStore的话还有Deliverfile文件)。Appfile保存苹果开发者的相关信息、项目的相关信息等。Fastfile是运行脚本,目录如下图:
屏幕快照 .png

部署 jenkins

  • 新建项目,输入项目名称,选中自由风格项目,然后点击 OK。


    屏幕快照.png

    可添加描述,其他保持原样就行,有兴趣的同学可以自己研究一下这些选项都是什么意思

  • 源码管理

    我这里用的是 svn ,所以只介绍 svn 关联版本库的方法,如使用 git 的可百度一下,方法也很简单
    屏幕快照.png

    点击 add 添加SVN用户,输入用户名和密码,其他可不输入。
    屏幕快照 .png

    点击添加后会回到上一页面
    屏幕快照.png
    选中之前添加的 svn 用户,没有红色的报错信息,那就是添加正确了,如果报错,请检查 SVN 路径或者是 SVN用户名和密码。
  • 构建触发器
    这个是决定在什么情况下会触发自动构建的,目前就 APP 开发而言我们选中 Poll SCM 就行,然后输入
H 8 * * 1-6

意思就是在 SVN仓库代码发生改变的情况下,会在周一至周六每天早上8点自动构建版本,也就是自动打包。
屏幕快照.png
  • 构建环境
    我开始使用的是在构建环境这一块来配置打包证书和描述文件,踩了无数的坑,虽然也是弄好了,但是这里不推荐大家使用,fastlane 会自动给我们解决证书的问题
  • 构建

    选中增加构建步骤-> Execute shell
    屏幕快照 .png

    在命令行里输入以下脚本
export LANG=en_US.UTF-8

export LANGUAGE=en_US.UTF-8

export LC_ALL=en_US.UTF-8

export PATH="~/.fastlane/bin:$PATH"

IPANAME="你要打包的scheme 名"
fastlane gym --export_method ad-hoc --output_name ${IPANAME}

curl -F "file=@包名.ipa" -F "_api_key=蒲公英的 app_key" https://qiniu-storage.pgyer.com/apiv2/app/upload

然后点击保存

证书配置

  • 必须确保安装 jenkins 的电脑里有安装 xcode 、你要打包项目的证书和描述文件,并且打开钥匙串,找到打包证书,双击将证书修改为始终信任


    屏幕快照.png

    证书配置完成后,回到 jenkins 控制面板,点击立即构建,红色代表构建失败,蓝色代表构建成功,构建失败的话我们点击当前构建,进入以下页面
    屏幕快照.png
    点击 Console OutPut 能够查看失败原因和构建进度!!
    屏幕快照 .png

注意事项

  • 你项目中的scheme 必须勾选 shared


    屏幕快照 .png
  • 提交 SVN 仓库时不能勾选勾选自动证书,手动配置描述文件选中 ad_hot 描述文件。

写在后面

  • 当时是遇见了很多的问题,但是没有及时总结,好多问题都忘了如果您碰见什么无法解决的问题可以联系我试试看,可能我之前也碰见过,直接留言或者私信就行!
  • 当然 jenkins 和 fastlane 还有很多高级的用法,比如 jenkins 自动化测试和配合一下 jenkins 插件完成一下繁琐重复的工作,fastlane 自动提交 apple store 和自己截图等好多功能,有兴趣的同学可以研究一下。
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,088评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,715评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,361评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,099评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 60,987评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,063评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,486评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,175评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,440评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,518评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,305评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,190评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,550评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,880评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,152评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,451评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,637评论 2 335

推荐阅读更多精彩内容