fastlane快速构建iOS应用内测安装包(入门)

如果你已经入门,请参与(进阶篇) => https://www.jianshu.com/p/fd43293cddb6

安装fastlane

安装最新版的XCode命令行工具:

xcode-select --install

fastlane安装与使用

安装fastlane有两种方法,如下:

# 使用RubyGems(推荐)
sudo gem install fastlane -NV
brew install fastlane

设置fastlane

将终端定位到到XCode的iOS项目目录并运行:

fastlane init

也可以使用Swift来实现fastlane的配置(处于Beta阶段,切不支持插件,暂不推荐)

Fastlane.swift docs: https://docs.fastlane.tools/getting-started/ios/fastlane-swift/

fastlane init swift

当输入fastlane init后,选择控制台中提供的选项,这里我们手动配置就选择4。执行相应操作后控制台的进度可能会卡住(停在bundle update),先不管它,我们接下向下看。

执行初始化后,选择`4`

按照控制台提示操作后,工程目录会生成一个文件Gemfile和一个文件夹fastlane,后者包含AppfileFastfile文件,现在总共3个文件。

工程文件夹生成的新文件

刚才我们在输入指令后选择的是4,我们要对这3个文件都要进行配置。

先打开Gemfile,默认内容如下:

source "https://rubygems.org"
gem "fastlane"

该文件我们要怎么修改呢,还得根据我们实际情况,第一句话其实就是RubyGems的原地址,如果大家对这一点有所了解,可能会知道https://rubygems.org是Ruby默认设定的源地址。这个源由于国内网络环境的问题会比较慢,所以建议修改成 https://gems.ruby-china.com, 建议这里的配置和系统中配置的Gem源统一,查看系统的Gem源可以使用gem source指令在终端查询。具体更换系统Gem源,请自行上网查询资料。
还有一点要注意的是,如果项目中使用了CocoaPods作为项目依赖管理,需要在Gemfile文件中加入gem "cocoapods"。修改后内容如下:

source "https://gems.ruby-china.com"
gem "fastlane"
gem "cocoapods"

Gemfile文件暂时先这样(如果遇到我在上文中所说的卡在bundle update情况的,请使用Ctrl + c结束卡当前卡顿任务,在终端重新执行bundle init,这样就可以正常执行了,可能终端会弹出提示让我们输入它提示的指令bundle install --path vendor/bundle,我们可以根据它的提示这么输入并执行),更新完成本地又会工程文件夹下生成一个Gemfile.lock文件,该文件和Gemfile文件配套存在。
接着看Appfile文件,这里配置开发者邮箱Bundle ID,修改如下:

app_identifier("com.xxx.xxx") # The bundle identifier of your app
apple_id("xxx@xxx.com") # Your Apple email address

配置相关环境变量

fastlane需要设置一些环境变量才能正确运行。特别是,如果你的语言环境没有设置为UTF-8语言环境时将会导致构建和上传构建可能出现问题。在环境变量配置文件()中加入以下行:

export LC_ALL=en_US.UTF-8
export LANG=en_US.UTF-8

您可以在~/找到shell配置文件 ~/.bashrc, ~/.bash_profile, ~/.profile 或 ~/.zshrc, 这取决你的系统配置。

Fastfile就相对复杂一些。它是整个fastlane中的主要配置文件,该文件可以有各种各样的配置形式,从而能够达到我们不同的需求。我们刚才在fastlane init执行时选择的4(不同的选项,生成的内容有所差异,大家可以自己去尝试),文件内容如下:

default_platform(:ios)

platform :ios do
  desc "Description of what the lane does"
  lane :custom_lane do
    # add actions here: https://docs.fastlane.tools/actions
  end
end

用过CocoaPods的朋友们都会发现这个文件和Podfile文件很像。没错,它们是基于Ruby实现的一种自定义语言叫DSL语言。
我们的操作主要在:

lane :custom_lane do
# 在这里实现我们的配置。
end

custom_lane我们可以改一名字,比如我们是要构建adhoc环境的App,就给它改名为adhoc。这个名字后面我们会用到。

尝试构建一个App的adhoc安装包

修改Fastfile,以下的具体参数根据自己的项目实际情况,填写后保存Fastfile文件,下面是一个配置样板。

Fastfile配置灵活多样,可以根据自己的需求查阅Fastlane官方文档(官网不太稳定):https://docs.fastlane.tools

default_platform(:ios)

platform :ios do
  lane :adhoc do
    cocoapods  # 该行引入cocoapods则每次构建项目会自动执行pod install 实现依赖库配置更新,需要在Gemfile中配置 source "cocoapods",上文已有提到。
    build_app(scheme: "<此处填写Scheme>",
              workspace: "<使用CocoaPods后的workspace>.xcworkspace",
              include_bitcode: true,
              configuration: "Release",
              export_method: "ad-hoc",
              output_directory: "~/FastlaneOutput",
              output_name: "<设定导出的IPA的名字>",
              silent: false,
              include_symbols: true,
              export_xcargs: "-allowProvisioningUpdates",
              export_options: {
                  provisioningProfiles: {
                      "<bundle id>" => "<provisioning_profile>"
                  }
              })
  end
end

上文提到了我们给lane命名为adhoc,接下来我们就可以使用它的名字来给应用打包了。

每次构建前,可以执行[sudo] bundle install,要更新fastlane,只需执行[sudo] bundle update fastlane

bundle exec fastlane adhoc

接着终端会在整个项
目的构建过程打印构建信息,只要项目是能够正常编译运行的,构建通常会很顺畅。
构建完成时终端会打印一句绿色的成功提示语句,这就表示打包成功啦~

fastlane.tools finished successfully 🎉

然后我们打开我们在Fastfile文件中配置的~/FastlaneOutput文件夹,里面就会看到新鲜出炉的IPA安装包了。
祝你好运!

(进阶篇) => https://www.jianshu.com/p/fd43293cddb6

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