[iOS-Release] 自动打包分发

在 iOS 的日常开发中,需要不断的向测试人员提供最新的测试版本。这一过程的手动操作分为3步:

  1. 对应用 target 执行 archive 操作。
  2. 用 archive 产生的内容导出 Ad Hoc 包。
  3. 将导出的.ipa包上传至应用分发平台,以供测试人员安装。

这是一个重复性的且很耗时的操作,另外,通常都需要提供不止一种环境的测试版本,例如开发环境和生产环境等,这样就成倍增加了打包分发的时间。如果在 Xcode 中已设置好对应的签名文件后,使用脚本自动执行整个过程,则可以节省大量时间,提高工作效率。

整个操作过程用到两部分命令。一个是苹果公司提供的自动构建命令 xcodebuild,使用该命令来进行 archive 与导出.ipa包的操作。另一部分是通过curl命令调用 API 来上传导出的.ipa包,具体的 API 使用方式需要查看你所使用的分发平台的 API 文档。

Archive 操作

因为大部分的应用都是在 workspace 中搭建的,所以以对 workspace 中的应用执行 archive 操作的命令为例,对于其他的构建方式,可以参考手册进行修改。

xcodebuild archive -workspace ApplicationName.xcworkspace -scheme ApplicationName -archivePath ./build/ApplicationName.xcarchive

命令中使用 -archivePath 将产生的 .xcarchive 文件指定到项目目录的 build 的路径下,以便后续的导出.ipa包的操作。另外,如果是对 project 中的应用打包,要在 ProjectName.xcodeproj 所在的目录执行命令,如果该目录下有多个 .xcodeproj,那么需要使用 -project 指定。

导出 Ad Hoc 包

使用xcodebuild -exportArchive命令从上一步产生的 .xcarchive 文件中导出.ipa包,完整的命令如下:

xcodebuild -exportArchive -archivePath ./build/ApplicationName.xcarchive -exportPath ./build -exportOptionsPlist ad_hoc_options.plist

-archivePath指明了上一步产生的 .xcarchive 文件所在目录,-exportPath则是代表了导出的.ipa包存放的路径,同样放在项目目录的 build 的路径下,方便最后的清理删除。注意最后一个参数-exportOptionsPlist,指明了一个 .plist 文件的路径,该文件设置了导出.ipa包相关的一些参数,如 method=ad-hoc 指明了导出的.ipa包是通过Ad-Hoc方式进行分发的,可配置的参数可使用xcodebuild --help命令查看。ad_hoc_options.plist 文件中的内容如:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>method</key>
    <string>ad-hoc</string>
</dict>
</plist>

上传.ipa包至分发平台

以蒲公英平台为例,根据文档,可直接使用curl命令将导出的.ipa包上传至分发平台:

curl -F "file=@./build/ApplicationName.ipa" -F "uKey=your_user_key" -F "_api_key=your_api_key" -F "updateDescription=your_description" http://www.pgyer.com/apiv1/app/upload

处理多个测试环境

通常情况下,开发中都有不止一种的测试环境,针对不同环境,可能有不同的域名或其他区别,最简单的可以分为开发和生产环境。对于不同的环境,我们可以对应设置不同的 Configuration,比如 Debug 对应开发环境,Release 对应生产环境。因为开始的 archive 操作是针对 scheme 的,所以我推荐针对每一种 Configuration 建立一个 scheme,这样就相当于每一种开发环境都有一个对应的 scheme。之后在脚本中初始化所有环境的 scheme,然后循环执行相关操作,就可以完成所有测试环境的打包分发工作了。

schemes=(ApplicationName-debug ApplicationName-release)

for scheme in ${schemes[@]}; do
# do something
done

脚本

最终的 shell 脚本如下,配合构建号的自动修改,可以很好的完成自动打包分发的工作。

cd ~/ApplicationName
schemes=(ApplicationName-debug ApplicationName-release)

for scheme in ${schemes[@]}; do
    xcodebuild archive -workspace ApplicationName.xcworkspace -scheme ${scheme} -archivePath ./build/${scheme}.xcarchive

    if [ $? -ne 0 ]; then
        continue
    fi

    xcodebuild -exportArchive -archivePath ./build/${scheme}.xcarchive -exportPath ./build -exportOptionsPlist ad_hoc_options.plist
    
    if [ $? -ne 0 ]; then
        continue
    fi

    if [ ${scheme} = "ApplicationName-debug" ]; then
        description="Develop Environment"
    elif [ ${scheme} = "ApplicationName-release" ]; then
        description="Production Environment"
    fi

    curl -F "file=@./build/${scheme}.ipa" -F "uKey=your_user_key" -F "_api_key=your_api_key" -F "updateDescription=${description}" http://www.pgyer.com/apiv1/app/upload
done

rm -rf ./build

注意 scheme 数组,先执行开发环境,再执行生产环境。这样上传 ipa 包后,生产环境会是最新上传的版本,即下载页顶部的当前版本,而开发环境则在下方历史版本列表里的最上面。这样更符合测试人员的使用习惯,因为更多的时候是要安装生产环境,如果需要安装测试环境,则从下方历史版本列表里选择。

ToDo

因为目前在工作中是一个人单独负责应用开发,且没有多余的机器作为 CI 的服务器,所以这种半自动化的方式已经满足需求了,后续再研究持续集成的内容。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,324评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,303评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,192评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,555评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,569评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,566评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,927评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,583评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,827评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,590评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,669评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,365评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,941评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,928评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,159评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,880评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,399评论 2 342

推荐阅读更多精彩内容