【iOS 开发】使用 Fastlane 自动化打包并发布 iOS 项目

Fastlane 是一个完全开源的项目,是一款为 iOSAndroid 开发者提供的自动化构建工具,它可以帮助开发者将 App 打包、签名、测试、发布、信息整理、提交 App Store 等工作完整的连接起来,实现完全自动化的工作流,如果使用得当,可以显著的提高开发者的开发效率,这是 GitHub 地址官方文档


本文最终目的:

  • 终端输入 fastlane beta 自动打包 ad-hoc 版本的 ipa 包并自动上传到 蒲公英

  • 终端输入 fastlane release 自动打包 app-store 版本的 ipa 包并自动上传到 iTunes Connect

1. 安装 Fastlane

  • 检查 Ruby 版本,需要 2.0 及以上版本,并且需要将 gemsource 改为 https://gems.ruby-china.org/ ,在终端输入以下命令。
1
2
// 查看 Ruby 版本
ruby -v
1
2
// 查看 gem 的source
gem sources
  • 检查 Xcode 命令行工具是否安装,在终端输入以下命令,如果安装过会有提示,如果没装过就会自动开始安装。
1
xcode-select --install
  • 开始安装 Fastlane ,在终端输入以下命令。
1
sudo gem install fastlane --verbose
  • 如果安装时出现错误无法安装,就使用以下命令安装。
1
sudo gem install -n /usr/local/bin fastlane
  • 安装完成后可以输入以下命令查看版本来验证是否安装成功。
1
fastlane --version

2. 安装蒲公英的 Fastlane 插件

  • fastlane 安装完成以后,在终端输入以下命令安装 蒲公英 插件。
1
fastlane add_plugin pgyer
  • 最后出现 Successfully installed plugins 表示安装完成。

插件安装

  • 安装完成以后,会在系统根目录生成 GemfileGemfile.lock 这两个文件,这两个文件不要删掉,不然插件就得重装了。

Gemfile

3. 修改项目配置

  • Xcode 打开你的项目,然后打开 Manage Schemes...

Xcode

  • 然后将工程的 Scheme 后面的 Shared 给勾上。

Xcode

  • 需要将这个改动上传到 git 仓库,不要忽略掉这个文件,提交的文件路径信息如下,如果你改完没有提示有需要改动的提交,那就看一下 .gitignore 里面是不是忽略掉了。

commit

  • 做这个改动的原因是,后面可能会用到 Jenkins + Fastlane 做持续集成,如果没有这个文件,Jenkins 使用 fastlane 编译项目时会提示 No schemes found in Xcode project or workspace ,所以最好先加上。

4. 初始化 Fastlane 配置

  • 打开终端,cd 到你项目工程的根目录(xcodeproj 的同级目录),输入以下命令:
1
fastlane init
  • 初始化过程中会让你输入苹果开发者账号的账号和密码,这个信息会存储在钥匙串中,后续使用无需再输入密码。

  • 初始化过程中还会检测当前项目的 App Identifier 是否已经在 Apple Developer 中,还会检测当前 App 是否已经在 iTunes Connect 中,如果都满足的话,过程应该是比较顺利的。

  • 初始化完成之后会在你项目工程的目录下生成一个 fastlane 文件夹,里面是 Fastlane 的一些配置文件。其中 Appfile 里面存放了 App 的基本信息包括 App_IdentifierAppIDTeam_ID 等。Fastfile 是最重要的一个文件,在这个文件里面可以编写和定制我们打包脚本的一个文件,所有自定义的功能都写在这里。

5. 编辑 Fastlane 脚本文件

  • 首先找到工程目录下 fastlane 文件夹下的 Fastlane 文件,如果想要了解其中内容的含义可以自己去官方文档查一下,这里就不解释了。

  • 使用编辑器打开 Fastlane 文件,将所有内容删除替换为以下内容。

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
fastlane_version "xxx"
default_platform :ios
platform :ios do
desc "以 ad-hoc 方式打包并上传到蒲公英"
lane :beta do
puts "自动生成 Provisioning Profiles 文件"
sigh(
# 指定输出的文件夹地址
output_path: "./archive/sign",
# 是否为 AdHoc 证书(设为 false 或不写默认为 AppStore 证书)
adhoc: true
)
puts "以 ad-hoc 方式打包"
gym(
# 指定打包所使用的输出方式 (可选: app-store, package, ad-hoc, enterprise, development)
export_method: "ad-hoc",
# 指定项目的 scheme 名称
scheme: "xxx",
# 指定输出的文件夹地址
output_directory: "./archive/beta/" + Time.new.strftime("%Y-%m-%d-%H:%M:%S"),
# 指定打包方式 (可选: Release, Debug)
configuration: "Release"
)
puts "上传 ipa 包到蒲公英"
pgyer(
# 蒲公英 API KEY
api_key: "xxx",
# 蒲公英 USER KEY
user_key: "xxx"
)
end
desc "以 app-store 方式打包并上传到 iTunes Connect"
lane :release do
puts "自动生成 Provisioning Profiles 文件"
sigh(
# 指定输出的文件夹地址
output_path: "./archive/sign"
)
puts "以 app-store 方式打包"
gym(
# 指定打包所使用的输出方式 (可选: app-store, package, ad-hoc, enterprise, development)
export_method: "app-store",
# 指定项目的 scheme 名称
scheme: "xxx",
# 指定输出的文件夹地址
output_directory: "./archive/release/" + Time.new.strftime("%Y-%m-%d-%H:%M:%S"),
# 指定打包方式 (可选: Release, Debug)
configuration: "Release"
)
puts "上传 ipa 包到 iTunes Connect"
deliver(
# 跳过截图上传
skip_screenshots: true,
# 跳过元数据上传
skip_metadata: true,
# 跳过审核直接上传
force: true
)
end
end
  • 需要更改的地方我已经用 xxx 标注出来了,按照说明更改即可,更改完成后保存文件。

6. 开始自动打包并发布

  • 打开终端,cd 到你项目工程的根目录(xcodeproj 的同级目录)。

  • 输入以下命令,即可开始自动打包并上传到 蒲公英

1
fastlane beta
  • 输入以下命令,即可开始自动打包并上传到 iTunes Connect
1
fastlane release
  • 打包的 .ipa 包和 dSYM 文件,以及生成的 Provisioning Profiles 都在工程目录下的 archive 文件夹内,看上面的输出地址就知道了。

  • 最后出现一个 successfully 🎉 就表示成功了,有错误终端也会有提示,按照提示继续修改配置就行了。


Fastlane 还能实现很多自动化的功能,感兴趣的自己去了解一下吧,这里有篇文章写的很全面可以看一下: 小团队的自动化发布-Fastlane带来的全自动化发布

将来的你,一定会感激现在拼命的自己,愿自己与读者的开发之路无限美好。

我的传送门: 博客简书微博GitHub

如果觉得我的文章对您有用,请随意打赏吧,您的支持将鼓励我继续创作!
0%