xcodebuild是一個命令行工具,可以用來對Xcode工程或工作區進行編譯、查找、分析、測試等各種操作。對于如何使用xcode可以參看http://help.apple.com/xcode/mac/8.0/
iOS自動打包主要用xcodebuild命令, 在終端輸入xcodebuild --help可以查看xcodebuild的參數。
基本概念
workspace 是最大的集合,其可以包含多個 projet,同時可以管理不同的 project 之間的關系。workspace 是以 xcworkspace 的文件形式存在的。workspace 的存在是為了解決原來僅有 project 的時候不同的 project 之間的引用和調用困難的問題
project是Xcode對一些代碼文件、資源、配置信息的一個管理倉庫,可以用來編譯產出一個或多個產品。Project包含了多個targets,project有一個被所有targets公用的build setting。
targets 表示如何產出一個具體產品,決定了如何對文件進行編譯(編譯那幾個文件,使用什么編譯腳本)(通過自己的build setting 和從project繼承的build setting)
configuration 可以對project和targets中
scheme(方案)它不同于上面四個,表示一個組合方案表示那些targets使用什么 build configuration與 executable configuration 。An Xcode scheme defines a collection of targets to build, a configuration to use when building, and a collection of tests to execute.可以針對編譯,運行,單元測試,動態分析,靜態代碼分析以及打包進行一些配置
NAME
?? ? xcodebuild-- build Xcode projects and workspaces
SYNOPSIS
?? ? xcodebuild[-project?name.xcodeproj]
? ? ? ? ? ? ? ? [[-target?targetname] ... |-alltargets]
? ? ? ? ? ? ? ? [-configuration?configurationname]
? ? ? ? ? ? ? ? [-sdk[sdkfullpath | sdkname]] [action ...]
? ? ? ? ? ? ? ? [buildsetting=value ...] [-userdefault=value ...]
?? ? xcodebuild[-project?name.xcodeproj]-scheme?schemename
? ? ? ? ? ? ? ? [[-destination?destinationspecifier] ...]
? ? ? ? ? ? ? ? [-destination-timeout?value]
? ? ? ? ? ? ? ? [-configuration?configurationname]
? ? ? ? ? ? ? ? [-sdk[sdkfullpath | sdkname]] [action ...]
? ? ? ? ? ? ? ? [buildsetting=value ...] [-userdefault=value ...]
?? ? xcodebuild-workspace?name.xcworkspace-scheme?schemename
? ? ? ? ? ? ? ? [[-destination?destinationspecifier] ...]
? ? ? ? ? ? ? ? [-destination-timeoutvalue]
? ? ? ? ? ? ? ? [-configurationc? onfigurationname]
? ? ? ? ? ? ? ? [-sdk[sdkfullpath | sdkname]] [action ...]
? ? ? ? ? ? ? ? [buildsetting=value ...] [-userdefault=value ...]
xcodebuild 構建Xcode project中的一個或多個targets, 也可以構建Xcode workspace或Xcode project的一個scheme。?
要構建一個Xcode project, 在你的工程目錄下運行xcodebuild. 如果這個目錄下有多個project文件則可以使用-project參數用來區分你要編譯哪個project. 默認情況下,xcodebuild 構建project中列出的第一個target, 并且使用默認的build configuration. targets在project中的順序是project的一個屬性對所有的使用者來說這個順序是相同的。?
要構建一個Xcode workspace, 必須要使用參數-workspace 和 -scheme 指定構建。 scheme 控制了需要編譯那些targets以及這個targets如何被編譯。不過也可以通過 xcodebuild的其他參數來從新指定scheme的一些屬性.
自動打包
方法:生成 .xcarchive 再導出 .ipa
進入到 xcode 工程文件所在目錄,然后執行 xcodebuild clean 進行清除
step1 xcodebuild archive生成 .xcarchive
xcodebuild archive -workspace podsoecTest.xcworkspace -scheme podsoecTest -configuration Release -archivePath "~/Desktop/1.xcarchive"
step2 xcodebuild -exportArchive導出.ipa:
xcodebuild -exportArchive -archivePath ~/Desktop/podsoecTest.xcarchive -exportPath ~/Desktop/podsoecTest.ipa -exportFormat IPA
其實現在很多的腳本都是圍繞這個方法編寫的,他們只是將這兩個方法和這兩個方法需要傳遞的參數進行了封裝如下這個腳本(shell)類型
腳本方法xcodebuild自動打包+腳本使用
#!/bin/sh
# 使用方法:
# step1: 將該腳本放在工程的根目錄下(跟.xcworkspace文件or .xcodeproj文件同目錄)
# step2: 根據情況修改下面的參數
# step3: 打開終端,執行腳本。(輸入sh ,然后將腳本文件拉到終端,會生成文件路徑,然后enter就可)
# =============項目自定義部分(自定義好下列參數后再執行該腳本)=================== #
# 是否編譯工作空間 (例:若是用Cocopods管理的.xcworkspace項目,賦值true;用Xcode默認創建的.xcodeproj,賦值false)
is_workspace="false"
# .xcworkspace的名字,如果is_workspace為true,則必須填。否則可不填
workspace_name=""
# .xcodeproj的名字,如果is_workspace為false,則必須填。否則可不填
project_name="AutoPackageScriptDemo"
# 指定項目的scheme名稱(也就是工程的target名稱),必填
scheme_name="AutoPackageScriptDemo"
# 指定要打包編譯的方式 : Release,Debug。一般用Release。必填
build_configuration="Release"
# method,打包的方式。方式分別為 development, ad-hoc, app-store, enterprise 。必填
method="development"
#? 下面兩個參數只是在手動指定Pofile文件的時候用到,如果使用Xcode自動管理Profile,直接留空就好
# (跟method對應的)mobileprovision文件名,需要先雙擊安裝.mobileprovision文件.手動管理Profile時必填
mobileprovision_name=""
# 項目的bundleID,手動管理Profile時必填
bundle_identifier=""
echo "--------------------腳本配置參數檢查--------------------"
echo "\033[33;1mis_workspace=${is_workspace} "
echo "workspace_name=${workspace_name}"
echo "project_name=${project_name}"
echo "scheme_name=${scheme_name}"
echo "build_configuration=${build_configuration}"
echo "bundle_identifier=${bundle_identifier}"
echo "method=${method}"
echo "mobileprovision_name=${mobileprovision_name} \033[0m"
# =======================腳本的一些固定參數定義(無特殊情況不用修改)====================== #
# 獲取當前腳本所在目錄
script_dir="$( cd "$( dirname"$0"? )" && pwd? )"
# 工程根目錄
project_dir=$script_dir
# 時間
DATE=`date '+%Y%m%d_%H%M%S'`
# 指定輸出導出文件夾路徑
export_path="$project_dir/Package/$scheme_name-$DATE"
# 指定輸出歸檔文件路徑
export_archive_path="$export_path/$scheme_name.xcarchive"
# 指定輸出ipa文件夾路徑
export_ipa_path="$export_path"
# 指定輸出ipa名稱
ipa_name="${scheme_name}_${DATE}"
# 指定導出ipa包需要用到的plist配置文件的路徑
export_options_plist_path="$project_dir/ExportOptions.plist"
echo "--------------------腳本固定參數檢查--------------------"
echo "\033[33;1mproject_dir=${project_dir}"
echo "DATE=${DATE}"
echo "export_path=${export_path}"
echo "export_archive_path=${export_archive_path}"
echo "export_ipa_path=${export_ipa_path}"
echo "export_options_plist_path=${export_options_plist_path}"
echo "ipa_name=${ipa_name} \033[0m"
# =======================自動打包部分(無特殊情況不用修改)====================== #
echo "------------------------------------------------------"
echo "\033[32m開始構建項目? \033[0m"
# 進入項目工程目錄
cd ${project_dir}
# 指定輸出文件目錄不存在則創建
if [ -d "$export_path" ] ; then
? ? echo $export_path
else
? ? mkdir -pv $export_path
fi
# 判斷編譯的項目類型是workspace還是project
if$is_workspace ;then
# 編譯前清理工程
xcodebuild clean -workspace ${workspace_name}.xcworkspace \
?? ? ? ? ? ? ? ? -scheme ${scheme_name} \
?? ? ? ? ? ? ? ? -configuration ${build_configuration}
xcodebuild archive -workspace ${workspace_name}.xcworkspace \
?? ? ? ? ? ? ? ? ? -scheme ${scheme_name} \
?? ? ? ? ? ? ? ? ? -configuration ${build_configuration} \
?? ? ? ? ? ? ? ? ? -archivePath ${export_archive_path}
else
# 編譯前清理工程
xcodebuild clean -project ${project_name}.xcodeproj \
?? ? ? ? ? ? ? ? -scheme ${scheme_name} \
?? ? ? ? ? ? ? ? -configuration ${build_configuration}
xcodebuild archive -project ${project_name}.xcodeproj \
?? ? ? ? ? ? ? ? ? -scheme ${scheme_name} \
?? ? ? ? ? ? ? ? ? -configuration ${build_configuration} \
?? ? ? ? ? ? ? ? ? -archivePath ${export_archive_path}
fi
#? 檢查是否構建成功
#? xcarchive 實際是一個文件夾不是一個文件所以使用 -d 判斷
if [ -d "$export_archive_path" ] ; then
? ? echo"\033[32;1m項目構建成功 ?? ?? ??? \033[0m"
else
? ? echo"\033[31;1m項目構建失敗 ?? ?? ??? \033[0m"
? ? exit1
fi
echo "------------------------------------------------------"
echo "\033[32m開始導出ipa文件 \033[0m"
# 先刪除export_options_plist文件
if [ -f "$export_options_plist_path" ] ; then
? ? #echo "${export_options_plist_path}文件存在,進行刪除"
? ? rm -f $export_options_plist_path
fi
# 根據參數生成export_options_plist文件
/usr/libexec/PlistBuddy -c? "Add :method String ${method}"? $export_options_plist_path
/usr/libexec/PlistBuddy -c? "Add :provisioningProfiles:"? $export_options_plist_path
/usr/libexec/PlistBuddy -c? "Add :provisioningProfiles:${bundle_identifier} String ${mobileprovision_name}"? $export_options_plist_path
xcodebuild? -exportArchive \
? ? ? ? ? ? -archivePath ${export_archive_path} \
? ? ? ? ? ? -exportPath ${export_ipa_path} \
? ? ? ? ? ? -exportOptionsPlist ${export_options_plist_path} \
? ? ? ? ? ? -allowProvisioningUpdates
# 檢查ipa文件是否存在
if [ -f "$export_ipa_path/$scheme_name.ipa" ] ; then
? ? echo"\033[32;1mexportArchive ipa包成功,準備進行重命名\033[0m"
else
? ? echo"\033[31;1mexportArchive ipa包失敗 ?? ?? ??? ? \033[0m"
? ? exit1
fi
# 修改ipa文件名稱
mv $export_ipa_path/$scheme_name.ipa $export_ipa_path/$ipa_name.ipa
# 檢查文件是否存在
if [ -f "$export_ipa_path/$ipa_name.ipa" ] ; then
? ? echo"\033[32;1m導出 ${ipa_name}.ipa 包成功 ??? ??? ??? \033[0m"
? ? open $export_path
else
? ? echo"\033[31;1m導出 ${ipa_name}.ipa 包失敗 ?? ?? ??? ? \033[0m"
? ? exit1
fi
# 刪除export_options_plist文件(中間文件)
if [ -f "$export_options_plist_path" ] ; then
? ? #echo "${export_options_plist_path}文件存在,準備刪除"
? ? rm -f $export_options_plist_path
fi
# 輸出打包總用時
echo "\033[36;1m使用AutoPackageScript打包總用時: ${SECONDS}s \033[0m"
exit 0
1.編譯
編譯前需要清理項目工程,然后調用xcodebuild archive生成 .xcarchive
# 判斷編譯的項目類型是workspace還是project
if$is_workspace ;then
# 編譯前清理工程
xcodebuild clean -workspace ${workspace_name}.xcworkspace \
?? ? ? ? ? ? ? ? -scheme ${scheme_name} \
?? ? ? ? ? ? ? ? -configuration ${build_configuration}
xcodebuild archive -workspace ${workspace_name}.xcworkspace \
?? ? ? ? ? ? ? ? ? -scheme ${scheme_name} \
?? ? ? ? ? ? ? ? ? -configuration ${build_configuration} \
?? ? ? ? ? ? ? ? ? -archivePath ${export_archive_path}
else
# 編譯前清理工程
xcodebuild clean -project ${project_name}.xcodeproj \
?? ? ? ? ? ? ? ? -scheme ${scheme_name} \
?? ? ? ? ? ? ? ? -configuration ${build_configuration}
xcodebuild archive -project ${project_name}.xcodeproj \
?? ? ? ? ? ? ? ? ? -scheme ${scheme_name} \
?? ? ? ? ? ? ? ? ? -configuration ${build_configuration} \
?? ? ? ? ? ? ? ? ? -archivePath ${export_archive_path}
fi
2. xcodebuild -exportArchive導出.ipa:
xcodebuild? -exportArchive \
? ? ? ? ? ? -archivePath ${export_archive_path} \
? ? ? ? ? ? -exportPath ${export_ipa_path} \
? ? ? ? ? ? -exportOptionsPlist ${export_options_plist_path} \
? ? ? ? ? ? -allowProvisioningUpdates