Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
10_fir_APITOKEN.png
1_project_base_config@2x.png
2_workflow_config.png
3_project_invitation.png
4_provisioningProfile_Cert.png
5_manual_build.png
6_auto_build.png
7_manual_select_branch.png
8_build_error.png
9_flow_update.png
README.md

README.md

iOS自动构建套件 - flow.ci + fir.im + Coding

2017.04.23

前言

相信很多最开始接触自动构建都是从Jenkins开始的。都是纯手工搭建,本地代码创库也是Gitblit搭建的。基本上每次换工作,都需要重新搭建一遍,实在心累。期间踩坑无数,暂且不表。接触到flow.ci还是因为之前一直在用他们的APP发布平台服务fir.im。本文是我对flow.ci的一些体验,期望可以帮助iOSer快速上手。

准备工作

  1. 项目的Git仓库(什么?还在用SVN!恨铁不成钢的表情,SVN转Git可以看这里
  2. 注册Coding账号,创建Coding私有创库(免费的哦)。

如果之前有Git仓库,也可以新建一个专门用于自动构建的分支

  1. 注册flow.ci账号(不收费,不过要手机号码接收短信验证码)
  2. 注册fir.im账号,生成并获取API Token(不收费,不过要手机号码接收短信验证码)
  3. 绑定Coding账户。在dashboard页面点击用户头像 - Git仓库创建项目都可以绑定Coding账户。(GitHub,Bitbucket,Coding,GitLab,码云都是支持的)
  4. 证书和描述文件。引用一下flow.ci自己的详细导出证书和描述文件教程

(企业证书请忽略)切记在描述文件里面添加要安装设备的UDID,否则会出现从fir.im下载的时候,提示“无法安装该应用”。到时候需要重新在描述文件添加UDID,然后重新上传描述文件并再次构建。

开工

项目配置

  1. 在flow.ci的dashboard页面直接点击创建项目
  2. 选择Coding并选择对应的代码仓库。
  3. 项目基础配置。选择苹果图标,Xcode版本。点击创建
  4. 工作流配置。这是个精细化的配置,指定构建分支。你还可以设置定时任务。每天下班的时候构建一次。如果你有多个Scheme(比如APP有iPhone和iPad版本,免费和收费版本),这个时候可以在编译 - Scheme指定特定的Scheme。完成后可以配置一些构建失败和成功的通知(添加构建成功邮箱地址,小心邮件爆炸哦)。
  5. 添加成员。输入你的组员和测试人员的Email地址,点击邀请。他们会收到标题为Project invitation的邮件。按照提示操作,就可加入你的团队了。
  6. 设置。找到上传证书 & Provisioning Profile,上传准备工作6准备的描述文件和证书。

构建

  1. 自动构建。选择"构建列表",一般等几秒钟就会出现你配置仓库的分支信息了

  2. 手动构建。如果你嫌自动构建读取分支信息慢,点击手动构建,选择自己想构建的分支。

  3. 构建过程。点击构建当前构建条目(如果状态是准备资源,则需要等待几秒钟。然后自动会变为运行中。),即可看到如下图的构建流程。通常编译阶段会比较容易发生错误信息。按照错误提示修改项目,然后提交到Coding。flow.ci会自动同步代码库并运行构建。

  4. 构建后。发布构建的APP到fir.im平台。首先需要点击工作流中左边的"+"号并搜索fir,添加fir.im上传插件。在FIR_API_TOKEN框中填入准备工作4获取的API Token。如果一切顺利的话,你会在fir.im - 我的应用里面看到构建成功的APP包了。赶紧分享你的APP下载二维码吧。

后面两个选项可以选填。$FIR_CHANGELOG用于显示在fir.im下载页面的更新日志。一般我会填“flow.ci build”。用于区分手动上传和flow.ci自动构建。

总结

总体感觉下来,就是流畅,无缝衔接。作为一个被Jenkins折磨过多个版本的人,实在感慨。flow.ci目前可以免费创建5个项目。在flow.cidashboard页面右上角有个电池一样的图标。可以看到你当前的使用情况。还有比较直观的数据分析。这只是flow.ci的初体验。期待以后挖掘更多有趣的功能。