iOS自动化打包 ---- 集成shell脚本

在阅读这篇文章之前
如果有小伙伴还不是很清楚xcodebuild命令的话
建议查看iOS自动化打包 ---- xcodebuild 命令详解

在具备基本知识之后
我们就可以用xcodebuild为所欲为啦~

第一步：

我们为了达到脚本 write once，run anywhere
需要配置一些变量

##!/bin/sh

# 工程绝对路径  (这里注意是shell脚本所在的路径)
project_path=$(cd "$(dirname "$0")";pwd)

# 工程名
project_name=

# Scheme名 
project_scheme=

# 编译模式
build_type=Debug

# workspace名
project_workspace=

# archive_path        eg:$project_path/$project_name.xcarchive
archive_path=

# ipa文件存放路径        eg:$project_path/$project_name.ipa
export_ipa_path=

# exportOptions plist       eg:$project_path/ExportOptions.plist
export_options_plist=

这里说明一下ExportOptions.plist
这个东西我们正常使用xcode打包导出ipa的时候会生成
记录了这次导出时的证书及关键配置
我们可以第一次手动导出查看里面结构信息

image.png

后续根据需要打包导出的需求做调整

第二步：

就是 清理工程-->打包-->导出 三部曲
我们有三种类型的导出方式 dev、adhoc、dis
所以我这边通过输入参数的方式来配置三种类型

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

read number
while [[ $number != 1 ]] && [[ $number != 2 ]] && [[ $number != 3 ]]; do
    #statements
    echo "Error! Should enter 1 or 2 or 3"
    echo "Please enter the number you want to export ? [ 1:app-store 2:ad-hoc 3:develop ] "
    read number
done

if [[ $number == 1 ]]; then
    build_type=Release
    export_options_plist=$project_path/ExportOptions_appstore.plist
elif [[ $number == 2 ]]; then
    build_type=Release
    export_options_plist=$project_path/ExportOptions_adhoc.plist
else
    build_type=Debug
    export_options_plist=$project_path/ExportOptions_dev.plist
fi

中间的export_options_plist根据各自工程情况自己配好对应名称，方便切换

echo "///-----------"
echo "/// 正在清理工程"
echo "///-----------"
xcodebuild clean -workspace $project_workspace -scheme $project_scheme -configuration $build_type -quiet || exit

echo "///-----------"
echo "/// 正在编译工程: ${build_type}"
echo "///-----------"
xcodebuild archive -workspace ${project_workspace} -scheme ${project_scheme} -configuration $build_type -archivePath $archive_path || exit

echo "///-----------"
echo "/// 开始导出ipa: ${export_ipa_path}"
echo "///-----------"
xcodebuild -exportArchive -archivePath $archive_path -exportPath ${export_ipa_path} -exportOptionsPlist ${export_options_plist} -quiet || exit

校验ipa包是否导出

if [[ -e $export_ipa_path/$project_scheme.ipa ]]; then
    echo "///-----------"
    echo "/// ipa包已导出"
    echo "///-----------"
    open $export_ipa_path
fi

到这里，我们的打包大业已经完成啦~
打好包后，我们可以使用第三方平台托管我们的包，以便提供测试人员扫码下载
也可以上传AppStore
这里我们用的是蒲公英平台，其他平台可以参照对应文档作调整

第三步：

if [[ $number == 1 ]]; then

    echo "///--------------------"
    echo "/// 开始发布到 app store"
    echo "///--------------------"

    altoolPath=/Applications/Xcode.app/Contents/Applications/Application\ Loader.app/Contents/Frameworks/ITunesSoftwareService.framework/Support/altool
    "$altoolPath" --validate-app -f $export_ipa_path/$project_scheme.ipa\
                  -u <你的开发者账号> -p <你的开发者账号密码>\
                  --output-format xml
    "$altoolPath" --upload-app -f $export_ipa_path/$project_scheme.ipa\
                  -u <你的开发者账号> -p <你的开发者账号密码>\
                  --output-format xml
else

    echo "///--------------------"
    echo "/// 开始上传ipa包到蒲公英"
    echo "///--------------------"
    curl -F "file=@$export_ipa_path/$project_scheme.ipa"\
         -F "uKey=<你的蒲公英uKey>"\
         -F "_api_key=<你的蒲公英ApiKey>" https://qiniu-storage.pgyer.com/apiv1/app/upload
fi

$altoolPath 是xcode自带的Application Loader 的命令行，可以完成提交到App Store Connect操作，剩下的就坐等审核啦！

2019年11月04日 新增修改

更新完xcode11 之后，很多小伙伴发现曾经的Application Loader 不见了
其实是苹果为了推新的Transporter，大家可以去AppStore搜索下载
看评论是褒贬不一，优化了用户体验，但是据说速度很慢

既然是自动化打包，那么上传还是用脚本来完成吧
老的altool的命令，被集成进了xcode里
大家可以输入下面的命令查看新的打包脚本，和老的没什么出入，换了前缀而已

$ xcrun altool

修改后的AppStore的上传脚本

xcrun altool --validate-app -f $export_ipa_path/$project_scheme.ipa\
                  -u <你的开发者账号> -p <你的开发者账号密码>\
                  --output-format xml
xcrun altool --upload-app -f $export_ipa_path/$project_scheme.ipa\
                  -u <你的开发者账号> -p <你的开发者账号密码>\
                  --output-format xml

当然，还有一种操作就是保留xcode 10.3的Application Loader 然后拷贝到xcode11的对应目录下，重启xcode也可以达到同样的效果

2019年11月19日 新增修改

蒲公英更新了接口文档，清理掉了之前所有的内测包
原本的脚本上传会报下面的错误

210 installType error

查阅信息，并且手动上传之后发现

installType不再支持公开的方式了

因为原来默认是传1的，所以被底层上传接口拦截掉了
所以我们需要在上传脚本中加上 installType才可以成功上传
如果选了 2：密码安装，按需加上 password字段
可能也是为了安全起见吧，要求密码字段不能为空
修改之后的蒲公英上传脚本：

curl -F "file=@$export_ipa_path/$project_scheme.ipa"\
         -F "uKey=d718feb45b310ea811a3f59bf04cca2b"\
         -F "_api_key=82af289e7129f483befc42e6b7ba2443"\
         -F "installType=<2 || 3>"\
         -F "password=<你的密码>" https://upload.pgyer.com/apiv1/app/upload

2019年12月26日 新增修改

以前导出的ExportOptions.plist文件中，因为升级XCode ，加上iOS13之后证书都合一了，称为Apple Development和Apple Distribution，同时文件里对应的profile文件的地方也要同步更新，不然导出会报错

有什么疑问，欢迎留言讨论
以上