Build and Product Location Build Settings
BUILT_PRODUCTS_DIR
Description: | Directory path. Identifies the directory under which all the product’s files can be found. This directory contains either product files or symbolic links to them. Run Script build phases can use the value of this build setting as a convenient way to refer to the product files built by one or more targets even when these files are scattered throughout a directory hierarchy (for example, when 构建产品目录 |
Effectors: | RETAIN_RAW_BINARIES, CONFIGURATION_BUILD_DIR (Per-Configuration Build Products Path), DEPLOYMENT_LOCATION (Deployment Location). |
Value: |
|
CACHE_ROOT
Description: | File path. Identifies the file used to cache build-time information that must persist between launches of the Xcode application. 缓存根目录 |
Value: | |
Example value: | |
Affects: | |
Alias: | |
CONFIGURATION_BUILD_DIR (Per-Configuration Build Products Path)
Description: | Directory path. Identifies the directory under which all build-related files for the active build configuration are placed. 配置构建产品目录 |
Effectors: | |
Default value: | |
Example value: | |
Affects: |
CONFIGURATION_TEMP_DIR (Per-Configuration Intermediate File Path)
Description: | Directory path. Identifies the directory that holds temporary files for the active build configuration. 配置构建时生成的中间文件目录 |
Effectors: | |
Default value: | |
Example value: | |
Affects: |
DEPLOYMENT_LOCATION (Deployment Location)
Description: | Boolean value. Specifies whether product files are placed in the installation (specified by 产品部署的位置,这是一个bool值 |
Effector: | |
Values: |
|
Default value: |
|
Affects: | |
Companions: | DSTROOT (Installation Build Products Location), SYMROOT (Build Products Path),. |
Related to: |
DERIVED_FILE_DIR
Description: | Directory path. Identifies the directory into which derived source files—such as those generated by lex and yacc—are placed. 衍生文件目录 |
Effectors: | |
Value: | |
Aliases: | |
DSTROOT (Installation Build Products Location)
Description: | Directory path. Identifies the directory into which the product is placed. In this directory, the product is laid out exactly as it would be installed in a user’s filesystem. 构造产品安装路径的根目录 |
Effectors: | |
Default value: | |
Example value: | |
Affects: |
INSTALL_DIR
Description: | Directory path. Identifies the directory in the developer’s filesystem into which the installed product is placed. 安装目录,附属DSTROOT的目录; |
Effectors: | DSTROOT (Installation Build Products Location), INSTALL_PATH (Installation Directory). |
Value: | |
Example value: | |
INSTALL_PATH (Installation Directory)
Description: | Directory path. Identifies the directory in the user’s filesystem into which the installed product is placed. 安装路径 |
Effectors: | Product type (chosen when the project was created), DSTROOT (Installation Build Products Location), SYSTEM_LIBRARY_DIR, USER_LIBRARY_DIR, HOME. |
Default value: | |
Affects: |
OBJECT_FILE_DIR
Description: | Directory path. Partially identifies the directory into which variant object files are placed. The complete specification is computed using the variants of this build setting. 目标文件路径 |
Effectors: | |
Value: | |
Example value: | |
Affects: |
OBJECT_FILE_DIR_<VARIANT>
Description: | Directory path. Fully identifies the directory into which variant object files are placed. For each build variant in |
Effectors: | |
Value: | |
Example build settings and their values when |
|
Related to: |
OBJROOT (Intermediate Build Files Path)
Description: | Directory path. Identifies the directory in which the target’s intermediate build files are placed. Intermediate build directories are named after the product name with the extension 编译时中间文件的文件根目录 |
Effectors: | SRCROOT, Xcode Preferences > Building > “Place Build Products in.” |
Default value: |
|
Example value: | |
Affects: |
PROJECT_TEMP_DIR
Description: | Directory path. Identifies the directory in which the project’s intermediate build files are placed. This directory is shared between all the targets defined by the project. Run Script build phases should generate intermediate build files in the directory identified by 编译时产生的中间文件目录路径 |
Effectors: | |
Value: | |
Example value: | |
Affects: | CONFIGURATION_TEMP_DIR (Per-Configuration Intermediate File Path). |
REZ_COLLECTOR_DIR
Description: | Directory path. Specifies the directory in which the collected Resource Manager resources generated by 资源目录 |
Effectors: | |
Value: | |
Example value: | |
Affects: |
REZ_OBJECTS_DIR
Description: | Directory path. Specifies the directory in which compiled Resource Manager resources generated by 资源对象目录 |
Effectors: | |
Value: | |
Example value: | |
SDKROOT (Base SDK)
Description: | Directory path. Specifies the directory of the base SDK to use to build the product. 系统SDK根目录 |
Values: |
|
Related to: | FRAMEWORK_SEARCH_PATHS (Framework Search Paths), HEADER_SEARCH_PATHS (Header Search Paths), IPHONEOS_DEPLOYMENT_TARGET (iOS Deployment Target), MACOSX_DEPLOYMENT_TARGET (OS X Deployment Target). |
SHARED_PRECOMPS_DIR (Precompiled Headers Cache Path)
Description: | Directory path. Specifies the directory in which to place precompiled headers. Targets can share precompiled headers by specifying the same value for this build setting. 预编译头文件缓存目录 |
Effectors: | |
Default value: | |
Example value: | |
SKIP_INSTALL
Description: | Boolean value. Specifies whether to place the product at the location indicated by |
Values: |
|
Default value: | |
Affects: | |
Companions: | DEPLOYMENT_LOCATION (Deployment Location), DSTROOT (Installation Build Products Location), TARGET_TEMP_DIR. |
SRCROOT
Description: | Directory path. Identifies the directory containing the target’s source files. 源代码根目录 |
Value: | Path to the project file that defines the target. |
Example value: | |
Affects: | OBJROOT (Intermediate Build Files Path), SYMROOT (Build Products Path). |
Alias: | |
SYMROOT (Build Products Path)
Description: | Directory path. Identifies the root of the directory hierarchy that contains product files and intermediate build files. Product and build files are placed in subdirectories of this directory. 应用程序工程根目录 |
Effectors: | SRCROOT, Xcode Preferences > Build. |
Default value: |
|
Example values: |
|
Affects: | BUILT_PRODUCTS_DIR, CONFIGURATION_BUILD_DIR (Per-Configuration Build Products Path). |
TARGET_BUILD_DIR
Description: | Directory path. Identifies the root of the directory hierarchy that contains the product’s files (no intermediate build files). Run Script build phases that operate on product files of the target that defines them should use the value of this build setting. But Run Script build phases that operate on product files of other targets should use BUILT_PRODUCTS_DIR instead. 产品编译完成后存放的目录 |
Effectors: | CONFIGURATION_BUILD_DIR (Per-Configuration Build Products Path), DEPLOYMENT_LOCATION (Deployment Location), DSTROOT (Installation Build Products Location), INSTALL_PATH (Installation Directory), TARGET_TEMP_DIR, SKIP_INSTALL. |
Value: |
|
Example values: |
|
Related to: | DEPLOYMENT_LOCATION (Deployment Location), INSTALL_PATH (Installation Directory), SKIP_INSTALL. |
TARGET_TEMP_DIR
Description: | Directory path. Identifies the directory containing the target’s intermediate build files. Run Script build phases should place intermediate files at the location indicated by 产品编译产生的附属文件目录 |
Effectors: | TARGET_NAME, CONFIGURATION_TEMP_DIR (Per-Configuration Intermediate File Path). |
Value: | |
Example value: | |
Affects: | DERIVED_FILE_DIR, OBJECT_FILE_DIR, REZ_COLLECTOR_DIR, TARGET_BUILD_DIR. |
Product Layout Build Settings
These build settings specify the layout of bundle-based products.
CONTENTS_FOLDER_PATH
Description: | Bundle directory path. Specifies the directory inside the generated bundle that contains the product’s files. |
Effector: | |
Default value: | |
Example value: | |
Affects: | EXECUTABLE_PATH, FRAMEWORKS_FOLDER_PATH, INFOPLIST_PATH, PLUGINS_FOLDER_PATH, PRIVATE_HEADERS_FOLDER_PATH, PUBLIC_HEADERS_FOLDER_PATH, SCRIPTS_FOLDER_PATH, SHARED_FRAMEWORKS_FOLDER_PATH, UNLOCALIZED_RESOURCES_FOLDER_PATH. |
INFOPLIST_FILE
Description: | Filename. Specifies the name of the information property list file that specifies the bundled product’s runtime properties. For details on information property list files, see Information Property List FilesinRuntime Configuration Guidelines. You should not change the value of this build setting from its default. Doing so produces a bundled product that may not work as expected in OS X. |
Default value: | |
Affects: | |
Related to: |
INFOPLIST_OUTPUT_FORMAT
Description: | Identifier. Specifies the whether the information property list file is written using the binary format. |
Values: |
|
Related to: |
INFOPLIST_PATH
Description: | Bundle file path. Specifies the path to the bundle’s information property list file. |
Effectors: | |
Default value: | |
Example value: | |
INFOSTRINGS_PATH
Description: | Bundle file path. Specifies the file that contains the bundle’s localized strings file. |
Default value: | |
FRAMEWORKS_FOLDER_PATH
Description: | Bundle directory path. Specifies the directory that contains the product’s embedded frameworks. |
Effector: | |
Default value: | |
Example value: | |
GENERATE_PKGINFO_FILE
Description: | Boolean value. Specifies whether to generate the file specified by |
Values: |
|
Default value: |
|
Companion: |
DOCUMENTATION_FOLDER_PATH
Description: | Bundle directory path. Identifies the directory that contains the bundle’s documentation files. |
Default value: | |
EXECUTABLES_FOLDER_PATH
Description: | Bundle directory path. Identifies the directory that contains additional binary files. |
Effector: | |
Default value: | |
Example value: | |
EXECUTABLE_EXTENSION
Description: | Identifier. Specifies the extension of the binary the target produces. |
Effectors: | |
Default values: |
|
Affects: |
EXECUTABLE_FOLDER_PATH
Description: | Bundle directory path. Identifies the directory that contains the binary the target builds. |
Effector: | |
Default value: | |
Example value: | |
EXECUTABLE_NAME
Description: | Filename. Specifies the name of the binary the target produces. |
Effectors: | |
Default value: | |
Example values: |
|
Affects: |
EXECUTABLE_PATH
Description: | Bundle directory path. Specifies the path to the binary the target produces within its bundle. |
Effectors: | |
Default value: | |
Example values: |
|
EXECUTABLE_PREFIX
Description: | File prefix. Specifies the prefix of the binary filename. |
Default value: | None. |
Affects: |
EXECUTABLE_SUFFIX
Description: | File suffix. Specifies the suffix of the binary filename (including the character that separates the extension from the rest of the bundle name). |
Effector: | |
Default value: | |
Example value: | |
Affects: |
PACKAGE_TYPE
Description: | Uniform type identifier. Identifies the type of the product the target builds. Some products may be made up of a single binary or archive. Others may comprise several files, which are grouped under a single directory. These container directories are known as bundles. |
Value: | |
PLUGINS_FOLDER_PATH
Description: | Bundle directory path. Specifies the directory that contains the product’s plug-ins. |
Effector: | |
Default value: | |
Example value: | |
PRIVATE_HEADERS_FOLDER_PATH
Description: | Bundle directory path. Specifies the directory that contains the product’s private header files. |
Effector: | |
Default value: | |
Example value: | |
PKGINFO_FILE_PATH
Description: | Bundle file path. Specifies the file that contains the bundle’s package information file. |
Effector: | |
Value: | |
Example value: | |
PUBLIC_HEADERS_FOLDER_PATH
Description: | Bundle directory path. Specifies the directory that contains the product’s public header files. |
Effector: | |
Default value: | |
Example value: | |
SCRIPTS_FOLDER_PATH
Description: | Bundle directory path. Specifies the directory that contains the product’s scripts. |
Effector: | |
Default value: | |
Example value: | |
SHARED_FRAMEWORKS_FOLDER_PATH
Description: | Bundle directory path. Specifies the directory that contains the product’s shared frameworks. |
Effector: | |
Default value: | |
Example value: | |
UNLOCALIZED_RESOURCES_FOLDER_PATH
Description: | Bundle directory path. Specifies the directory that contains the product’s unlocalized resources. |
Effector: | |
Default value: | |
Example value: | |
WRAPPER_EXTENSION (Wrapper Extension)
Description: | Identifier. Specifies the extension of the product bundle name (not including the character that separates the extension from the rest of the bundle name). |
Effector: | Product type choose when the target was created |
Default value: | none: In command-line utility, dynamic library, and static library products. |
Example value: | |
Affects: |
WRAPPER_NAME
Description: | Filename. Specifies the filename (including the appropriate extension) of the product bundle. |
Effectors: | |
Value: | |
Example value: | |
Related to: |
WRAPPER_SUFFIX
Description: | File suffix. Specifies the suffix of the product bundle name (including the character that separates the extension from the rest of the bundle name). |
Effector: | |
Default value: | |
Example value: | |
Affects: |