iOS自动打包发布工具Fastlane

一、前言

正常的打包流程需要使用Xcode配置证书-执行打包-导出ipa文件-上传到第三方发布平台,例如蒲公英或者Fir。如果想只通过一行命令完成所有打包流程,减少打包步骤,就需要用到一个神奇的工具了。

二、牛逼的工具fastlane

fastlane这个工具牛逼之处就是几乎包含了和ipa相关的所有功能,例如打包、提交审核、测试、自动截屏等等。这里就主要介绍一下其中的打包工具gym。

三、实现原理简介

1、安装fastlane

这里先说一下fastlane的安装,很简单只需在终端输入:

$ sudo gem install fastlane

(需提前安装gem环境)

2、使用gym工具

在安装fastlane时已默认安装了常用工具,所以不需要另外安装gym工具

调用gym需要cd到项目目录,然后执行

$ fastlane gym

这个命令是自动打包然后推送到ITunesConnect中,在这个过程中需要输入AppId及密码。

如果不需要提交到ITunesConnet中,可执行

$ fastlane gym --export_method ad-hoc

会自动生成ipa文件,以便后续操作。
详细的gym命令请参考gym文档

3、使用fir

之前一直是在fir的页面上进行操作,也是第一次在命令行使用fir。
安装 fir-cli

$ gem install fir-cli

安装后可以先执行登陆操作,登陆后在后续操作中可以不用重复添加token了(token需要到fir个人账号中获得),登陆方法:

$ fir login XXX_YOUR_API_TOKEN_XXX

发布ipa到fir,需要提前准备好ipa文件,执行

$ fir publish APP_FILE_PATH

四、自动化打包

为了实现一键打包的方案,需要将gym和fir结合到一起,这里利用了一个脚本文件,在使用时直接执行这个脚本文件即可,文件内容如下:

#!/bin/bash

#设置超时
export FASTLANE_XCODEBUILD_SETTINGS_TIMEOUT=120

#计时
SECONDS=0

#假设脚本放置在与项目相同的路径下
project_path=$(pwd)
#取当前时间字符串添加到文件结尾
now=$(date +"%Y_%m_%d_%H_%M_%S")

#指定项目的scheme名称
scheme="Demo"
#指定要打包的配置名
configuration="Adhoc"
#指定打包所使用的输出方式,目前支持app-store, package, ad-hoc, enterprise, development, 和developer-id,即xcodebuild的method参数
export_method='ad-hoc'

#指定项目地址
workspace_path="$project_path/Demo.xcworkspace"
#指定输出路径
output_path="$project_path/IPA"
#指定输出归档文件地址
archive_path="$output_path/Demo_${now}.xcarchive"
#指定输出ipa地址
ipa_path="$output_path/Demo_${now}.ipa"
#指定输出ipa名称
ipa_name="Demo_${now}.ipa"
#获取执行命令时的commit message
commit_msg="$1"

#输出设定的变量值
echo "===workspace path: ${workspace_path}==="
echo "===archive path: ${archive_path}==="
echo "===ipa path: ${ipa_path}==="
echo "===export method: ${export_method}==="
echo "===commit msg: $1==="

#先清空前一次build
fastlane gym --workspace ${workspace_path} --scheme ${scheme} --clean --configuration ${configuration} --archive_path ${archive_path} --export_method ${export_method} --output_directory ${output_path} --output_name ${ipa_name}

#上传到fir
fir publish ${ipa_path} -T "XXX_YOUR_API_TOKEN_XXX" -c "${commit_msg}"

#输出总用时
echo "===Finished. Total time: ${SECONDS}s==="

(1、使用该文件需要项目支持CocoaPods;2、本项目的项目名称是Demo,在实际使用时需要将Demo替换成自己的项目名称;3、需要将XXX_YOUR_API_TOKEN_XXX 换成自己的fir token)

如文件名文AutoPack.sh,打包时只需要在cd到项目文件下,执行:

$ ./AutoPack.sh

执行后会自动打包,ipa文件自动存储到工程文件同目录下的IPA文件夹下,并且会自动提交到Fir上,整个流程执行结束后会提示完成时间,如出现错误也会打印出来。

五、遇到的问题

在执行上传到Fir上的时候遇到了SSL证书报错,最后找了半天原因是Ruby的数据源地址使用的https地址,换成http地址即可。解决办法戳这里

六、参考

1、使用fastlane gym/xctool编写ipa打包脚本
2、Fastlane自动化构建工具(完整解决测试和发布流程)
3、Fastlane + Bugly自动化部署测试包
4、iOS App 自动化上传 AppStore ,一键部署 App

你可能感兴趣的:(iOS自动打包发布工具Fastlane)