Fork me on GitHub

移动开发之Fastlane自动化

fastlane_text

  • 在组件化开发过程中, 提交一个私有库需要执行很多操作和命令, 详情可参考iOS组件化之私有库
  • 然而开发和更新私有库的大量操作却都是重复性的: 修改spec文件, 提交到远程仓库, 打标签等
  • 所以有没有什么办法可以自动执行, 实现自动化管理呢?
  • 何为自动化: 自动化就是通过一条简单的命令, 去执行一组固定的操作
    • 自动创建和维护iOS代码签名证书
    • 自动创建和打包iOSAPP
    • 上传屏幕截图、元数据和AppAPP商店审核
    • …….

FastLane介绍

简介

  • Fastlane官网,
  • 用于配置iOSAndroid的持续集成的神器
  • Fastlane是一套工具,帮助你简化和自动化 App 发布或部署的过程,将之变成一条平直的工作流
  • Fastlane是用Ruby语言编写的一套自动化工具集和框架,每一个工具实际都对应一个Ruby脚本,用来执行某一个特定的任务
  • Fastlane核心框架则允许使用者通过类似配置文件的形式,将不同的工具有机而灵活的结合在一起,从而形成一个个完整的自动化流程
  • Fastlane是一个ruby脚本集合,它可以按照我们指定的路线,在指定位置执行我们所要执行的操作。这里我们称这样的路线为「航道(lane)」,这样的操作称为Action
  • 到目前为止,Fastlane的工具集大约包含170多个小工具,基本上涵盖了打包,签名,测试,部署,发布,库管理等等移动开发中涉及到的内容, 工具的描述和使用可参考: Action官方文档Github源码
  • 如果这些工具仍然没有符合你需求的,没有关系,得益于Fastlane本身强大的Action和Plugin机制,如果你恰好懂一些Ruby开发的话,可以很轻易的编写出自己想要的工具

安装

  1. 确保ruby为最新版本
1
2
brew update
brew install ruby
  1. 安装fastlane
1
sudo gem install -n /usr/local/bin fastlane
  1. fastlane相关操作命令
1
2
3
4
5
6
7
8
// 查看当前fastlane版本
fastlane --version

// 查看所有action
fastlane actions

// fastlane初始化
fastlane init
  1. 如果出现类似的错误, 则可能是ruby源问题, 可更换ruby源后重新安装
1
2
ERROR:  Could not find a valid gem 'fastlane' (>= 0), here is why:
Unable to download data from https://gems.ruby-china.org/ - bad response Not Found 404 (https://gems.ruby-china.org/specs.4.8.gz)

更换ruby

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
// 官方https://gems.ruby-china.com/把org改成了com, 使用时注意替换
// 查看gem源
gem sources

// 删除默认的gem源
gem sources --remove https://gems.ruby-china.org/

// 增加gem源
gem sources -a https://gems.ruby-china.com/

// 查看当前的gem源
gem sources

// 清空源缓存
gem sources -c

// 更新源缓存
gem sources -u

fastlane提交私有库

初始化fastlane

cd 到当前目录, 执行fastlane init命令

但是对于提交私有库来说这个过程会创建一些无用的文件, 包括双穿需要的appleID等, 有雨我们不涉及这些, 所以我们还可以直接创建所需文件

1
2
3
4
5
6
7
8
9
10
cd 根目录

// 创建一个fastlane文件夹
mkdir fastlane

// 进入fastlane目录
cd xxx/xxx/fastlane

// 创建一个Fastfile文件
touch Fastfile

接下来就是编写Fastfile文件内容

