https://developer.apple.com/library/mac/documentation/Darwin/Reference/ManPages/man1/xcodebuild.1.html

 

This manual page is part of Xcode Tools version 5.0

To obtain these tools:

If you are running a version of Xcode Tools other than 5.0, view the documentation locally:

  • In Xcode

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • To learn how the manual is organized or to learn about command syntax, read the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Developer Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.




XCODEBUILD(1)             BSD General Commands Manual            XCODEBUILD(1)

NAME
xcodebuild -- build Xcode projects and workspaces SYNOPSIS
xcodebuild [-project projectname] [-target targetname ...] [-configuration configurationname]
[-sdk [sdkfullpath | sdkname]] [buildaction ...] [setting=value ...]
[-userdefault=value ...]
xcodebuild [-project projectname] -scheme schemename [-destination destinationspecifier]
[-destination-timeout value] [-configuration configurationname]
[-sdk [sdkfullpath | sdkname]] [buildaction ...] [setting=value ...]
[-userdefault=value ...]
xcodebuild -workspace workspacename -scheme schemename [-destination destinationspecifier]
[-destination-timeout value] [-configuration configurationname]
[-sdk [sdkfullpath | sdkname]] [buildaction ...] [setting=value ...]
[-userdefault=value ...]
xcodebuild -version [-sdk [sdkfullpath | sdkname]] [infoitem]
xcodebuild -showsdks
xcodebuild -list [-project projectname | -workspace workspacename]
xcodebuild -exportArchive -exportFormat format -archivePath xcarchivepath -exportPath destinationpath
[-exportProvisioningProfile profilename] [-exportSigningIdentity identityname]
[-exportInstallerIdentity identityname] DESCRIPTION
xcodebuild builds one or more targets contained in an Xcode project, or builds a scheme contained in an
Xcode workspace or Xcode project. Usage
To build an Xcode project, run xcodebuild from the directory containing your project (i.e. the
directory containing the projectname.xcodeproj package). If you have multiple projects in the this
directory you will need to use -project to indicate which project should be built. By default,
xcodebuild builds the first target listed in the project, with the default build configuration. The
order of the targets is a property of the project and is the same for all users of the project. To build an Xcode workspace, you must pass both the -workspace and -scheme options to define the build.
The parameters of the scheme will control which targets are built and how they are built, although you
may pass other options to xcodebuild to override some parameters of the scheme. There are also several parameters to display info about the installed version of Xcode or about
projects or workspaces in the local directory, but which do not initiate a build. These include
-version, -showsdks, and -usage. Options
-project projectname
Build the project specified by projectname. Required if there are multiple project files in the
same directory. -target targetname
Build the target specified by targetname. -alltargets
Build all the targets in the specified project. -workspace workspacename
Build the workspace specified by workspacename. -scheme schemename
Build the scheme specified by schemename. Required if building a workspace. -destination destinationspecifier
Use the destination device described by destinationspecifier. Defaults to a destination that is
compatible with the selected scheme. See the section on destinations for more details. -destination-timeout timeout
Use the specified timeout when searching for a destination device. The default is 30 seconds. -configuration configurationname
Use the build configuration specified by configurationname when building each target. -arch architecture
Use the architecture specified by architecture when building each target. -sdk [<sdkfullpath> | <sdkname>]
Build an Xcode project or workspace against the specified SDK, using build tools appropriate for
that SDK. The argument may be an absolute path to an SDK, or the canonical name of an SDK. -showsdks
Lists all available SDKs that Xcode knows about, including their canonical names suitable for use
with -sdk. Does not initiate a build. -list
Lists the targets and configurations in a project, or the schemes in a workspace. Does not initi-ate initiate
ate a build. -derivedDataPath path
Overrides the folder that should be used for derived data when performing a build action on a
scheme in a workspace. -resultBundlePath path
Writes a bundle to the specified path with results from performing a build action on a scheme in
a workspace. -exportArchive
Specifies that an archive should be exported. Requires -exportFormat, -archivePath, and
-exportPath. Cannot be passed along with a build action. -exportFormat format
Specifies the format to which the archive should be exported. Valid formats are IPA (iOS archives
only), PKG (Mac archives only), and APP. If not specified, xcodebuild will attempt to auto-detect autodetect
detect the format as either IPA or PKG. -archivePath xcarchivepath
Specifies the path for the archive produced by the archive action, or specifies the archive that
should be exported when -exportArchive is passed. -exportPath destinationpath
Specifies the destination for the exported product, including the name of the exported file. -exportProvisioningProfile profilename
Specifies the provisioning profile that should be used when exporting the archive. -exportSigningIdentity identityname
Specifies the application signing identity that should be used when exporting the archive. If
possible, this may be inferred from -exportProvisioningProfile. -exportInstallerIdentity identityname
Specifies the installer signing identity that should be used when exporting the archive. If pos-sible, possible,
sible, this may be inferred from -exportSigningIdentity or -exportProvisioningProfile. -exportWithOriginalSigningIdentity
Specifies that the signing identity used to create the archive should be used when exporting the
archive. buildaction ...
Specify a build action (or actions) to perform on the target. Available build actions are: build Build the target in the build root (SYMROOT). This is the default build action. analyze Build and analyze a target or scheme from the build root (SYMROOT). This requires
specifying a scheme. archive Archive a scheme from the build root (SYMROOT). This requires specifying a scheme. test Test a scheme from the build root (SYMROOT). This requires specifying a scheme and
optionally a destination. installsrc Copy the source of the project to the source root (SRCROOT). install Build the target and install it into the target's installation directory in the dis-tribution distribution
tribution root (DSTROOT). clean Remove build products and intermediate files from the build root (SYMROOT). -xcconfig filename
Load the build settings defined in filename when building all targets. These settings will over-ride override
ride all other settings, including settings passed individually on the command line. -dry-run, -n
Print the commands that would be executed, but do not execute them. -skipUnavailableActions
Skip build actions that cannot be performed instead of failing. This option is only honored if
-scheme is passed. setting=value
Set the build setting setting to value. -userdefault=value
Set the user default default to value. -version
Display version information for this install of Xcode. Does not initiate a build. When used in
conjunction with -sdk, the version of the specified SDK is displayed, or all SDKs if -sdk is
given no argument. Additionally, a single line of the reported version information may be
returned if infoitem is specified. -usage
Displays usage information for xcodebuild. Destinations
The -destination option takes as its argument a destination specifier describing the device (or
devices) to use as a destination. A destination specifier is a single argument consisting of a set of
comma-separated key=value pairs. The -destination option may be specified multiple times to cause
xcodebuild to perform the specified action on multiple destinations. Destination specifiers may include the platform key to specify one of the supported destination plat-forms. platforms.
forms. There are additional keys which should be supplied depending on the platform of the device you
are selecting. Some devices may take time to look up. The -destination-timeout option can be used to specify the
amount of time to wait before a device is considered unavailable. If unspecified, the default timeout
is 30 seconds. Currently, xcodebuild supports these platforms: OS X The local Mac, referred to in the Xcode interface as My Mac, and which supports the fol-lowing following
lowing keys: arch The architecture to use, either x86_64 (the default) or i386. iOS An iOS device, which supports the following keys: name The name of the device to use. id The identifier of the device to use, as shown in the Devices tab of the Xcode
Organizer. iOS Simulator The iOS Simulator, which supports the following keys: name The full name of device to simulate, as presented in Xcode's UI. OS The version of iOS to simulate, such as 6._, or the string latest (the default) to
indicate the most recent version of iOS supported by this version of Xcode. Some actions (such as building) may be performed without an actual device present. To build against a
platform generically instead of a specific device, the destination specifier may be prefixed with the
optional string "generic/", indicating that the platform should be targeted generically. An example of
a generic destination is the "iOS Device" destination displayed in Xcode's UI when no physical iOS
device is present. Exporting Archives
The -exportArchive option specifies that xcodebuild should export the archive specified by -archivePath
to the format specified by -exportFormat. The exported product will be placed at the path specified by
-exportPath. Re-signing when exporting an archive is optional. The provisioning profile that should be
embedded in the exported product can be specified by -exportProvisioningProfile. In some cases, the
application signing identity that should be used during the export can be determined from the provision-ing provisioning
ing profile. For cases where that is not possible (including when no provisioning profile is embedded in
the exported product), an application signing identity can be specified with -exportSigningIdentity.
When exporting a Mac archive as PKG, an installer signing identity can be used to sign the exported pack-age. package.
age. This may be inferred from the application signing identity (for instance, if "Developer ID Applica-tion" Application"
tion" is specified for the application signing identity, "Developer ID Installer" will automatically be
inferred), but it can be explicitly specified using -exportInstallerIdentity. Environment Variables
The following environment variables affect the execution of xcodebuild: XCODE_XCCONFIG_FILE
Set to a path to a file, build settings in that file will be loaded and used when build-ing building
ing all targets. These settings will override all other settings, including settings
passed individually on the command line, and those in the file passed with the -xcconfig
option. Exit Codes
xcodebuild exits with codes defined by sysexits(3). It will exit with EX_OK on success. On failure, it
will commonly exit with EX_USAGE if any options appear malformed, EX_NOINPUT if any input files cannot be
found, EX_IOERR if any files cannot be read or written, and EX_SOFTWARE if the commands given to xcode-build xcodebuild
build fail. It may exit with other codes in less common scenarios. EXAMPLES
xcodebuild clean install Cleans the build directory; then builds and installs the first target in the Xcode project in
the directory from which xcodebuild was started. xcodebuild -target MyTarget OBJROOT=/Build/MyProj/Obj.root SYMROOT=/Build/MyProj/Sym.root Builds the target MyTarget in the Xcode project in the directory from which xcodebuild was
started, putting intermediate files in the directory /Build/MyProj/Obj.root and the products
of the build in the directory /Build/MyProj/Sym.root. xcodebuild -sdk macosx10.6 Builds the Xcode project in the directory from which xcodebuild was started against the Mac OS
X 10.6 SDK. The canonical names of all available SDKs can be viewed using the -showsdks
option. xcodebuild -workspace MyWorkspace.xcworkspace -scheme MyScheme Builds the scheme MyScheme in the Xcode workspace MyWorkspace.xcworkspace. xcodebuild -workspace MyWorkspace.xcworkspace -scheme MyScheme archive Archives the scheme MyScheme in the Xcode workspace MyWorkspace.xcworkspace. xcodebuild -workspace MyWorkspace.xcworkspace -scheme MyScheme -destination 'platform=OS X,arch=x86_64'
test Tests the scheme MyScheme in the Xcode workspace MyWorkspace.xcworkspace using the destination
described as My Mac 64-bit in Xcode. xcodebuild -workspace MyWorkspace.xcworkspace -scheme MyScheme -destination 'platform=iOS
Simulator,name=iPhone' -destination 'platform=iOS,name=My iPad' test Tests the scheme MyScheme in the Xcode workspace MyWorkspace.xcworkspace using both the iOS
Simulator configured as an iPhone and the the iOS device named My iPad. (Note that the shell
requires arguments to be quoted or otherwise escaped if they contain spaces.) xcodebuild -workspace MyWorkspace.xcworkspace -scheme MyScheme -destination generic/platform=iOS build Builds the scheme MyScheme in the Xcode workspace MyWorkspace.xcworkspace using the generic
iOS Device destination. xcodebuild -exportArchive -exportFormat IPA -archivePath MyMobileApp.xcarchive -exportPath
MyMobileApp.ipa -exportProvisioningProfile 'MyMobileApp Distribution Profile' Exports the archive MyMobileApp.xcarchive as an IPA file to the path MyMobileApp.ipa using the
provisioning profile MyMobileApp Distribution Profile. xcodebuild -exportArchive -exportFormat APP -archivePath MyMacApp.xcarchive -exportPath MyMacApp.pkg
-exportSigningIdentity 'Developer ID Application: My Team' Exports the archive MyMacApp.xcarchive as a PKG file to the path MyMacApp.pkg using the appli-cation application
cation signing identity Developer ID Application: My Team. The installer signing identity
Developer ID Installer: My Team is implicitly used to sign the exported package.

