前言

在iOS开发中，我们常用的打包上传方式就是用Xcode的archive方式打包。到了测试阶段，需要频繁的打包提交到测试平台，整个流程包括：编译-打包-上传，整个过程需要我们去坚守每一步操作，提交app store同样免不了一系列复杂动手操作过程。

对此，我们研究了iOS自动化打包，通过使用shell脚本，输入命令，一键打包上传，提高工作效率。

在了解自动化打包之前，我们先看下我们传统的打包方式：

第一种打包方式：传统打包方式(archive方式)

就是我们的传统打包方式——利用Xcode进行archive(归档)操作，通过编译、build构建、Archive存档、Export导出ipa。

打包前准备工作： 设置好对应版本号，证书正确配置，或使用自动管理证书,然后选择通用设备； 开始进行achive归档打包：点击左上角product——>achive:如下图：

通过编译归档之后生成archive文件，再点击右侧的distribute App，如下图:

然后选择打包环境，如下图，第1种: 生产环境，上传到appStore的；第2种: 测试环境的上传到蒲公英或fir上的；第3种：用于企业账号发布；第4种: 开发调试用的，debug模式会输出日志信息。开发测试一般用第2种或第4种。

按提示点击next下一步操作，最后export导出来，会生成一个文件夹，里面装了ipa包，就是我们需要上传ipa包。通过xcode自带的插件工具Application Locader(通过右击Xcode图标选择Open Developer Tool)选择ipa包上传就行了。

第二种打包方式：也可以通过生成文件Payload文件夹，生成ipa包

操作步骤：

打包前准备：同样要相关证书的配置，编译能通过不报错。 选择要编译的Shcheme，然后command+B编译成功，在products文件夹里可以看到由之前的红色变成了黑色如下图：上图(编译前)，下图(编译后)

右键编译后的Projudct，show in Finder里面找到这个app如下图:

在桌面建一个文件夹叫“Payload”，注意一个字母也不能改，然后把这个app放入这个文件夹里，压缩成zip，再修改后缀为.ipa。上传操作同第一种方式一样。

自动化打包上传

打包原理：

主要是通过shell脚本实现archive->生成ipa->上传到第三方平台(Fir.im 、蒲公英)或 App store这一系列过程的自动化。

准备工作：安装fir-cli插件

打开终端输入sudo gem install fir-cli，如下图，这里输入命令安装的时候要注意下权限问题。

// 安装指令

gem sudo install fir-cli

对于没有安装过rvm的，需要安装rvm(一个命令行工具，可以提供一个便捷的多版本 Ruby 环境的管理和切换)

安装rvm,网上有大把的教程。

相关环境配置、shell脚本编写

根据需求，我这里做了3种环境配置，appStore、ad-hoc、development三种环境plist文件添加和设置，如下图

用xcode创建这三份plist文件放在当前工程目录里。这里制作了一份通用shell脚本(以fir和appStore为例)：

#先清理目录(由于历史编译存留的文件)

if [ -d ./ipaDir ];

then

rm -rf ./ipaDir

fi

if [ -d ./build ];

then

rm -rf ./build

fi

#ipa包存放路径

if [ ! -d ./ipaDir ];

then

mkdir -p ipaDir;

fi

#脚本执行目录/工程绝对路径

project_path=$(cd `dirname $0`; pwd)

#工程名 将XXX替换成自己的工程名

project_name=XXX

#scheme名 将XXX替换成自己的sheme名

scheme_name=XXX

#打包模式 Debug/Release

development_mode=Debug

#build文件夹路径

build_path=${project_path}/build

#plist文件所在路径

exportOptionsPlistPath=${project_path}/exportTest.plist

#导出.ipa文件所在路径

exportIpaPath=${project_path}/ipaDir/${development_mode}

#输入1:appStore(发布)  2:ad-hoc(开发-测试) 3:dev(开发-测试)

echo "Place enter the number you want to export ? [ 1:app-store 2:ad-hoc 3:dev] "

read number

while([[ $number != 1 ]] && [[ $number != 2 ]] && [[ $number != 3 ]])

do

echo "Error! Should enter 1 or 2 or 3"

echo "Place enter the number you want to export ? [ 1:app-store 2:ad-hoc 3:dev] "

read number

done

#appStore

if [ $number == 1 ];then

development_mode=Release

exportOptionsPlistPath=${project_path}/exportAppstore.plist

exportIpaPath=${project_path}/ipaDir/${development_mode}

#ad-hoc

elif [ $number == 2 ];then

development_mode=Release

exportOptionsPlistPath=${project_path}/exportTest.plist

#dev

else

scheme_name=fenlibao_iphone_DEV

development_mode=Debug

