xcode工程文件格式（Xcode Project File Format）详解

最新推荐文章于 2020-09-23 20:26:50 发布
最新推荐文章于 2020-09-23 20:26:50 发布
阅读量5.2k 收藏 2
点赞数 1
分类专栏： iOS CI 文章标签： ios ci build plist xcode 
The Xcode project file is an old-style plist (Next style) based on braces to delimit the hierarchy. The file begins with an 
explicit encoding information, usually the UTF-8 one. This means that the file must not bear a BOM (Byte Ordering Mark) at its 
start or the parsing will fail.

xcode工程文件是一种旧式风格的plist文件（基于括号来界定配置内容层级结构）。project.pbxproj以一个显式的编码信息开头，通常为UTF-8编码，如下：

// !$*UTF8*$!

这样也意味着该文件不能以BOM字符开头，否则会解析失败。如果解析失败，可以通过vim、vi命令打开文件，查看是文件是否以BOM字符开头。


A brief look at the Xcode project format 

简单的来看下xcode 工程文件结构(粗字体是测试工程里面有的配置，下面也就有的部分进行分享)：

Elements：

Here is the list of elements contained in the file format:
Root Element
<strong>PBXBuildFile</strong>
<strong>PBXReferenceProxy</strong>
PBXBuildPhase
PBXAppleScriptBuildPhase
PBXCopyFilesBuildPhase
<strong>PBXFrameworksBuildPhase</strong>
PBXHeadersBuildPhase
<strong>PBXResourcesBuildPhase
PBXShellScriptBuildPhase
PBXSourcesBuildPhase
PBXContainerItemProxy</strong>
PBXFileElement
<strong>PBXFileReference
PBXGroup
PBXVariantGroup</strong>
PBXTarget
PBXAggregateTarget
PBXLegacyTarget
<strong>PBXNativeTarget
PBXProject
PBXTargetDependency
XCBuildConfiguration
XCConfigurationList</strong>

<strong>XCVersionGroup
</strong>

Root Element

Attribute Type Value Comment
archiveVersion Number 1 Default value.
classes List Empty  
objectVersion Number   See XcodeCompatibilityVersion enumeration.
objects Map A map of element The map is indexed by the elements identifier.
rootObject Reference An element reference The object is a reference to a PBXProject element.

小片段，格式有点像json，但是又不一样:

// !$*UTF8*$!
{
    archiveVersion = 1;
    classes = {
    };
    objectVersion = 45;
    objects = {

    ...

    };
    rootObject = 0867D690FE84028FC02AAC07 /* Project object */;
}

其中，objects是最主要的配置，包含N多信息。

PBXContainerItemProxy

This is the element for to decorate a target item.

部署target的元素

Attribute Type Value Comment
reference UUID A 96 bits identifier  
isa PBXContainerItemProxy Empty  
containerPortal Reference An element reference The object is a reference to a PBXProject element.
proxyType Number 1  
remoteGlobalIDString Reference An element reference A unique reference ID.
remoteInfo String    
PBXContainerItemProxy包含了若干个上述元素，片段： 

                035703AE18EABAF4004B160A /* PBXContainerItemProxy */ = {
                        isa = PBXContainerItemProxy;
                        containerPortal = B1E8252217CCADFD00005C6F /* app.xcodeproj */;
                        proxyType = 2;
                        remoteGlobalIDString = 0336F132151729D200EFCD4E;
                        remoteInfo = app;
                };

PBXFileReference

A PBXFileReference is used to track every external file referenced by the project: source files, resource files, libraries, generated application files, and so on.

PBXFileReference用来跟踪被工程引用的外部文件：源文件，库文件，生成的应用文件等等。

Attribute Type Value Comment
reference UUID A 96 bits identifier  
isa PBXFileReference Empty  
fileEncoding Number   See the PBXFileEncoding enumeration.
explicitFileType String   See the PBXFileType enumeration.
lastKnownFileType String   See the PBXFileType enumeration.
name String The filename.  
path String The path to the filename.  
sourceTree String See the PBXSourceTree enumeration.  
片段：
033A5B4318DEF52F002E3194 /* DemoTitleViewCell.m */ = {
isa = PBXFileReference; 
fileEncoding = 4; 
lastKnownFileType = sourcecode.c.objc; 
name = DemoTitleViewCell.m; 
path = iPhone/Controllers/Demo/Setting/DemoTitleViewCell.m; 
sourceTree = "<group>"; 
};