配置Fastfile`文件

语法解析

fastlane init创建好文件后, 打开Fastfile文件, 默认内容如下

1
2
3
4
5
6
7
8
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
  • platform: 使用的平台
  • desc: 描述航道的作用
  • lane: 命名航道名称和相关Action
    • custom_lane: 即为航道名称, 可自定义
    • 如需外界传递参数, 可在do后面添加|options|
  • 接受外界传递参数, 在添加options后, 可定义如下参数
1
tagName = options[:tag]

外部使用命令是, 即可通过xxx tag: 0.0.1进行传值

Fastfile文件

  • Fastfile文件的作用就是把正常使用的命令转成fastlane的语法, 并在该文件中执行, 可在官方文档中查找对应的语法
  • 以==提交私有库到远程==为例, 就是把所有相关命令, 找到对应的fastlane命令写在Fastfile文件中执行

Fastfile文件配置

提交私有库时, 需要执行的命令如下

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
// 将本地库更像到测试项目
pod install

// 将本地代码加入本地仓库里
git add .

// 提交修改到本地仓库
git commit -m '你的修改记录'

// 添加名称为origin的远程连接
git remote add origin '你的github项目地址'

// 在push之前, 查看spec是否配置有问题
// 验证本地spec文件是否有误
pod lib lint

// 推送master分支的代码到名称为origin的远程仓库
git push origin master

// 设置tag值
git tag "0.0.1"

// 上传提交tag
git push --tags
  • 打开官方文档搜索
  • 例如: 搜索pod install, 对应的即为cocoapods, 如下

fastlanepod

Fastfile文件配置内容如下, 可做响应的参考

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
default_platform(:ios)

platform :ios do
desc "用于对私有库的升级维护和提交"
lane :DownloadLane do |options|

# 0. 需要外界传入的参数
tagName = options[:tag]
targetName = options[:target]


# 1. 将本地库更像到测试项目
# pod install
cocoapods(
clean: true,
# 该目录为执行Podfile未见的相对路径
podfile: "./Example/Podfile"
)

# 2. 将本地代码加入本地仓库里
# git add .
# path为需要提交的文件的路径, 这里是所有文件
git_add(path: ".")

# 3. 提交修改到本地仓库
# git commit -m '你的修改记录'
# message: 提交信息
git_commit(path: ".", message: "这里是提交信息")

# 4. 在push之前, 查看spec是否配置有问题
# 验证本地spec文件是否有误
# pod lib lint
# allow_warnings: 允许警告的存在
pod_lib_lint(allow_warnings: true)

# 5. 推送master分支的代码到名称为origin的远程仓库
# git push origin master
push_to_git_remote # 更多的信息可查看官网

# 6. 判断标签是否存在, 重复添加标签会报错
# if-else-end和if-end判断语句
if git_tag_exists(tag: tagName)
# UI.message: 打印信息
UI.message("发现tag:#{tagName} 该标签已经存在")
end

# 7. 设置tag值
# git tag "0.0.1"
add_git_tag(
tag: tagName
)

# 8. 上传提交tag
# git push --tags
push_git_tags

# 9. 更新索引库
# pod repo push XXXX xxx.podspec
pod_push(path: "#{targetName}.podspec", repo: "TitanjunSpec", allow_warnings: true)

end
end
  • Fastfile文件编写完成, 需要检测文件语法是否有误, cd 进入根目录, 执行fastlane lanes
  • 如果没问题, 执行命令fastlane 航道名称 参数1:值1 参数2:值2
  • 示例: fastlane DownloadLane tag:0.1.0 target:TKDownLoad
  • 正常情况下, 私有库已经被提交到远程仓库了, 并更新了对应的索引库

自定义Action

  • 有的时候官方提供的所有的Action并不能满足我们的需求, 不过fastlane具有很好的扩展性, 支持自定义Action
  • 找了半天才发现一个删除远程私有库标签的命令, 官方文档中没有提供
  • 这里我们就自定义一个删除远程私有库标签的Action

创建ruby文件

  • 首先打开终端, cd 进入fastlane文件夹所在的上级目录
  • 执行fastlane new_action命令, 创建新的Action, 过程中会让你输入你自定义的Action名字
  • 注意命令规范, 单词之间可用下划线连接

fastlaneaction

之后fastlane文件内会多一个actions的文件件, 内有delete_tag.rb文件, 如下

actionsName

  • 最后就是编辑该rb文件, 当然可能需要懂一些ruby语言的语法, 如果不懂也没关系, 到Github源码找一个类似功能的rb文件, 照葫芦画瓢吧!

下面把我自定义的actions的相关代码贴出来

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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
module Fastlane
module Actions
module SharedValues
DELETE_TAG_CUSTOM_VALUE = :DELETE_TAG_CUSTOM_VALUE
end

class DeleteTagAction < Action
def self.run(params)
# 运行该action最终需要执行的代码, 在这里写
tagName = params[:tag]
isRemoveLocalTag = params[:rL]
isRemoveRemoteTag = params[:rR]

# 1. 先定义一个数组, 用来存储所有需要执行的命令
cmds = []

# 2. 往数组里面, 添加相应的命令
# 删除本地标签
# git tag -d 标签名称
if isRemoveLocalTag
cmds << "git tag -d #{tagName} "
end

# 删除远程标签
# git push origin :标签名称
if isRemoveRemoteTag
cmds << " git push origin :#{tagName}"
end

#3. 执行数组里面的所有命令
result = Actions.sh(cmds.join('&'));
return result

end

def self.description
# 间断的说明该Action的作用是什么, 不超过80个字符
"删除标签"
end

def self.details
# 详细的描述当前的Action
"使用该action, 可删除本地或远程标签"
end

def self.available_options
# 该action需要的参数, 使用同构数组进行分割的, 可以根据每一个参数, 确定其作用
[
# key: 参数名称, description: 参数描述或作用, optional: 是否是可选, is_string: 是否是string类型, default_value: 默认值, verify_block: 验证的block
FastlaneCore::ConfigItem.new(key: :tag,
description: "需要被删除的标签名称",
optional: false,
is_string: true),
FastlaneCore::ConfigItem.new(key: :rL,
description: "是否需要删除本地标签",
optional: true,
is_string: false,
default_value: true),
FastlaneCore::ConfigItem.new(key: :rR,
description: "是否需要删除远程标签",
optional: true,
is_string: false,
default_value: true)
]
end

def self.output
# 表示输出的内容
end

def self.return_value
# 返回值
nil
end

def self.authors
# 作者
["CoderTitan"]
end

def self.is_supported?(platform)
# 支持的平台
platform == :ios
end
end
end
end

最后需要验证rb文件是否格式正确, 终端输入fastlane action delete_tag

fastlaneTest

-------------本文结束感谢您的阅读-------------
TitanKing wechat
欢迎您扫一扫上面的微信公众号,订阅我的博客!
坚持原创技术分享,您的支持将鼓励我继续创作!
分享到:
0%