iOS - fastlane自动化打包

iOS自动化打包,我推荐fastlane 方案。

fastlane 的原理又是如何?

实现自动化打包,又有什么流程?

简介

1、什么是打包?

    Objective-C是编译语言,需要编译后才能执行。我们发布一个版本的App,需要      对源码编译、导出编译产物的过程称之为打包。

2、非自动化打包,是如何实现的

    1)手动打包,使用Xcode

    2)半自动化打包,我们都知道Xcode打包,其实使用的是`xcodebuild`命令,关于如何使用`xcodebuild`,请移驾这篇文章Xcode9+版本的打包方式,其得到了各位道友的认可。

3、fastlane

Fastlane是一套使用Ruby写的自动化工具集,用于iOS和Android的自动化打包、发布等工作,可以节省大量的时间。

我们在选择一些三方开源库或是工具的前提是:可以满足我们当下的需求并且提供好的扩展性, Fastlane做到了。我当前项目的需求主要是下面几方面:

一行命令实现打包工作,不需要时时等待操作下一步,节省打包的时间去做其他的事。

避免频繁修改配置导致可能出现的Release/Debug环境错误,如果没有检查机制,那将是灾难,即使有检查机制,我们也不得不重新打包,浪费了一次打包时间。毕竟人始终没有程序可靠,可以告别便利贴了。

通过配置自动上传到蒲公英内测平台进行测试分发,也可以直接上传到TestFlight,iTunes Connect。

证书的同步更新,管理,在新电脑能够迅速具备项目打包环境。

Github:https://github.com/fastlane/fastlane

官网:https://fastlane.tools/

文档:https://docs.fastlane.tools/

fastlane中常用的插件介绍


测试工具

scan:自动运行测试工具,可以生成漂亮的HTML报告

生成证书、配置文件工具

cert:自动创建iOS代码签名证书(.cert文件)

sigh:自动创建、更新、下载、修复Provisioning Profile

pem:自动生成、更新推送配置文件

截图、描设备边框

deliver:上传截图、元数据、App到iTunesConnect

snapshot:使用UI test功能实现自动截图

frameit:在截图的图片外层套上物理设备边框

自动化编译工具

gym:自动化编译工具

安装

1、首先要安装正确的 Ruby 版本。在终端窗口中用下列命令来确认:

ruby -v

2、然后检查 Xcode 命令行工具是否安装。在终端窗口中输入命令:

xcode-select --install

如果未安装,终端会开始安装,如果报错误:command line tools are already installed, use "Software Update" to install updates.代表已经安装。

3、以上依赖配置好之后就可以通过 rubygem 进行安装了:

$ sudo gem install fastlane

安心等待一会,fastlane就安装完成了。

使用

初始化

打开终端,cd到你的工程目录,然后执行fastlane init:

$ cd to/your/ios/project

$ fastlane init

在 "Your Apple ID" 这一步输入苹果开发者账号。在“Please confirm the above values”这一步,确认信息,没问题输入 y。然后,fastlane 会进行一系列的初始化操作,包括下载 App Store 上的元数据和截屏文件。

等待初始化完成之后,工程目录下就多了一个 fastlane目录,其内容如下:

fastlane目录

咱们来看两个主要的,Appfile和Fastfile。

Appfile

Appfile用来存放app_identifier,apple_id和team_id。 了解详情,它的格式是这样的:

app_identifier "com.xxx.xxx"# app的bundle identifier

apple_id "xxx@xxx.com"# 你的Apple ID

team_id "XXXXXXXXXX"# Team ID

···

你也可以为每个lane(后面会讲到)提供不同的 app_identifier, apple_id 和 team_id,例如:

app_identifier "com.aaa.aaa"

apple_id "aaa@aaa.com"

team_id "AAAAAAAAAA"

for_lane :inhouse do

  app_identifier "com.bbb.bbb"

  apple_id "bbb@bbb.com"

  team_id "AAAAAAAAAA"

