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

一、前言

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

二、牛逼的工具fastlane

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

三、实现原理简介

1、安装fastlane

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

1
$ sudo gem install fastlane

(需提前安装gem环境)

2、使用gym工具

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

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

1
$ fastlane gym

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

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

1
$ fastlane gym --export_method ad-hoc

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

3、使用fir

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

1
$ gem install fir-cli

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

1
$ fir login XXX_YOUR_API_TOKEN_XXX

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

1
$ fir publish APP_FILE_PATH

四、自动化打包

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
#!/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到项目文件下,执行:

1
$ ./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