exportOptionsPlistPath=${project_path}/exportTest_DEV.plist

fi

echo '/// 正在编译工程:'${development_mode}

echo '///-----------'

#如果工程不是.xcworkspace类型而是.xcodeproj类型，则下面的.xcworkspace换成.xcodeproj

xcodebuild \

archive -workspace ${project_path}/${project_name}.xcworkspace \

-scheme ${scheme_name} \

-configuration ${development_mode} \

-archivePath ${build_path}/${project_name}.xcarchive  -quiet  || exit

echo '///--------'

echo '/// 打包中...'

echo '///--------'

xcodebuild -exportArchive -archivePath ${build_path}/${project_name}.xcarchive \

-configuration ${development_mode} \

-exportPath ${exportIpaPath} \

-exportOptionsPlist ${exportOptionsPlistPath} \

-quiet || exit

echo '///-------------'

echo '/// 开始上传ipa包 '

echo '///-------------'

if [ $number == 1 ];then

#验证并上传到App Store

# 将-u 后面的XXX替换成自己的AppleID的账号，-p后面的XXX替换成自己的密码(注:如果已开启双重认证，则密码为专用密码，专用密码要在开启双重认证后才能开启)

altoolPath="/Applications/Xcode.app/Contents/Applications/Application Loader.app/Contents/Frameworks/ITunesSoftwareService.framework/Versions/A/Support/altool"

"$altoolPath" --validate-app -f ${exportIpaPath}/${scheme_name}.ipa -u XXX -p XXX -t ios --output-format xml

"$altoolPath" --upload-app -f ${exportIpaPath}/${scheme_name}.ipa -u XXX -p XXX -t ios --output-format xml

else

#上传到Fir

# 将XXX替换成自己的Fir平台的token

fir login -T XXX

fir publish $exportIpaPath/$scheme_name.ipa

fi

exit 0

把shell脚本和三个plist配置文件放在工程目录下，将shell脚本做相应修改：

换成自己项目的工程名和scheme名称

#工程名 将XXX替换成自己的工程名

project_name=XXX

#scheme名 将XXX替换成自己的sheme名

scheme_name=XXX

下面代码是在上传appStore的时候需要知道appleID 和密码

#验证并上传到App Store

# 将-u 后面的XXX替换成自己的AppleID的账号，-p后面的XXX替换成自己的密码(注:如果已开启双重认证，则密码为专用密码，专用密码要在开启双重认证后才能开启)

altoolPath="/Applications/Xcode.app/Contents/Applications/Application Loader.app/Contents/Frameworks/ITunesSoftwareService.framework/Versions/A/Support/altool"

"$altoolPath" --validate-app -f ${exportIpaPath}/${scheme_name}.ipa -u XXX -p XXX -t ios --output-format xml

"$altoolPath" --upload-app -f ${exportIpaPath}/${scheme_name}.ipa -u XXX -p XXX -t ios --output-format xml

这里要注意的一点就是对于开启了双重认证的账号，密码不是账号登录密码，而是app专用密码，app专用密码是要在开启双重认证之后，需要自己去开发者网站的用户信息设置里去生成。

在上传fir内测平台的时候要自己fir平台的token，进入fir我的应用去获取token，获取方式如下图：

以上就完成了自动化的所有配置。1个shell脚本，3个plist文件对应三种打包环境，文件位置如下：

开启一键打包上传

接下来就是一行命令执行自动化打包上传：

打开终端，cd到要打包的工程目录下，输入"./shell.sh" 回车,如下

这里会让你选择之前配置的3种环境中的一种环境，只能输入1、2、3，如果输入其他的数字会无效，让你重新输入，输入之后回车就开始执行自动化打包上传操作了，上传成功显示如下：

自动化打包注意事项

打包之前，确保证书配置正确，配置plist文件里面的compileBitcode设置为false，否则会打包报错；

fir-cli安装时由于系统版本原因会提示各种权限不足，解决方式： sudo gem install-n/usr/local/bin fir-cli；

根据工程类型是.xcodeproj类型还是.workspace，脚本编译代码改成相应的工程类型；

打包到appStore的时候，对于开启双重认证的开发者账号，密码必须为账户的app专用密码，而不是开发者账号的登录密码。

总结

传统的打包方式耗费了我们开发者更多的时间和体力，而且效率低下，出错率也要偏高；利用shell脚本自动化打包，降低了人工操作成本,加快了工作效率。

- END -

更多推荐内容

《分利宝微服务实践》

《看看前端自动化构建，我们是这样做的》

《Pytest进行UI自动化测试实用操作》

《每个Android开发都必须知道的利器》

《kubernetes 单master集群的搭建》