This manual page is part of Xcode Tools version 5.0的更多相关文章

  1. 关于The specified Android SDK Build Tools version (26.0.2) is ignored, as it is below the minimum...

    今天将项目迁移到另一台笔记本,进行build出现以下问题,导致build失败 The specified Android SDK Build Tools version (26.0.2) is ign ...

  2. Wndows 下npm 安装依赖时出现错误:MSBUILD : error MSB4132: The tools version "2.0" is unrecognized. Available tools versions are "4.0".

    当在Windows环境中使用npm install或者yarn 安装依赖时,可能会出现如下类似的错误: MSBUILD : error MSB4132: The tools version " ...

  3. 安卓 android studio 报错 The specified Android SDK Build Tools version (27.0.3) is ignored, as it is below the minimum supported version (28.0.3) for Android Gradle

    今天将项目迁移到另一台笔记本,进行build出现以下问题,导致build失败 报错截图: 大致意思,目前使用的build工具版本27.0.3不合适.因为当前使用Gradle插件版本是3.2.1,这个版 ...

  4. git-push(1) Manual Page

    git-push(1) Manual Page NAME git-push - Update remote refs along with associated objects SYNOPSIS gi ...

  5. 【socket编程】select manual page翻译

    原文: select manual page 依赖的头文件 /* According to POSIX.1-2001, POSIX.1-2008 */ #include <sys/select. ...

  6. 时区提示:Local time zone must be set--see zic manual page 2018的解决办法

    问题描述:在centos服务器上执行date命令时,显示的时间信息中的时区不正常,如下: [root@ulocalhost ~]# date Mon Apr 9 02:57:38 Local time ...

  7. #include <sys/epoll.h> epoll - I/O event notification facility 服务器端 epoll(7) - Linux manual page http://www.man7.org/linux/man-pages/man7/epoll.7.html

    epoll使用详解(精髓) - Boblim - 博客园 https://www.cnblogs.com/fnlingnzb-learner/p/5835573.html epoll使用详解(精髓) ...

  8. 解决无法修改日志时间的问题(Local time zone must be set--see zic manual page 2019 )

    故障现象 系统日志时间晚了整整8个小时,比如现在是中午12点,日志时间为凌晨4点 date命令报错(Local time zone must be set--see zic manual page) ...

  9. check the manual that corresponds to your MySQL server version for the right syntax to use near 'desc

    往一个新建的MySQL表中插入数据报错 2018-08-22 14:09:18.875 ERROR 9256 --- [apr-8080-exec-9] o.s.b.w.servlet.support ...

