前言
在项目测试阶段,频繁的打包发布会耗费很多的时间。学习使用了Fastlane实现了自动化打包发布到蒲公英&fir,以下内容是实现的过程。
Fastlane安装
Fastlane是一套使用Ruby写的自动化工具集,用于iOS和Android的自动化打包、发布等工作,可以节省大量的时间。
安装过程如下:
1.检查Ruby版本,需要2.0及以上版本。在终端输入以下命令确认:
ruby -v
需要注意的是需要将gem的source改为https://gems.ruby-china.org/。
如何检查?在终端输入以下命令:
gem sources
结果应为:
*** CURRENT SOURCES ***
https://gems.ruby-china.org/
2.检查Xcode命令行工具是否安装。在终端输入以下命令:
xcode-select --install
如果没有安装会进行安装。如果已经安装了则会提示:
xcode-select: error: command line tools are already installed, use "Software Update" to install updates
3.安装Fastlane
sudo gem install fastlane --verbose
如果出现以下错误:
ERROR: While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/rougify
则输入以下命令:
sudo gem install -n /usr/local/bin fastlane
4.检查Fastlane是否正确安装。输入以下命令:
fastlane --version
可以看到我的Fastlane版本信息,我的是2.193.1。
Fastlane配置
1.打开终端,进入你的项目工程的根目录,输入以下命令:
fastlane init
新版本安装的时候会出现下面的分支,按要求选择就行
(1)自动截屏。这个功能能帮我们自动截取APP中的截图,并添加手机边框(如果需要的话)
(2)自动发布 beta 版本用于 TestFlight
(3)自动发布到 AppStore
(4)手动设置
目前我选择的是4,按照提示, 多个Enter 后有可能会输入开发者账号和密码。安装成功之后,会在工程目录生成一个 fastlane 文件夹和 Appfile 和 Fastfile 两个文件。Appfile保存苹果开发者的相关信息、项目的相关信息等。Fastfile是运行脚本。
2.蒲公英的Fastlane插件安装
打开终端,进入你的项目工程的根目录,输入以下命令:
fastlane add_plugin pgyer
出现
Plugin 'fastlane-plugin-pgyer' was added to './fastlane/Pluginfile'
It looks like fastlane plugins are not yet set up for this project.
fastlane will create a new Gemfile at path 'Gemfile'
This change is necessary for fastlane plugins to work
Should fastlane modify the Gemfile at path 'Gemfile' for you?
(y/n)
输入y按回车,出现
Installing plugin dependencies...
Successfully installed plugins
便是安装成功了。
3.编辑Fastfile文件
可参考我目前写的一个简易的
注意:蒲公英的 api_key 和 user_key,开发者在自己账号下的 账号设置-API信息 中可以找到。因为我们是企业证书,指定打包所使用的输出方式所以选择的enterprise,打其它类型的包的方法与enterprise类似,可自定义一个新的lane实现。
参考代码如下
default_platform(:iOS)
scheme=“UBI”
api_key="填写自己的"
user_key="填写自己的"
platform :iOS do
desc "development ipa"
lane :development_build do|options|
gym(
output_name:"#{scheme}_#{get_build_number()}",
clean:true,
configuration:"Release",
export_method:"enterprise",
output_directory:"./fastlane/build",
)
puts "开始上传蒲公英"
pgyer(api_key: "#{api_key}", user_key: "#{user_key}")
end
end
4.命令行打包
在终端输入
fastlane development_build
便会进行自动打包并上传蒲公英了,如果一切顺利到此就结束了,如有遇到问题,可参考我期间遇到的问题
5.踩坑点
最后一步遇到了这样一个问题,fastlane打包失败profile和证书不匹配,如图
原因:项目中的签名选择的是Automatic自动找的profile文件和证书不匹配,改为手动设置profile文件
打包上传到fir的配置Fastlane配置
1.打开终端,进入你的项目工程的根目录,输入以下命令:(同上)
fastlane init
2.蒲公英的Fastlane插件安装
打开终端,进入你的项目工程的根目录,输入以下命令:
fastlane add_plugin versioning
fastlane add_plugin firim
3.编辑Fastfile文件
可参考我目前写的一个简易的
参考代码如下
default_platform(:iOS)
scheme=“UBI”
platform :iOS do
desc "development ipa"
lane : to_firim do|options| #注意:后边不可以有空格,不然会报错
gym(
output_name:"#{scheme}_#{get_build_number()}",
clean:true,
configuration:"Release",
export_method:"enterprise",
output_directory:"./firim",
)
puts "开始上传fir"
firim(firim_api_token: "写你自己的")
end
end
4.命令行打包
在终端输入
fastlane to_firim
便会进行自动打包并上传蒲公英了,如果一切顺利到此就结束了
参考文章
安装fastlane
踩坑点
iOS自动化打包发布(Jenkins + Fastlane + GitLab + 蒲公英)
iOS开发之fastlane自动化打包工具安装和使用
fastlane 自动打包到 fir.im 的踩坑之路