Fastlane

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

Fastlane

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

官网:https://fastlane.tools/

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

在写这篇文章的时候,他在Github上已经有15000+ star。

安装

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[14:21:43]: Detected iOS/Mac projectincurrent directory...[14:21:43]: This setup will help you get upandrunninginno time.[14:21:43]: fastlane will check what tools you're already using and set up

[14:21:43]: the tool automatically for you. Have fun!

[14:21:43]: Created new folder './fastlane'.

[14:21:43]: $ xcodebuild -showBuildSettings -project ./xxx.xcodeproj

[14:21:48]: Your Apple ID (e.g. fastlane@krausefx.com): xxx@xxx.xom

[14:21:54]: Verifying that app is available on the Apple Developer Portal and iTunes Connect...

[14:21:54]: Starting login with user 'xxx@xxx.com'

+----------------+--------------------------------------+

|                    Detected Values                    |

+----------------+--------------------------------------+

| Apple ID      | xxx@xxx.com                    |

| App Name      | xxx                            |

| App Identifier | com.xxx.xxx                |

| Project        | /Users/lisong/Desktop/xxx/x  |

|                | xx.xcodeproj                    |

+----------------+--------------------------------------+

[14:22:06]: Please confirm the above values (y/n)

y

[14:22:09]: Created new file './fastlane/Appfile'. Edit it to manage your preferred app metadata information.

[14:22:09]: Loading up 'deliver', this might take a few seconds

[14:22:09]: Login to iTunes Connect (xxx@xxx.com)

[14:22:13]: Login successful

+-----------------------+------------------------+

|            deliver 2.30.1 Summary            |

+-----------------------+------------------------+

| screenshots_path      | ./fastlane/screenshots |

| metadata_path        | ./fastlane/metadata    |

| username              | xxx@xxx.com      |

| app_identifier        | com.xxx.xxx  |

| edit_live            | false                  |

| platform              | ios                    |

| skip_binary_upload    | false                  |

| skip_screenshots      | false                  |

| skip_metadata        | false                  |

| force                | false                  |

| submit_for_review    | false                  |

| automatic_release    | false                  |

| dev_portal_team_id    | WKR87TTKML            |

| overwrite_screenshots | false                  |

+-----------------------+------------------------+

[14:22:21]: Writing to 'fastlane/metadata/zh-Hans/description.txt'

...

[14:22:21]: Writing to 'fastlane/metadata/review_information/notes.txt'

[14:22:21]: Successfully created new configuration files.

[14:22:22]: Successfully downloaded large app icon

[14:22:22]: Downloading all existing screenshots...

[14:22:27]: Downloading existing screenshot '1_iphone4_1.1.jpg' for language 'zh-Hans'

···

[14:22:34]: Downloading existing screenshot '5_iphone6_5.5.jpg' for language 'zh-Hans'

[14:22:34]: Successfully downloaded all existing screenshots

[14:22:34]: Successfully created new Deliverfile at path 'fastlane/Deliverfile'

[14:22:34]: $ xcodebuild -list -project ./xxx.xcodeproj

[14:22:35]: 'snapshot' not enabled.

[14:22:35]: 'cocoapods' enabled.

[14:22:35]: 'carthage' not enabled.

[14:22:35]: Created new file './fastlane/Fastfile'. Edit it to manage your own deployment lanes.

[14:22:35]: fastlane will collect the number of errors for each action to detect integration issues

[14:22:35]: No sensitive/private information will be uploaded

[14:22:35]: Learn more at https://github.com/fastlane/fastlane#metrics

[14:22:35]: Successfully finished setting up fastlane

在 "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 identifierapple_id"xxx@xxx.com"# 你的Apple IDteam_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:inhousedoapp_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:iosplatform:iosdobefore_alldo# ENV["SLACK_URL"] = "https://hooks.slack.com/services/..."cocoapodsenddesc"Runs all the tests"lane:testdoscanenddesc"提交一个新的Beta版本到 Apple TestFlight"desc"This will also make sure the profile is up to date"lane:betado# match(type: "appstore") # more information: https://codesigning.guidegym(scheme:"Docment")# Build your app - more options availablepilot# sh "your_script.sh"enddesc"部署一个新版本到App Store"lane:releasedo# match(type: "appstore")# snapshotgym(scheme:"Docment")# Build your app - more options availabledeliver(force:true)# frameitend# 你可以定义自己的lane#执行lane成功后的回调after_alldo|lane|# slack(#  message: "Successfully deployed new App Update."# )end# 如果流程发生异常会走这里并终止errordo|lane, exception|# slack(#  message: exception.message,#  success: false# )endend

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

desc"企业版"lane:inHousedogym(scheme:"XXX",export_method:"enterprise",output_directory:"./build",# 打包后的 ipa 文件存放的目录output_name:"XXX.ipa"# ipa 文件名)end

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

利用目前支持的工具可以做所有包含自动化和可持续化构建的每个环节,例如:

scan自动化测试工具,很好的封装了 UnitTest

sigh针对于 iOS 项目开发证书和 Provision file 的下载工具

match同步团队每个人的证书和 Provision file 的超赞工具

gym针对于 iOS 编译打包生成 ipa 文件

deliver用于上传应用的二进制代码,应用截屏和元数据到 App Store

snapshot可以自动化iOS应用在每个设备上的本地化截屏过程

执行

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

其他

1、这里是官方提供的一些例子

2、想了解fastlane命令的话可以执行$ fastlane --help

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

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

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

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

default_platform:iosplatform:iosdolane:preparedococoapods    matchenddesc'fastlane build''fastlane build type:adhoc'lane:builddo|options|# 调用上面的 prepare 任务preparecaseoptions[:type]when'adhoc'adhocelseappstoreendendlane : adhocdo···endlane : appstoredo···endend

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

default_platform:iosdefprepare_version(options)increment_version_number(version_number:options[:version]    )    increment_build_number(build_number:options[:build]    )end

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

lane:appstoredo|options|···    prepare_version(options)  ···end

然后执行这个lane的时候:

$ fastlane appstoreversion:2.4.0build:2.0

好啦,先说到这里吧,Fastlane能做的事情还有很多,大家可以去好好看看文档,研究一些高级的用法吧!

作者:徐凤年_

链接:https://www.jianshu.com/p/abd3d2707b53

來源:简书

著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。

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

推荐阅读更多精彩内容

  • fastlane运行所需要的环境: OS X 10.9以上 Ruby 2.0 以上 Xcode 拥有一个开发者账号...
    阿姣_0405阅读 2,936评论 0 4
  • 一,HTML语言的一般语法: 1,围堵标记:<>… 1)带属性的标记: … 2)无属性的标记:加粗 居中 标题 2...
    清水易蓝阅读 1,259评论 0 2
  • 章壹 马龙和许昕在一起七年了,但他从来没有想过,自己有一天,会对另一个人动了心。 那个人有上挑的桃花眼,高挺的鼻梁...
    秦北诚阅读 622评论 0 3
  • 现有关注列表拉到最下,显示引导关注提示图标。 可以将现有「好友正在关注」推荐列表直接展示。更加直观,提升体验。
    Gnoodle阅读 190评论 2 1
  • 2017,一七,17,一起。 东窗,一眼芜羌。这个点,昼昼灿烂的烟花终于落幕,星星点点散落着几处倦倦灯光,晚归的家...
    本账号已注销阅读 290评论 0 0