PBXFrameworksBuildPhase

This is the element for the framewrok link build phase.

Attribute Type Value Comment
reference UUID A 96 bits identifier  
isa PBXFrameworksBuildPhase Empty  
buildActionMask Number 2^32-1  
files List A list of element reference The objects are a reference to a PBXBuildFile element.
runOnlyForDeploymentPostprocessing Number 0  
片段： 

                6F71FAA51B61E4B2008BBED7 /* Frameworks */ = {
                        isa = PBXFrameworksBuildPhase;
                        buildActionMask = 2147483647;
                        files = (
                                6F71FABB1B61E5F2008BBED7 /* Security.framework in Frameworks */,
                                6F71FABA1B61E5E9008BBED7 /* AdSupport.framework in Frameworks */,
                                6F71FAB91B61E5DE008BBED7 /* Foundation.framework in Frameworks */,
                                6F71FAB81B61E5D8008BBED7 /* CFNetwork.framework in Frameworks */,
                                6F71FAA91B61E4B2008BBED7 /* NotificationCenter.framework in Frameworks */,
                        );
                        runOnlyForDeploymentPostprocessing = 0;
                };

PBXGroup

This is the element to group files or groups.

Attribute Type Value Comment
reference UUID A 96 bits identifier  
isa PBXGroup Empty  
children List A list of element reference The objects are a reference to a PBXFileElement element.
name String The filename.  
sourceTree String See the PBXSourceTree enumeration.  
代码片段： 

                0F2C30081A43534DG00615725 /* dataBase */ = {
                        isa = PBXGroup;
                        children = (
                                0F2C30091A37E67700615725 /* DataBaseManager.h */,
                                0F2C300A1A37E67700615725 /* DataBaseManager.m */,
                                0F2C300B1A37E67700615725 /* demoData.sqlite */,
                        );
                        name = dataBase;
                        path = iPhone/Controllers/dataBase;
                        sourceTree = "<group>";
                };

PBXHeadersBuildPhase

This is the element for the framewrok link build phase.

Attribute Type Value Comment
reference UUID A 96 bits identifier  
isa PBXHeadersBuildPhase Empty  
buildActionMask Number 2^32-1  
files List A list of element reference The objects are a reference to a PBXBuildFile element.
runOnlyForDeploymentPostprocessing Number 0  

Example:

87293EBC1153C114007AFD45 /* Headers */ = {
    isa = PBXHeadersBuildPhase;
    buildActionMask = 2147483647;
    files = (
    );
    runOnlyForDeploymentPostprocessing = 0;
};

PBXLegacyTarget

MISSING

PBXNativeTarget

This is the element for a build target that produces a binary content (application or library).

Attribute Type Value Comment
reference UUID A 96 bits identifier  
isa PBXNativeTarget Empty  
buildConfigurationList Reference An element reference The object is a reference to a XCConfigurationList element.
buildPhases List A list of element reference The objects are a reference to a PBXBuildPhase element.
dependencies List A list of element reference The objects are a reference to a PBXTargetDependency element.
name String The name of the target.  
productInstallPath String The product install path.  
productName String The product name.  
productReference Reference An element reference The object is a reference to a PBXFileReference element.
productType String   See the PBXProductType enumeration.

Example:

8D1107260486CEB800E47090 /* XXX */ = {
    isa = PBXNativeTarget;
    buildConfigurationList = C01FCF4A08A954540054247B /* Build configuration list for PBXNativeTarget "XXX" */;
    buildPhases = (
        8D1107290486CEB800E47090 /* Resources */,
        8D11072C0486CEB800E47090 /* Sources */,
        8D11072E0486CEB800E47090 /* Frameworks */,
    );
    buildRules = (
    );
    dependencies = (
    );
    name = XXX;
    productInstallPath = "$(HOME)/Applications";
    productName = TrackIt;
    productReference = 8D1107320486CEB800E47090 /* XXX.app */;
    productType = "com.apple.product-type.application";
};

PBXProject

This is the element for a build target that produces a binary content (application or library).

Attribute Type Value Comment
reference UUID A 96 bits identifier  
isa PBXProject Empty  
buildConfigurationList Reference An element reference The object is a reference to a XCConfigurationList element.
compatibilityVersion String A string representation of the XcodeCompatibilityVersion.  
developmentRegion String   The region of development.
hasScannedForEncodings Number 0 or 1 Whether file encodings have been scanned.
knownRegions List A list of string The known regions for localized files.
mainGroup Reference An element reference The object is a reference to a PBXGroup element.
productRefGroup Reference An element reference The object is a reference to a PBXGroup element.
projectDirPath String The relative path of the project.  
projectReferences Array of map Each map in the array contains two keys: ProductGroup and ProjectRef.  
projectRoot String The relative root path of the project.  
targets List A list of element reference The objects are a reference to a PBXTarget element.

