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

一、前言

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

二、牛逼的工具fastlane

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

三、实现原理简介

1、安装fastlane

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

$ sudo gem install fastlane
1
1

(需提前安装gem环境)

2、使用gym工具

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

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

$ fastlane gym
1
1

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

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

$ fastlane gym --export_method ad-hoc
1
1

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

3、使用fir

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

$ gem install fir-cli
1
1

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

$ fir login XXX_YOUR_API_TOKEN_XXX
1
1

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

$ fir publish APP_FILE_PATH
1
1

四、自动化打包

为了实现一键打包的方案，需要将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
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
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

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

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

$ ./AutoPack.sh
1
1

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

五、遇到的问题

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

六、参考

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