如果你已经入门,请参与(进阶篇) => 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),先不管它,我们接下向下看。
按照控制台提示操作后,工程目录会生成一个文件Gemfile
和一个文件夹fastlane
,后者包含Appfile
和Fastfile
文件,现在总共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安装包了。
祝你好运!