Example:

29B97313FDCFA39411CA2CEA /* Project object */ = {
        isa = PBXProject;
        buildConfigurationList = C01FCF4E08A954540054247B /* Build configuration list for PBXProject "XXX" */;
        compatibilityVersion = "Xcode 2.4";
        developmentRegion = English;
        hasScannedForEncodings = 1;
        knownRegions = (
                English,
                Japanese,
                French,
                German,
                en,
        );
        mainGroup = 29B97314FDCFA39411CA2CEA /* XXX*/;
        projectDirPath = "";
        projectRoot = "";
        targets = (
             8D1107260486CEB800E47090 /* XXX*/,
        );
};

PBXResourcesBuildPhase

This is the element for the resources copy build phase.

Attribute Type Value Comment
reference UUID A 96 bits identifier  
isa PBXResourcesBuildPhase Empty  
buildActionMask Number 2^32-1  
files List A list of element reference The objects are a reference to a PBXBuildFile element.
runOnlyForDeploymentPostprocessing Number 0  

Example:

8D1107290486CEB800E47090 /* Resources */ = {
        isa = PBXResourcesBuildPhase;
        buildActionMask = 2147483647;
        files = (
                535C1E1B10AB6B6300F50231 /* ReadMe.txt in Resources */,
                533B968312721D05005E617D /* Credits.rtf in Resources */,
                533B968412721D05005E617D /* InfoPlist.strings in Resources */,
                533B968512721D05005E617D /* MainMenu.nib in Resources */,
                533B968612721D05005E617D /* TableEdit.nib in Resources */,
                533B968712721D05005E617D /* TestWindow.nib in Resources */,
        );
        runOnlyForDeploymentPostprocessing = 0;
};

PBXShellScriptBuildPhase

This is the element for the resources copy build phase.

Attribute Type Value Comment
reference UUID A 96 bits identifier  
isa PBXShellScriptBuildPhase Empty  
buildActionMask Number 2^32-1  
files List A list of element reference The objects are a reference to a PBXBuildFile element.
inputPaths List A list of string The input paths.
outputPaths List A list of string The output paths.
runOnlyForDeploymentPostprocessing Number 0  
shellPath String The path to the shell interpreter.  
shellScript String The content of the script shell.  

Example:

4D22DBAE11674009007AF714 /* ShellScript */ = {
        isa = PBXShellScriptBuildPhase;
        buildActionMask = 2147483647;
        files = (
        );
        inputPaths = (
        );
        outputPaths = (
        );
        runOnlyForDeploymentPostprocessing = 0;
        shellPath = /bin/sh;
        shellScript = "./fix_references.sh";
};

PBXSourcesBuildPhase

This is the element for the sources compilation build phase.

Attribute Type Value Comment
reference UUID A 96 bits identifier  
isa PBXSourcesBuildPhase Empty  
buildActionMask Number 2^32-1  
files List A list of element reference The objects are a reference to a PBXBuildFile element.
runOnlyForDeploymentPostprocessing Number 0  

Example:

4DF8B22D1171CFBF0081C1DD /* Sources */ = {
        isa = PBXSourcesBuildPhase;
        buildActionMask = 2147483647;
        files = (
                4DF8B23E1171D0310081C1DD /* test.mm in Sources */,
        );
        runOnlyForDeploymentPostprocessing = 0;
};

PBXTarget

This element is an abstract parent for specialized targets.

PBXTargetDependency

This is the element for referencing other target through content proxies.

Attribute Type Value Comment
reference UUID A 96 bits identifier  
isa PBXTargetDependency Empty  
target Reference An element reference The object is a reference to a PBXNativeTarget element.
targetProxy Reference An element reference The object is a reference to a PBXContainerItemProxy element.

Example:

4D22DC0D1167C992007AF714 /* PBXTargetDependency */ = {
        isa = PBXTargetDependency;
        target = 87293EBF1153C114007AFD45 /* libXXX */;
        targetProxy = 4D22DC0C1167C992007AF714 /* PBXContainerItemProxy */;
};

PBXVariantGroup

This is the element for referencing localized resources.

