iOS自动打包并发布到Fir.im

Posted 2023-02-15 吴彦祖666

一、前言

最近公司有个新需求，就是后台要添加一个新功能，在页面上更换App的标题、Logo等信息，然后可以自动生成apk和ipa文件。于是就研究了一下自动打包ipa这个功能

二、牛逼的工具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: $SECONDSs==="

（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