1、首先要安装正确的 Ruby 版本。在终端窗口中用下列命令来确认:
|
1
|
ruby -v
|
2、然后检查 Xcode 命令行工具是否安装。在终端窗口中输入命令：
|
1
|
xcode-select --install
|
如果未安装，终端会开始安装，如果报错误：command line tools are already installed, use "Software Update" to install updates.代表已经安装。
3、以上依赖配置好之后就可以通过 rubygem 进行安装了：
|
1
|
$ sudo gem install fastlane
|
安心等待一会，fastlane就安装完成了。
初始化
打开终端，cd到你的工程目录，然后执行fastlane init：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
|
$ cd to/your/ios/project
$ fastlane init
[14:21:43]: Detected iOS/Mac project
in
current directory...
[14:21:43]: This setup will help you get up and running
in
no 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。 了解详情，它的格式是这样的：
|
1
2
3
4
5
|
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，例如：
|
1
2
3
4
5
6
7
8
9
|
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 ，了解详情。它的格式是这样的：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
|
···
# 自动更新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：
|
1
2
3
4
5
6
7
8
|
desc
"企业版"
lane :inHouse
do
gym(scheme:
"XXX"
,
export_method:
"enterprise"
,
output_directory
"./build"
,
# 打包后的 ipa 文件存放的目录
output_name
"XXX"
# ipa 文件名
)
end
|
其中一个lane就是一个任务，里面是一个个的action组成的工作流。
利用目前支持的工具可以做所有包含自动化和可持续化构建的每个环节，例如：
-
scan 自动化测试工具，很好的封装了 Unit Test
-
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 的话实际上是可以相互调用的，这个其实特别实用。例如：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
|
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
case
options[:type]
when
'adhoc'
adhoc
else
appstore
end
end
lane : adhoc
do
···
end
lane : appstore
do
···
end
end
|
6、我们可以在 Fastfile 文件中添加一个函数来设置version号和build号。
|
1
2
3
4
5
6
7
8
9
10
11
|
default_platform :ios
def prepare_version(options)
increment_version_number(
version_number: options[:version]
)
increment_build_number(
build_number: options[:build]
)
end
|
然后可以在一个lane中使用这个函数：
|
1
2
3
4
5
|
lane :appstore
do
|options|
···
prepare_version(options)
···
end
|
然后执行这个lane的时候：
|
1
|
$ fastlane appstore version:2.4.0 build:2.0
|
扫一扫
2978
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
