iOS 应用打包命令一览
文章转载自：http://www.jianshu.com/p/5d59966eaecc
文章排版部分根据自己的理解做了一些修改。
各种命令的简介
使用命令打包iOS 应用一般会用到 xcodebulid 和 xcrun。
xcodebuild主要是用来编译工程。
xcrun 则是打包出ipa安装包。
altool 适用于提交到AppStore 的。
想要知道更多关于xcodebuild 命令参数，则可以使用xcodebuild -help 查看；
想要知道更多关于xcrun 命令参数，则可是用xcrun -help 查看。
另外，官方文档中有对 Workspace、Project、Scheme、Target更详细的讲解，地址是：Xcode Concepts
altool 这个工具实际上是ApplicationLoader，打开Xcode-左上角Xcode-Open Developer Tool-Application Loader，altool的路径是：
/Applications/Xcode.app/Contents/Applications/Application\ Loader.app/Contents/Frameworks/ITunesSoftwareService.framework/Support/altool
如果使用时，报如下错误：
altool[] *** Error:
Exception while launching iTunesTransporter: Transporter not found at path: /usr/local/itms/bin/iTMSTransporter.
You should reinstall the application.
建立软链：ln -s /Applications/Xcode.app/Contents/Applications/Application\ Loader.app/Contents/itms /usr/local/itms
如果想要在脚本中修改或者读取plist文件的内容，可以使用PlistBuddy，PlistBuddy是Mac里一个用于命令行下读写plist文件的工具，在/usr/libexec/目录下。
下面是一段读取与修改 plist 中版本号的shell脚本：
#!/bin/sh# PlistBuddy程序的绝对路径PlistBuddyPath=/usr/libexec/PlistBuddy# 工程中的plist 文件路径appInfoPlistPath="/Volumes/SourceCode/showstart_ios/ShowStart_3.0/Info.plist"# 读取bundleShortVersion 版本号bundleShortVersion=$($PlistBuddyPath -c "print CFBundleShortVersionString" ${appInfoPlistPath})# 读取bundleVersion 版本号bundleVersion=$($PlistBuddyPath -c "print CFBundleVersion" ${appInfoPlistPath})# 在终端中打印版本号echo "$bundleShortVersion"echo "$bundleVersion"buildNumber="3.69"# 重新设置 plist文件中的bundleVersion版本号bundleVersion=$($PlistBuddyPath -c "Set :CFBundleVersion$buildNumber" ${appInfoPlistPath})# 再次读取bundleVersion 版本号bundleVersion=$($PlistBuddyPath -c "print CFBundleVersion" ${appInfoPlistPath})# 打印版本号echo "$bundleVersion"
Xcode 8之前的打包命令
在Xcode 8之前打包，都是使用xcodebuild+xcrun 来打包ipa包。比如：
xcodebuild -workspace XXX -scheme XXX -configuration Release
xcrun -sdk iphoneos PackageApplication -v "/XXX/XXX.app" -o "/XXX/XXX"
需要注意的是，如果我们同时安装了多个Xcode，比如我这里同时安装的Xcode 7 和 Xcode 8，使用 xcodeuild+xcrun 来打包ipa包 时，会出现如下错误：
2016-11-07 13:43:04.724 xcodebuild[22235:709735] CoreSimulator is attempting to unload a stale CoreSimulatorService job. Detected Xcode.app relocation or CoreSimulatorService version change. Framework path (/Applications/Xcode.app/Contents/Developer/Library/PrivateFrameworks/CoreSimulator.framework) and version (209.19) does not match existing job path (/Applications/Xcode_8.app/Contents/Developer/Library/PrivateFrameworks/CoreSimulator.framework/Versions/A/XPCServices/com.apple.CoreSimulator.CoreSimulatorService.xpc/Contents/MacOS/com.apple.CoreSimulator.CoreSimulatorService) and version (303.8).
2016-11-07 13:43:04.982 xcodebuild[22235:709735] Failed to locate a valid instance of CoreSimulatorService in the bootstrap. Adding it now.
2016-11-07 13:43:04.996 xcodebuild[22235:709735] *** Assertion failure in -[SimServiceContext reloadServiceIfMovedOrAbortIfWeAreInvalid], /BuildRoot/Library/Caches/com.apple.xbs/Sources/CoreSimulator/CoreSimulator-209.19/CoreSimulator/SimServiceContext.m:536
** INTERNAL ERROR: Uncaught exception **
Uncaught Exception: The loaded com.apple.CoreSimulator.CoreSimulatorService job does not match our expectations: pathOfLoadedJob: /Applications/Xcode_8.app/Contents/Developer/Library/PrivateFrameworks/CoreSimulator.framework/Versions/A/XPCServices/com.apple.CoreSimulator.CoreSimulatorService.xpc/Contents/MacOS/com.apple.CoreSimulator.CoreSimulatorService, our frameworkPath: /Applications/Xcode.app/Contents/Developer/Library/PrivateFrameworks/CoreSimulator.framework
我在stackoverflow上找到了解决方案：
在终端中执行如下命令：
launchctl remove com.apple.CoreSimulator.CoreSimulatorService || true
stackoverflow 上答案地址：
CoreSimulator is attempting to unload a stale CoreSimulatorService job
Random build failures on Teamcity
关于 xcodebuild+xcrun 的更多 参数 和介绍，在上面简介中已经列出，这里就不再赘述了。
Xcode 8 以及 之后的打包命令
安装Xcode 8之后，使用xcodebuild+xcrun 打包时， 会提示 让我们使用 -exportArchive 命令来构建。
关于 -exportArchive,在 xcodebuild -help 中有如下提示：
xcodebuild -exportArchive -archivePath -exportPath -exportOptionsPlist ······-exportOptionsPlist PATH specifies a path to a plist file that configures archive exporting
如何获取工程的CODE_SIGN_IDENTITY和PROVISIONING_PROFILE
右键 xxx.xcodeproj 显示包内容 然后打开project.pbxproj文件
command F 搜索 CODE_SIGN_IDENTITY 和 PROVISIONING_PROFILE
PROVISIONING_PROFILE 使用uuid或者名称都可以。
因为我这里打包用的Release模式所以,我在查找CODE_SIGN_IDENTITY和PROVISIONING_PROFILE都是找的Release模式配置。
使用atool时 最终输出的xml 中包含 success-message表示成功,如果包含product-errors表示失败。
我们可以将要执行的命令，写进一个shell脚本文件中，这样更方便执行。
给一个文件添加执行权限的命令是：chmod +x xcodebuild.sh
还有更多其他的文件权限，如 读、写权限。可以看Linux 命令中的 第10条 chmod 命令
进入脚本所在的目录，执行脚本，有两种方式
// 第一种sh xxxx.sh// 第二种./xxxx.sh
脚本中执行if 条件判断的格式：
if []
then
.......//执行的命令
else
.......//执行的命令
fi
完整的脚本如下：
#!/bin/shecho "~~~~~~~~~~~~~~~~开始执行脚本~~~~~~~~~~~~~~~~"# 开始时间beginTime=`date +%s`
DATE=`date '+%Y-%m-%d-%T'`#需要编译的 targetNameTARGET_NAME="xxxx"#编译模式 工程默认有 Debug Release CONFIGURATION_TARGET=Release#编译路径BUILDPATH=~/Desktop/${TARGET_NAME}_${DATE}#archivePathARCHIVEPATH=${BUILDPATH}/${TARGET_NAME}.xcarchive#输出的ipa目录IPAPATH=${BUILDPATH}#证书名CODE_SIGN_IDENTITY="xxxxx"#描述文件PROVISIONING_PROFILE_NAME="xxxx"#苹果账号AppleID="xxxx"AppleIDPWD="xxxx"#导出ipa 所需plistADHOCExportOptionsPlist=./ADHOCExportOptionsPlist.plist
AppStoreExportOptionsPlist=./AppStoreExportOptionsPlist.plist
ExportOptionsPlist=${ADHOCExportOptionsPlist}# 是否上传蒲公英UPLOADPGYER=false# 是否上传AppStoreUPLOADAPPSTore=falseecho "~~~~~~~~~~~~~~~~选择打包方式~~~~~~~~~~~~~~~~"echo " 1 ad-hoc (默认)"echo " 2 AppStore "# 读取用户输入并存到变量里read parameter
sleep 0.5method="$parameter"# 判读用户是否有输入 if [ -n "$method" ]then if [ "$method" = "1" ]
then
PROVISIONING_PROFILE_NAME="xxxx" ExportOptionsPlist=${ADHOCExportOptionsPlist} elif [ "$method" = "2" ]
then UPLOADAPPSTore=true PROVISIONING_PROFILE_NAME="xxxx" ExportOptionsPlist=${AppStoreExportOptionsPlist} else echo "参数无效...." exit 1 fielse ExportOptionsPlist=${ADHOCExportOptionsPlist}fiif [ $UPLOADAPPSTore = false ]then echo "~~~~~~~~~~~~~~~~是否上传蒲公英~~~~~~~~~~~~~~~~" echo " 1 不上传 (默认)" echo " 2 上传 " read para
sleep 0.5 if [ -n "$para" ]
then if [ "$para" = "1" ]
then
UPLOADPGYER=false elif [ "$para" = "2" ]
then UPLOADPGYER=true else echo "参数无效...." exit 1 fi else UPLOADPGYER=false fifiecho "~~~~~~~~~~~~~~~~开始编译~~~~~~~~~~~~~~~~~~~"echo "~~~~~~~~~~~~~~~~开始清理~~~~~~~~~~~~~~~~~~~"# 清理 避免出现一些莫名的错误xcodebuild clean -workspace ${TARGET_NAME}.xcworkspace \
-configuration \${CONFIGURATION} -alltargetsecho "~~~~~~~~~~~~~~~~开始构建~~~~~~~~~~~~~~~~~~~"#开始构建xcodebuild archive -workspace ${TARGET_NAME}.xcworkspace \
-scheme ${TARGET_NAME} \
-archivePath ${ARCHIVEPATH} \
-configuration ${CONFIGURATION_TARGET} \
CODE_SIGN_IDENTITY="${CODE_SIGN_IDENTITY}" \
PROVISIONING_PROFILE="${PROVISIONING_PROFILE_NAME}"echo "~~~~~~~~~~~~~~~~检查是否构建成功~~~~~~~~~~~~~~~~~~~"# xcarchive 实际是一个文件夹不是一个文件所以使用 -d 判断if [ -d "$ARCHIVEPATH" ]thenecho "构建成功......"elseecho "构建失败......"rm -rf $BUILDPATHexit 1fiendTime=`date +%s`
ArchiveTime="构建时间$[ endTime - beginTime ]秒"echo "~~~~~~~~~~~~~~~~导出ipa~~~~~~~~~~~~~~~~~~~"beginTime=`date +%s`
xcodebuild -exportArchive \
-archivePath ${ARCHIVEPATH} \
-exportOptionsPlist ${ExportOptionsPlist} \
-exportPath ${IPAPATH}echo "~~~~~~~~~~~~~~~~检查是否成功导出ipa~~~~~~~~~~~~~~~~~~~"IPAPATH=${IPAPATH}/${TARGET_NAME}.ipaif [ -f "$IPAPATH" ]thenecho "导出ipa成功......"elseecho "导出ipa失败......"# 结束时间endTime=`date +%s`echo "$ArchiveTime"echo "导出ipa时间$[ endTime - beginTime ]秒"exit 1fiendTime=`date +%s`
ExportTime="导出ipa时间$[ endTime - beginTime ]秒"# 上传AppStoreif [ $UPLOADAPPSTore = true ]then
altoolPath="/Applications/Xcode.app/Contents/Applications/Application\ Loader.app/Contents/Frameworks/ITunesSoftwareService.framework/Versions/A/Support/altool" ${altoolPath} --validate-app \
-f ${IPAPATH} \
-u ${AppleID} \
-p ${AppleIDPWD} \
-t ios --output-format xml
if [ $? = 0 ]
then echo "~~~~~~~~~~~~~~~~验证ipa成功~~~~~~~~~~~~~~~~~~~" ${altoolPath} --upload-app \
-f ${IPAPATH} \
-u ${AppleID} \
-p ${AppleIDPWD} \
-t ios --output-format xml
if [ $? = 0 ]
then echo "~~~~~~~~~~~~~~~~提交AppStore成功~~~~~~~~~~~~~~~~~~~" else echo "~~~~~~~~~~~~~~~~提交AppStore失败~~~~~~~~~~~~~~~~~~~" fi else echo "~~~~~~~~~~~~~~~~验证ipa失败~~~~~~~~~~~~~~~~~~~" fielse # 上传蒲公英 if [ $UPLOADPGYER = true ]
then echo "~~~~~~~~~~~~~~~~上传ipa到蒲公英~~~~~~~~~~~~~~~~~~~" curl -F "file=@$IPAPATH" \
-F "uKey=xxxxx" \
-F "_api_key=xxxx" \
-F "password=xxxxx" \
-F "isPublishToPublic=xxxx" \
https://www.pgyer.com/apiv1/app/upload --verbose
if [ $? = 0 ]
then echo "~~~~~~~~~~~~~~~~上传蒲公英成功~~~~~~~~~~~~~~~~~~~" else echo "~~~~~~~~~~~~~~~~上传蒲公英失败~~~~~~~~~~~~~~~~~~~" fi fifiecho "~~~~~~~~~~~~~~~~配置信息~~~~~~~~~~~~~~~~~~~"echo "开始执行脚本时间:${DATE}"echo "编译模式:${CONFIGURATION_TARGET}"echo "导出ipa配置:${ExportOptionsPlist}"echo "打包文件路径:${ARCHIVEPATH}"echo "导出ipa路径:${IPAPATH}"echo "$ArchiveTime"echo "$ExportTime"exit 1
