iOS自动化打包,我推荐fastlane 方案。
fastlane 的原理又是如何?
实现自动化打包,又有什么流程?
简介
1、什么是打包?
Objective-C是编译语言,需要编译后才能执行。我们发布一个版本的App,需要 对源码编译、导出编译产物的过程称之为打包。
2、非自动化打包,是如何实现的
1)手动打包,使用Xcode
2)半自动化打包,我们都知道Xcode打包,其实使用的是`xcodebuild`命令,关于如何使用`xcodebuild`,请移驾这篇文章Xcode9+版本的打包方式,其得到了各位道友的认可。
3、fastlane
Fastlane是一套使用Ruby写的自动化工具集,用于iOS和Android的自动化打包、发布等工作,可以节省大量的时间。
我们在选择一些三方开源库或是工具的前提是:可以满足我们当下的需求并且提供好的扩展性, Fastlane做到了。我当前项目的需求主要是下面几方面:
一行命令实现打包工作,不需要时时等待操作下一步,节省打包的时间去做其他的事。
避免频繁修改配置导致可能出现的Release/Debug环境错误,如果没有检查机制,那将是灾难,即使有检查机制,我们也不得不重新打包,浪费了一次打包时间。毕竟人始终没有程序可靠,可以告别便利贴了。
通过配置自动上传到蒲公英内测平台进行测试分发,也可以直接上传到TestFlight,iTunes Connect。
证书的同步更新,管理,在新电脑能够迅速具备项目打包环境。
Github:https://github.com/fastlane/fastlane
官网:https://fastlane.tools/
文档:https://docs.fastlane.tools/
fastlane中常用的插件介绍
测试工具
scan:自动运行测试工具,可以生成漂亮的HTML报告
生成证书、配置文件工具
cert:自动创建iOS代码签名证书(.cert文件)
sigh:自动创建、更新、下载、修复Provisioning Profile
pem:自动生成、更新推送配置文件
截图、描设备边框
deliver:上传截图、元数据、App到iTunesConnect
snapshot:使用UI test功能实现自动截图
frameit:在截图的图片外层套上物理设备边框
自动化编译工具
gym:自动化编译工具
安装
1、首先要安装正确的 Ruby 版本。在终端窗口中用下列命令来确认:
ruby -v
2、然后检查 Xcode 命令行工具是否安装。在终端窗口中输入命令:
xcode-select --install
如果未安装,终端会开始安装,如果报错误:command line tools are already installed, use "Software Update" to install updates.代表已经安装。
3、以上依赖配置好之后就可以通过 rubygem 进行安装了:
$ sudo gem install fastlane
安心等待一会,fastlane就安装完成了。
使用
初始化
打开终端,cd到你的工程目录,然后执行fastlane init:
$ cd to/your/ios/project
$ fastlane init
在 "Your Apple ID" 这一步输入苹果开发者账号。在“Please confirm the above values”这一步,确认信息,没问题输入 y。然后,fastlane 会进行一系列的初始化操作,包括下载 App Store 上的元数据和截屏文件。
等待初始化完成之后,工程目录下就多了一个 fastlane目录,其内容如下:
fastlane目录
咱们来看两个主要的,Appfile和Fastfile。
Appfile
Appfile用来存放app_identifier,apple_id和team_id。 了解详情,它的格式是这样的:
app_identifier "com.xxx.xxx"# app的bundle identifier
apple_id "[email protected]"# 你的Apple ID
team_id "XXXXXXXXXX"# Team ID
···
你也可以为每个lane(后面会讲到)提供不同的 app_identifier, apple_id 和 team_id,例如:
app_identifier "com.aaa.aaa"
apple_id "[email protected]"
team_id "AAAAAAAAAA"
for_lane :inhouse do
app_identifier "com.bbb.bbb"
apple_id "[email protected]"
team_id "AAAAAAAAAA"
end
这里就是为Fastfile中定义的:inhouse设置单独的信息。
Fastfile
Fastfile管理你所创建的 lane ,了解详情。它的格式是这样的:
# 自动更新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:
desc "企业版"
lane :inHouse do
gym(scheme: "XXX",
export_method:"enterprise",
output_directory "./build", # 打包后的 ipa 文件存放的目录
output_name "XXX"# ipa 文件名
)
end
其中一个lane就是一个任务,里面是一个个的action组成的工作流。
执行
定义完lane之后怎么执行呢?打开终端,切换到项目的根目录:执行fastlane lane'name就可以了。成功之后会在相应的路径下生成ipa文件,如果报错的话就根据错误信息好好查看文档。
其他
1)想了解fastlane命令的话可以执行$ fastlane --help
2)查看可用任务的列表,可以执行命令$ fastlane lanes
3)fastlane也提供了很多插件方便我们使用,例如pgyer(发布app到蒲公英)。我们也可以打完包直接传到蒲公英上,具体的可以看蒲公英提供的文档。
如果你感觉有些插件不符合自己的情况,你甚至可以自定义插件
4)多个 lane 的话实际上是可以相互调用的,这个其实特别实用。例如:
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
caseoptions[:type]
when 'adhoc'
adhoc
else
appstore
end
end
lane : adhoc do
···
end
lane : appstore do
···
end
end
6、我们可以在 Fastfile 文件中添加一个函数来设置version号和build号。
default_platform :ios
def prepare_version(options)
increment_version_number(
version_number: options[:version]
)
increment_build_number(
build_number: options[:build]
)
end
然后可以在一个lane中使用这个函数:
lane :appstore do|options|
···
prepare_version(options)
···
end
然后执行这个lane的时候:
$ fastlane appstore version:2.4.0 build:2.0
证书管理-match
使用match管理证书,可以省去很多复杂操作,如:Mac上申请颁发证书、AppleDeveloper去创建证书、创建真机测试Provision文件、添加设备等。
1)搭建一个git-project,所有证书文件存放在git上,各iOS开发组员可以更方便同步证书等文件
2)在fastlane文件夹中,初始化match
$ fastlane match init