Attribute Type Value Comment
reference UUID A 96 bits identifier  
isa PBXVariantGroup Empty  
children List A list of element reference The objects are a reference to a PBXFileElement element.
name String The filename.  
sourceTree String See the PBXSourceTree enumeration.  

Example:

870C88031338A77600A69309 /* MainMenu.xib */ = {
        isa = PBXVariantGroup;
        children = (
                870C88041338A77600A69309 /* en */,
        );
        name = MainMenu.xib;
        sourceTree = "";
};

XCBuildConfiguration

This is the element for defining build configuration.

Attribute Type Value Comment
reference UUID A 96 bits identifier  
isa XCBuildConfiguration Empty  
baseConfigurationReference String The path to a xcconfig file  
buildSettings Map A map of build settings.  
name String The configuration name.  

Example:

870C88151338ABB600A69309 /* Debug */ = {
        isa = XCBuildConfiguration;
        buildSettings = {
                PRODUCT_NAME = "$(TARGET_NAME)";
        };
        name = Debug;
};
870C88161338ABB600A69309 /* Release */ = {
        isa = XCBuildConfiguration;
        buildSettings = {
                PRODUCT_NAME = "$(TARGET_NAME)";
        };
        name = Release;
};

XCConfigurationList

This is the element for listing build configurations.

Attribute Type Value Comment
reference UUID A 96 bits identifier  
isa XCConfigurationList Empty  
buildConfigurations List A list of element reference The objects are a reference to a XCBuildConfiguration element.
defaultConfigurationIsVisible Number 0  
defaultConfigurationName String The default configuration name.  

Example:

870C87E41338A77600A69309 /* Build configuration list for PBXProject "CocoaApp" */ = {
        isa = XCConfigurationList;
        buildConfigurations = (
                870C88061338A77600A69309 /* Debug */,
                870C88071338A77600A69309 /* Release */,
        );
        defaultConfigurationIsVisible = 0;
        defaultConfigurationName = Release;
};


