xcodebuild和xcrun实现自动打包iOS应用程序
随着苹果手持设备用户的不断增加,ios应用也增长迅速,同时随着iphone被越狱越来越多的app的渠道也不断增多,为各个渠道打包成了一件费时费力的工作,本文提供一种比较智能的打包方式来减少其带来的各种不便。
自动化打包背景介绍
1、背景
随着ios程序发布的渠道逐渐的增多,为每个渠道打包也成为特别耗费时间和体力的一项技术活了,而这一般大多数都是由rd来完成的。这样就占用了rd很多的开发时间,何不把这些东西写成一个自动化的脚本,然后交给qa或是pm来完成这个打包过程了。经过一番调研发现网上这种脚本还是很少的,不过xcode提供了shell编译工具xcodebuild和ipa打包工具xcrun,这就有理由让我们利用这两个工具写一个自动化的打包脚本来提高我们的工作效率和自动化程度。
2、ios程序包格式、渠道包格式
1)产生多渠道的原因及多渠道带来的打包问题:随着iphone、ipad、itouch等手持设备火热销售,而它们上面的应用也随之火爆了起来,而随之而来的就是以上设备被越狱后就可以在越狱的设备上直接运行ipa程序包而不用通过appstore去下载,这样一来国内就产生了众多的专门为越狱手机而开设的渠道提供ipa程序包的下载。随着越来越多的渠道,推广时为各个渠道打包就成了一项比较耗费时间和精力的技术活了,因此我们必须寻找一种自动化的方式让打包变得高效简单。
2)Ios程序包分为appstore二进制文件跟渠道包两种格式
appstore二进制文件:通过xcode工具可以生成一个.app格式的二进制文件。
渠道包:格式为.ipa格式,在没有自动化打包工具之前都是利用xcode来生成相应的渠道包,而且每次只能生成一个渠道包,每次打包之前都得手动该渠道ID,带来的问题就是耗费时间、效率低下、容易出错、增加风险。
3、传统的ios打包方式
利用xcode打包
1)appstore二进制程序包
打开你的项目,进入“EditProjectSettings”,进入Configuration页面,选中Release点击下面的Duplicate,复制一个新的配置项出来,命名为Distribution。然后进入Build页面,顶上的Configuration下拉框选中Distribution,下面的CodeSigningIdentity里面的AnyiPhoneOSDevice后面对应的值选中你的那个Distribution的证书。然后点击“Build”–>“Build”就可以编译程序了
编译成功后,你就可以在相应的build目录下看到一个.app的二进制文件。
2)渠道ipa包
根据以上步骤同样配置好Distribution证书,然后点击“Build”–>“BuildandArchive”就可以编译程序了。接着打开“Window””Organizer”左边栏中选择”ARCHIVEDAPPLICATIONS”然后再右侧列表中选中刚才编译的程序包再点击右侧右边顶部的”Share”按钮保存到磁盘即可。就会生成一个.ipa的文件即为渠道包。
注意:以上运行设备必须选择“Deveice“
4、传统的打包带来的问题
耗费时间、耗费体力、效率低下、只能依赖RD来完成、容易出错、发布风险比较高、QA回归确认比较困难、不智能化。
自动化打包具体实现
C/C++ Code复制内容到剪贴板 xcodebuild[-project][-activetarget][-alltargets][-target]...[-parallelizeTargets][-activeconfiguration][-configuration][-sdk |][=]...[]... xcodebuild[-version[-sdk |]] xcodebuild[-showsdks] xcodebuild[-find ][-sdk |] xcodebuild[-list]
1、xcodebuild介绍:
也可以在终端输入:xcodebuild–help或–h查看具体的选项
显示xcodebuildversion:xcodebuild–version
显示当前系统安装的sdk:xcodebuild–showsdks
显示当前目录下projectInformation:xcodebuild–list
需要注意的是:执行以上命令时必须把位置定位在ios项目文件的根目录下否则会提示找不相关命令的。
2、xcrun介绍:
此工具主要用于将app文件打包成ipa格式的程序包。(主要用于已越狱手机)。
具体用法如下:
其中:-v对应的是app文件的绝对相对路径–o对应ipa文件的路径跟文件名–sign
对应的是发布证书中对应的公司名或是个人名–embed对应的是发布证书文件
注意如果对应的Distribution配置中已经配置好了相关证书信息的话–sign和–embed可以忽略
3、具体方案
a)从源程序一次性打出所有渠道的ipa包跟appstore的二进制包
为了让自动化脚本执行一次把所有的渠道包都打好,所以必须有一个配置文件用来存储所有的渠道名跟渠道号,而项目文件中也应该有个对应存储当前渠道号的文件,每次程序都从这个存放渠道号的文件中读取渠道号即可,大概的思路就是利用脚本循环执行打包过程,而每次打包前都通过脚本修改项目中存放渠道号的文件为当前循环的最新渠道号,让后逐个打包。
注:具体事例见附录
b)提供一个ipa格式的母包从母包生成其它所有的渠道包跟appstore包
qa的一些疑问,如何确保所有的渠道包就是他们验证过的那份代码呢?
的确,以上代码每次都是重新对程序进行打包,可qa往往测试验证的只有一个包,如果个个去验证无意中之中又增加了qa的工作量哈!!而且风险也不可控。因此基于上面的问题我们想出了一下办法:qa只验证一个程序包(即母包)如果这个包通过验证我们就通过母包去生成其它渠道的包,这样一来qa也不用确认那么多的渠道包了,风险也得到了有效的控制。
可能你会问:用一个包生成其他的包可行么??
原因是这样的:因为每个渠道只是渠道号发生变化,而其他的内容又不会发生变化,而我们的渠道号又是存储在sourceid.dat这个文件中的,所以只要改变母包中的sourceid.dat文件的内容即可,而ipa包又是同zip格式进行压缩,所以基本思路就是通过zip先对母包进行解压,然后改变sourceid.dat的内容最后再用zip进行压缩成相应的渠道包即可。
Ipa包的目录:
注:具体事例见附录
一些问题
当有些shell命令在mac的终端中运行不通过时,请确保你的shell脚本是在mac环境下编写的而不是同xp等其他环境中copy过来的。因为mac跟xp的编码是不一样所以会有问题。
总结:
通过从母包打出其他渠道的包这种方法:得到以下好处
i.降低了rd的工作量,一起qa的工作量。
ii.让测试发布程序时的风险得到了控制。
iii.提高了打包发布工作效率。(几十个包只需短短的几分钟)。
iv.提高了自动化。
v.不依赖mac以及xcode环境直接在linux下即可完成从母包生成其它包
附录
利用xcode环境一次生成所有包的shell脚本代码:
C/C++Code复制内容到剪贴板
#!/bin/sh xcodebuild clean -configuration Distribution //clean项目 distDir="/Users/xxxx/dist" releaseDir="build/Distribution-iphoneos" version="1_0_0" rm -rdf "$distDir" mkdir "$distDir" for line in $(cat data.dat) //读取所有渠道号data.dat文件 do ipafilename=`echo $line|cut -f1 -d':'` //渠道名 sourceid=`echo $line|cut -f2 -d':'` //渠道号 echo "ipafilename=$ipaname" echo "sourceid=$sourceid" targetName="youtargename" //项目名称(xcode左边列表中显示的项目名称) echo "sourceid=$sourceid" echo "ipafilename=$ipafilename" echo "$sourceid" > sourceid.dat echo "sourceid.dat: " cat sourceid.dat rm -rdf "$releaseDir" ipapath="${distDir}/${targetName}_${version}_from_${sourceid}.ipa" echo "***开始build app文件***" xcodebuild -target "$targetName" -configuration Distribution -sdk iphoneos build appfile="${releaseDir}/${targetName}.app" if [ $sourceid == "appstore" ] then cd $releaseDir zip -r "${targetName}_${ipafilename}_${version}.zip" "${targetName}.app" mv "${targetName}_${ipafilename}.zip" $distDir 2> /dev/null cd ../.. else echo "***开始打ipa渠道包****" /usr/bin/xcrun -sdk iphoneos PackageApplication -v "$appfile" -o "$ipapath" --sign "iPhone Distribution:xxxxxx" fi done
注:以上的data.dat文件为存放渠道号列表的文件其格式为:3g:1001b即(渠道名:渠道号)sourceid.dat为项目文件中存放渠道号的文件(内容只有一个渠道号)。当然了上面脚本只是说明了下如何利用xcodebuild和xcrun进行打包以及自动打包的一个逻辑,shell脚本好的同学可以自由发挥哈。。。
从ipa格式的母包生成其它渠道包的shell脚本实例:
复制内容到剪贴板
#!/bin/sh sourceipaname="母包名.ipa" appname=”app文件名.app” //加压后Pauload目录项.app文件名需要根据自己的项目修改 distDir="/Users/lxxx/Qa" //打包后文件存储目录 version="1.0.0" rm -rdf "$distDir " mkdir "$distDir" unzip $sourceipaname //解压母包文件 for line in $(cat data.dat) //读取渠道号文件并进行循环 do ipafilename=`echo $line|cut -f1 -d':'` sourceid=`echo $line|cut -f2 -d':'` echo "ipafilename=$ipaname" echo "sourceid=$sourceid" targetName="ipa包名" echo "sourceid=$sourceid" echo "ipafilename=$ipafilename" cd Payload cd $appname echo "replace sourceid.dat before: " cat sourceid.dat echo "$sourceid" > sourceid.dat echo "replace sourceid.dat after: " cat sourceid.dat if [ $sourceid == "appstroe" ] then cd .. zip -r "${targetName}_${version}_from_${sourceid}.zip" $appname //appstore二进制文件 mv "${targetName}_${version}_from_${sourceid}.zip" $distDir cd .. else cd ../.. zip -r "${targetName}_${version}_from_${sourceid}.ipa" Payload //打成其他渠道的包 mv "${targetName}_${version}_from_${sourceid}.ipa" $distDir fi done rm -rdf Payload
注:以上data.dat也是用来存储所有渠道号的,sourceipaname就是通过qa验证的母包,appname为ipa包加压后Payload目录下的app文件名并且以上所有文件必须与脚本文件保持在同一目录下以及在mac环境中执行。
扩展阅读:http://www.cnblogs.com/qq78292959/archive/2011/06/10/2077323.html
原文:http://stblog.baidu-tech.com/?p=1295