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