1、ruby
因为Fastlane是ruby编写的,所以我们首先保证电脑的ruby环境有正确安装,打开终端,输入如下命令来查看ruby版本。mac 安装ruby环境
ruby -v
如果低于2.0,就需要升级ruby了
2、安装Fastlane
首先安装Xcode命令行工具,因为编译、打包等操作,虽然是Fastlane帮我们做的,但本质上还是通过Xcode中的构建工具来完成的。在终端中运行如下命令,则会安装Xcode命令行工具:
xcode-select --install
然后安装Fastlane:
sudo gem install fastlane --verbose
如果发现最后报了这样的错误:
ERROR: While executing gem ... (TypeError)
no implicit conversion of nil into String
则更新gem版本,然后再次安装Fastlane:
sudo gem update --system
如果报错:
ERROR: While executing gem ... (Gem::FilePermissionError)
You don't have write permissions for the /usr/bin directory.
则尝试使用如下命令进行安装:
sudo gem install -n /usr/local/bin fastlane
为了检查Fastlane是否成功安装,可以通过下面的命令来查看Fastlane版本号:
fastlane --version
3、为项目初始化Fastlane
如果Fastlane正确安装了,就可以为我们的项目初始化Fastlane了,首先通过终端,CD到项目目录,也就是项目的.xcodeproj文件所在位置。然后执行Fastlane初始化命令:
fastlane init
这里如果一直卡在bundle update,那应该就是被墙了,这时候来到项目目录下,找到Gemfile,打开Gemfile将里面的内容修改为如下:
#source "https://rubygems.org"
source "https://ruby.taobao.org"
gem "fastlane"
重开终端,运行bundle update
就好了。
打开文件夹中的Fastfile,里面则是执行自动化打包任务的代码,这里我是用sublime打开的,在sublime的菜单中,找到View——>Syntax中选择ruby,即可高亮代码
mac sublime破解版
4、创建一个lane
Fastlane以lane为单位,去执行一个自动化任务,Fastfile中的代码如下:
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
lane:custom_lane,代表了一个叫custom_lane的任务,后面的do,则表示需要执行的操作。这里就不讲怎么写代码了(因为我也不会ruby啊!现用现找就好了),我把我项目中的Fastfile贴上来,讲解下Fastfile做了哪些事(见代码中的注释):
platform :ios do #指定持续集成对象的平台名称
lane :dev do|options| #给lane命名
branch = options[:branch]
#这里我们项目为了区分线上环境和测试环境,而做了两个target
#关于target区分环境的方法,可以参考我同事的文章https://www.jianshu.com/p/23cc84d40423
#下面代码通过在终端输入1或者其他数字来选择要打包的target
#puts是ruby中的输出,gets为获取终端中输入的文字,gets需要指定STDIN包中的gets方法,否则会识别为其他包中的gets方法,具体为什么我也不知道
puts "请选择要打的scheme:(1:项目Target1,else: 项目Target2)"
scheme = STDIN.gets
# 通过判断输入内容,来区分一些打包信息,1后面加\n是因为在终端输入1再敲回车的时候scheme就包含了回车的内容,所以scheme == "1\n"
if scheme == "1\n"
#项目中target的名称,以QQ为例,如果我的target叫QQ,则下面填写QQ,如果是wechat,就填wechat
schemeName = "项目Target1"
#打包的用途,也就是app-store, package, ad-hoc, enterprise, development这几个中的一个,这里我们项目的target1用的是公司帐号,打的是开发包
export_method = "development"
else
schemeName = "项目Target2"
#这里我们项目的target2用的是企业帐号,打的是企业包
export_method = "enterprise"
end
#从蒲公英平台拿到的api_key和user_key,下面我会讲怎么拿到这两个key,存在下面两个变量中
api_key = "xxxxxxxxxxxxxxxxxxx"
user_key = "xxxxxxxxxxxxxxxxxxx"
#输入蒲公英上传ipa包后输入的版本描述信息
puts "请输入版本描述:"
desc = STDIN.gets
puts "开始打包 #{schemeName}"
# 开始打包
gym(
#指定scheme的名字
scheme: "#{schemeName}",
#输出的ipa名称
output_name:"#{schemeName}",
# 是否清空以前的编译信息 true:是
clean:true,
# 指定打包方式,Release 或者 Debug
configuration:"Release",
# 指定打包所使用的输出方式,目前支持app-store, package, ad-hoc, enterprise, development
export_method:"#{export_method}",
# 指定输出文件夹,这里会保存我们最后生成的ipa文件,也就是存到了我们上面提到的fastlane文件夹中的build文件夹中
output_directory:"./fastlane/build",
)
puts "开始上传到蒲公英"
#开始上传ipa到蒲公英,这里用的是蒲公英提供的插件
#update_description代表更新信息,password代表安装密码
pgyer(update_description: "#{desc}", api_key: "#{api_key}", user_key: "#{user_key}", password: "1111", install_type: "2")
#在上传完ipa后,打开ipa的存放文件夹,起到提示上传完成的作用
system "open ../fastlane/build"
end
end
如上代码,从头到尾读下来,其实就是一个很简单的输入变量——>定义几个变量——>调用一个名为gym的打包方法,将定义的变量作为参数传进去——>调用一个名为pgyer的方法上传ipa,将前面定义好的变量作为参数传进去。
4、执行脚本
cd到项目目录,输入如下命令来执行我们自己定义的lane,格式如下fastlane+脚本第一行中的platform名+脚本第二行中的lane名:
fastlane ios dev
常见错误
ommand timed out after 10 seconds on try 1 of 4
原因: 很大可能是机器不给力了,使xcodebuild -showBuildSettings -workspace ./XX.xcworkspace -scheme XX -configuration Release 命令执行超时
解决方法: 在Fastfile的 before_all方法中,添加 :
ENV["FASTLANE_XCODEBUILD_SETTINGS_TIMEOUT"] = "120"
ENV["FASTLANE_XCODEBUILD_SETTINGS_RETRIES"] = "4"
也就是重置超时时间和重试次数,可根据自己需要修改