iOS由传统打包上传到自动化打包上传

前言

在iOS开发中，我们常用的打包上传方式就是用Xcode的archive方式打包。到了测试阶段，需要频繁的打包提交到测试平台，整个流程包括：编译-打包-上传，整个过程需要我们去坚守每一步操作，提交app store同样免不了一系列复杂动手操作过程。因此，就研究了iOS自动化打包，通过使用shell脚本，输入命令，一键打包上传，提高工作效率。

在讲自动化打包之前，我们先看下我们传统的打包方式:

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

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

1.打包前准备工作：

设置好对应版本号，证书正确配置，或使用自动管理证书,然后选择通用设备，如下图

2.开始进行achive归档打包：点击左上角product——>achive:如下图

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

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

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

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

操作步骤：

1.打包前准备：同样要相关证书的配置，编译能通过不报错。

2.选择要编译的Shcheme，然后command+B编译成功，在products文件夹里可以看到由之前的红色变成了黑色如下图(编译前在上，编译后在下)


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

在桌面建一个文件夹叫“Payload”，注意一个字母也不能改，然后把这个app放入这个文件夹里，压缩成zip，再修改后缀为.ipa,此时，ipa包就出来了。操作如下图

3.上传操作同第一种方式一样。

三、自动化打包上传

打包原理：

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

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

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

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

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

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

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

图3-2-1
用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 '///-----------'
echo '/// 正在清理工程'
echo '///-----------'
xcodebuild \
clean -configuration ${development_mode} -quiet  || exit


echo '///--------'
echo '/// 清理完成'
echo '///--------'
echo ''

echo '///-----------'
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 '///--------'
echo ''

echo '///----------'
echo '/// 开始ipa打包'
echo '///----------'
xcodebuild -exportArchive -archivePath ${build_path}/${project_name}.xcarchive \
-configuration ${development_mode} \
-exportPath ${exportIpaPath} \
-exportOptionsPlist ${exportOptionsPlistPath} \
-quiet || exit

if [ -e $exportIpaPath/$scheme_name.ipa ]; then
echo '///----------'
echo '/// ipa包已导出'
echo '///----------'
open $exportIpaPath
else
echo '///-------------'
echo '/// ipa包导出失败 '
echo '///-------------'
fi
echo '///------------'
echo '/// ipa打包完成  '
echo '///-----------='
echo ''

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脚本做相应修改：

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

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

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

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

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

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

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

3、开启一键打包上传

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

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

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

上传到itunes connect成功显示如下：

4、自动化打包注意事项

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

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

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

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

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