magus8888
关注
专栏目录
iOS--自动打包（兼容Xcode9）
ChSaDiN的专栏
03-10 6924
iOS脚本配置Xcode Project（打包） 2018/04/19 更新 当前IPABuildShell 已经支持Xcode 9（8.0~9.3）。最新代码详见 github源码 前言 作为iOS开发者，每次真机测试我都习惯在Build Settings中设置签名信息Code Signing Identity 、Development Team、 Provisioning ...
xcode各项配置详解
fishmai的专栏
12-23 6946
iOS APP编译后，除了一些资源文件，剩下的就是一个可执行文件，有时候项目大了，引入的库多了，可执行文件很大，想知道这个可执行文件的构成是怎样，里面的内容都是些什么，哪些库占用空间较高，可以用以下方法勘察： 1.XCode开启编译选项Write Link Map File XCode -> Project -> Build Settings -> 搜map -> 把Write Link
Xcode Project File Format
Proteas的专栏
12-17 1406
Introduction The Xcode project file is an old-style plist (Next style) based on braces to delimit the hierarchy. The file begins with an explicit encoding information, usually the UTF-8 one. This m
Xcode插件开发-Xcode Project 详解
ShengQiang的博客
06-03 1160
前言在 iOS 开发过程中，我们经常会在 Xcode 里面做一些配置，比如添加系统库、第三方库，修改证书配置文件，修改编译属性等等。在这个过程里面，一般大家仅仅只是根据经验来配置这些，并没有比较清晰的认识 Xcode Project 的层次结构。最近由于接触这个比较多，做了一些如下总结。一、Xcode Project 概念ProjectXcode 中的 project 里面包含了所有的源文件、资源文
A brief look at the Xcode project format
一头雾水的Blog
09-20 646
[http://danwright.info/blog/2010/10/xcode-pbxproject-files/] A brief look at the Xcode project format 3 October 2010 by Dan Let’s take a quick little tour of the Xcode project file form
iOS 开发 .pbxproj对象内部的属性类型--Xcode Project File Format
高级软件开发工程师--周玉的博客
10-31 1109
iOS 开发 .pbxproj对象内部的属性类型–Xcode Project File Format英文版–Xcode Project File Format1.前言 Xcode项目文件是一个老式的plist(下一个风格)根据括号分隔的层次结构。文件开头一个显式的编码信息,通常是utf - 8。这意味着文件不能忍受一个BOM(字节顺序标记)在其开始或解析就会失败。 注意:下面的文档是基于观察各种*。
XCode shortcut cheat sheet
11-13
### Xcode快捷键详解 Xcode是苹果公司开发的一款强大的集成开发环境（IDE），主要用于iOS、macOS、watchOS和tvOS的应用程序开发。对于开发者而言，熟练掌握Xcode的快捷键可以极大地提高编程效率，减少鼠标操作的...
关于Xcode编译性能优化的研究工作总结
六六Coding的地方
08-12 4776
关于Xcode编译性能优化的研究工作总结本文为原创文章，转载注明出处，谢谢！本文链接：关于Xcode编译性能优化的研究工作总结近来（8月1–8月12）结合Xcode的官方文档和网上资料经验对Xcode的一些配置选项进行了编译优化的尝试研究，所谓优化主要从编译耗时及编译出的安装包大小进行优化。在研究分析过程中将手上的几个Demo项目进行了编译测试，有Swift项目也有Object-C项目。此外，对于不
为什么 Debug Information Format 改为 DWARF 可以提高编译速度？
Desgard_Duan
03-09 5829
iOS 方案之本（Essence of Workaround in iOS） 是我新写的一个专题。在很多大厂的各路优化方案中，只是告诉了我们为了达到目的怎么去做，但是并没有说这个方案的本...
google gn 构建工具系统命令详解 (guozongling)
u014786330的博客
09-23 1万+
gn analyze <out_dir> <input_path> <output_path>
Xcodeproject详解
但行好事，莫问前程；不忘初心，方得始终！
05-31 1321
前言在 iOS 开发过程中，我们经常会在 Xcode 里面做一些配置，比如添加系统库、第三方库，修改证书配置文件，修改编译属性等等。在这个过程里面，一般大家仅仅只是根据经验来配置这些，并没有比较清晰的认识 Xcode Project 的层次结构。最近由于接触这个比较多，做了一些如下总结。 一、Xcode Project 概念ProjectXcode 中的 project 里面包含了所有的源文件、资源
CreateProjectFormat——初始项目目录格式
weixin_30838921的博客
09-14 187
百度云链接：https://pan.baidu.com/s/1f_2YaMf9619Rt5AlC6nryQ 密码：v2cb 修改中。。。 转载于:https://www.cnblogs.com/yangchengdejishuzhai/p/9644570.html
android studio Project format eclipse Project
u012047933的专栏
12-09 527
as 工程 转 eclipse 工程 1.copy .classpath文件、.project文件、project.properties 到as 源文件路径下即：XX / src / main 2.修改 .classpath文件    修改为  注意是相对路径 修改.project文件  主要是修改名称，导入到eclipse时显示的工程名称  xxx  3.需要导包时  这个就需
xcode相关的一些知识(一)
u011194397的专栏
05-08 1532
xcode相关的一些知识(一)   (2012-01-06 13:44:59) 转载▼ 标签：  转载   原文地址：xcode相关的一些知识(一)作者：jetKill 1.修改xcode下键盘的一些快捷键 Choose Xcode > Preferences. Select Key Bindi
Helloworld程序的创建以及配置文件的讲解
weixin_34221112的博客
11-15 223
  创建项目。 create Project 选择创建的Project类别以及使用的SDK，可能SDK需要配置或者修改配置。   这个页面是问你是否使用模板创建。 Command Line App 会自动创建一个带有main方法的类 Java Hello World会自动创建一个带有main方法且打印HelloWorld的类   上面项目名和路径，More Settings默认是折叠的 pro...
Xcode工程文件的格式说明[翻译]
weixin_34004750的博客
05-30 191
2019独角兽企业重金招聘Python工程师标准>>> ...
Xcode工程文件 project.pbxproj小结。转载
hsf_study的博客
09-06 3296
源地址： http://www.jianshu.com/p/e82ec6a56fc2 Xcode工程文件project.pbxproj小结 简介 project.pbxproj 文件被包含于 Xcode 工程文件 *.xcodeproj 之中，存储着 Xcode 工程的各项配置参数。它本质上是一种旧风格的 Property List 文件，历史可追溯到 NeXT 的 OpenStep。由于有
删除Main.storyboard和LaunchScreen.storyboard后无法国际化
01-16 269
删除Main.storyboard和LaunchScreen.storyboard后，在info里面的Localizations中添加国际化语言是发现无法添加。 解决方式为，打开项目xcodeproj显示包内容，打开project.pbxproj后修改文件 knownRegions = ( en, "zh-Hans",...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值