随机推荐

  1. Genymotion 模拟器 VirtualBox

    准备 介绍: 1.Genymotion安卓模拟器其实不是普通的模拟器,严格来说,genymotion是虚拟机,被网传定义为模拟器,加载APP的速度比较快,操作起来也很流畅.2.Genymotion依赖 ...

  2. 用timer控件实现sleep效果

    有时候我们需要代码延迟执行,这就需要用到Thread.Sleep()这个方法,但这个方法在主线程使用时会造成界面假死.使用timer控件既能达到代码延迟执行的效果,又不会有假死的困扰. 假设我们需要在 ...

  3. (转)HTML特殊字符

    HTML 原始码 显示结果 描述 < < 小於号或显示标记 > > 大於号或显示标记 & & 可用於显示其它特殊字符 " " 引号 ® ® ...

  4. C# 连接SQL数据库

    感觉很有必要总结一下 一:C# 连接SQL数据库 Data Source=myServerAddress;Initial Catalog=myDataBase;User Id=myUsername;P ...

  5. 告诉你GetDC()没有释放造成的后果

    最近做的项目中需要显示视频监控窗口,从采集卡中读到图像的数据,需要实时显示出来,而且速度比较快. 由于比较简单,就直接使用了GDI画图,以前复杂的都用openGL啥的工具了,这次这个简单,就直接用GD ...

  6. 关于常用却忘记的css,jQuery

    text-indent:35px;//首行缩进 line-height:12px;//行高,高度和外层高度一样就会居中 box-shadow:inset 0px 0px 2px #ccc; conte ...

  7. 关于Sublime text 2中Emmet的安装 _html:xt无效

    其实这个网上很多教程,有一些方法是可行的,但是有一些方法是行不通的. 虽然Sublime text 2有不同平台的版本,但是安装起来,还是有点差异的. 先简单介绍一下Emmet,Emmet是Zen-c ...

  8. Installing Mp4box in centos 6

    Installing Mp4box in centos 6   Installing Mp4box in centos 6Login to the server cd /usr/local/src/ ...

  9. Matlab与外部接口:MAT文件基础

    MAT 文件MAT文件是MATLAB使用的一种特有的二进制数据文件.MAT文件可以包含一个或者多个MATLAB 变量.MATLAB通常采用MAT文件把工作空间的变量存储在磁盘里,在MAT文件中不仅保存 ...

  10. 剑指offer之O(1)算法删除指针所指向的节点

    题目如图: 1.把要删除pToBeDeleted的节点的后面节点覆盖点要删除的节点pToBeDeleted 2.要考虑如果删除的节点是最后一个节点怎么办 3.要考虑如果总共只有一个节点,删除的是头结点 ...