end

这里就是为Fastfile中定义的:inhouse设置单独的信息。

Fastfile

Fastfile管理你所创建的 lane ,了解详情。它的格式是这样的:

# 自动更新fastlane 工具

# update_fastlane

#需要的fastlane的最小版本,在每次执行之后会检查是否有新版本,如果有会在最后末尾追加新版本提醒

fastlane_version "2.30.1"

#默认使用平台是 ios,也就是说文件可以定义多个平台

default_platform :ios

platform :ios do

  before_all do

    # ENV["SLACK_URL"] = "https://hooks.slack.com/services/..."

    cocoapods

  end


  desc "Runs all the tests"

  lane :test do

    scan

  end


  desc "提交一个新的Beta版本到 Apple TestFlight"

  desc "This will also make sure the profile is up to date"

  lane :beta do

    # match(type: "appstore") # more information:https://codesigning.guide

    gym(scheme: "Docment") # Build your app - more options available

    pilot


    # sh "your_script.sh"

  end


  desc "部署一个新版本到App Store"

  lane :release do

    # match(type: "appstore")

    # snapshot

    gym(scheme: "Docment") # Build your app - more options available

    deliver(force: true)

    # frameit

  end


  # 你可以定义自己的lane

  #执行lane成功后的回调

  after_all do|lane|

    # slack(

    #  message: "Successfully deployed new App Update."

    # )

  end


  # 如果流程发生异常会走这里并终止

  error do|lane, exception|

    # slack(

    #  message: exception.message,

    #  success: false

    # )

  end

end

我们也可以定义一个自己的lane:

  desc "企业版"

  lane :inHouse do

  gym(scheme: "XXX",

      export_method:"enterprise",

      output_directory "./build", # 打包后的 ipa 文件存放的目录

      output_name "XXX"# ipa 文件名

  )

  end

其中一个lane就是一个任务,里面是一个个的action组成的工作流。

执行

定义完lane之后怎么执行呢?打开终端,切换到项目的根目录:执行fastlane lane'name就可以了。成功之后会在相应的路径下生成ipa文件,如果报错的话就根据错误信息好好查看文档

其他

1)想了解fastlane命令的话可以执行$ fastlane --help

2)查看可用任务的列表,可以执行命令$ fastlane lanes

3)fastlane也提供了很多插件方便我们使用,例如pgyer(发布app到蒲公英)。我们也可以打完包直接传到蒲公英上,具体的可以看蒲公英提供的文档

如果你感觉有些插件不符合自己的情况,你甚至可以自定义插件

4)多个 lane 的话实际上是可以相互调用的,这个其实特别实用。例如:

default_platform :ios

platform :ios do

  lane :prepare do

    cocoapods

    match

  end


  desc 'fastlane build''fastlane build type:adhoc'

  lane :build do|options|

    # 调用上面的 prepare 任务

    prepare

    caseoptions[:type]

    when 'adhoc'

      adhoc

    else

      appstore

    end

  end


  lane : adhoc do

  ···

  end


  lane : appstore do

  ···

  end

end

6、我们可以在 Fastfile 文件中添加一个函数来设置version号和build号。

default_platform :ios

def prepare_version(options)

    increment_version_number(

        version_number: options[:version]

    )

    increment_build_number(

        build_number: options[:build]

    )

end

然后可以在一个lane中使用这个函数:


lane :appstore do|options|

  ···

    prepare_version(options)

  ···

end

然后执行这个lane的时候:

$ fastlane appstore version:2.4.0 build:2.0

证书管理-match

使用match管理证书,可以省去很多复杂操作,如:Mac上申请颁发证书、AppleDeveloper去创建证书、创建真机测试Provision文件、添加设备等。

1)搭建一个git-project,所有证书文件存放在git上,各iOS开发组员可以更方便同步证书等文件

2)在fastlane文件夹中,初始化match

$ fastlane match init

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

推荐阅读更多精彩内容