一、前言
正常的打包流程需要使用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