Xcode工程文件pbxproj

忘是亡心i 2021-12-17 00:27 368阅读 0赞

## Xcode工程文件pbxproj ##

`Xcode会去读Project.pbxproj文件，把pbxproj转成plist文件，看起根目录结构`

![pbxproj根结构][pbxproj]

rootObject：指向的是我们的工程对象。（对应一个24个16进制字符，96位的UUID，具体生成规则没有确切文档说明，Xcodeproj使用的是 日期+进程ID+MAC地址组合成一个唯一ID，任何一个文件都对应一个uuid，并且一定属于某个组内，工程根目录所在组为mainGroup）

*  objects:`工程中的所有配置都在这里`
 *  archiveVersion：打包版本？？？
 *  objectVersion：Xcode兼容的版本？？？例如 Xcode 9.3以上兼容？？？官方没有具体说，参考 XcodeCompatibilityVersion枚举值。
 *  classes：空字段暂时不知道含义

## Xcode解读工程树形结构 ##

*  Xcode读取rootObject值，找到工程uuid。并在`objects对象`中寻找rootObject对象。
 *  rootObject的isa类型是PBXProject类型，表示是工程对象，我们看看工程对象的包含了哪些东西
    
     *  attributes 属性，包含一些编译器的基本信息，版本，以及项目中的target，每一个target一个UUID其中，Xcode自动创建的项目里面有三个target一个就是所要编译的APP主target，其余两个为test Target，可以看到其余两个target中有一个字段TestTargetID指向主target，可以理解为依赖相关吧
     *  buildConfigurationList 配置列表 指向一个配置字典 XCConfigurationList 类型类型
     *  compatibilityVersion （兼容版本 目前看来是 Xcode 3.2）
     *  developmentRegion 语言版本，English英语
     *  hasScannedForEncodings 是否已经扫描了文件编码信息
     *  knownRegions 不同区域的本地资源文件列表
     *  `mainGroup Xcode的文件组织形式，可以理解为文件层次 PBXGroup 类型`
     *  productRefGroup 编译后的输出文件 PBXGroup 类型
     *  projectDirPath 项目路径
     *  projectRoot 项目的根目录
     *  targets 项目下的N个target对象 PBXNativeTarget类型
 *  根据mainGroup的uuid找到对应的对象，Xcode打开工程对比配置
    
    ![Rectangle\_2x][Rectangle_2x]
 *  根据children中的uuid又可以找到对应的组对象，组对象又会包含其他的对象，形成树形结构

## objects中包含的集合对象 ##

*  PBXProject （工程包含所有信息）
 *  PBXNativeTarget section（点击工程project那一栏）
 *  XCBuildConfiguration （没错 这个就是我们经常看见的build Setting选项卡的内容 对应各个target的 buildSetting）
 *  XCConfigurationList（Xcode编译模式，指向多个XCBuildConfiguration）
 *  PBXTargetDependency
 *  PBXBuildFile 工程构建所需要的源文件，依赖库，资源文件
 *  PBXBuildPhase 就是Xcode中Build Phases选项卡
 *  PBXContainerItemProxy
 *  PBXFileElement（抽象类型，包含文件类型，组类型）
 *  PBXTarget （编译目标对象）

## Xcodeproj修改工程配置 ##

### Group的概念 ###

*  group并不一定要是真实文件夹，只是Xcode用于管理文件归类的集合。也可以是真实的文件夹，我们分别创建1个虚拟组和1个真实文件夹组，看看proj文件的变化。我们发现虚拟组的group对象是没有path值的 ，真实文件夹group对象有指定path和sourceTree 来指向文件夹“实际路径”
 *  文件也有sourceTree和path两个属性用来指定实际文件路径。
 *  给一个实体group添加文件Demo
 *  给一个虚拟group添加文件Demo

### 添加库到target ###

*  添加系统库依赖 见Demo
 *  添加三方库依赖 见Demo

### 修改Build Setting 设置 ###

编译依赖配置分为工程配置和目标对象配置。

*  修改目标依赖，见Demo
 *  修改工程依赖，见Demo

## 整个pbxproj文件结构图 ##

![project.pbxproj文件\_iOS小熊制作\_][project.pbxproj_iOS]

## XcodeProj脚本demo ##

[https://github.com/xiongwj0910/testXcodeProj/tree/master][https_github.com_xiongwj0910_testXcodeProj_tree_master]

脚本功能目录

添加文件到虚拟group脚本--addFileToInventedGroup.rb

添加文件到有实体文件夹的group脚本--addFileToGroup.rb

添加系统库给target脚本--addFrameWorkToTarget.rb

添加三方库给target脚本--addThirdFrameWorkToTarget.rb

进入到工程根目录，在执行对应功能的脚本

cd /xxx/xxx/testXcodeProj
    ruby ./Script/addThirdFrameWorkToTarget.rb

## 3.参考网站 ##

project.pbxproj结构参考 [https://yulingtianxia.com/blog/2016/09/28/Let-s-Talk-About-project-pbxproj/][https_yulingtianxia.com_blog_2016_09_28_Let-s-Talk-About-project-pbxproj]

[https://www.jianshu.com/p/e82ec6a56fc2][https_www.jianshu.com_p_e82ec6a56fc2]（Xcode工程文件project.pbxproj小结）

官网结构文档 [http://www.monobjc.net/xcode-project-file-format.html][http_www.monobjc.net_xcode-project-file-format.html]

[https://www.jianshu.com/p/bd4e3c1a7276\#][https_www.jianshu.com_p_bd4e3c1a7276]（xcode工程文件格式说明 翻译官网）

[https://blog.csdn.net/darya\_1/article/details/78095821][https_blog.csdn.net_darya_1_article_details_78095821]（xcodeproj使用心得）

Xcodeproj源码详解

[https://www.jianshu.com/p/84936d9344ff][https_www.jianshu.com_p_84936d9344ff]（cocoapods做了什么 ）

[https://www.jianshu.com/p/98029cf49a69][https_www.jianshu.com_p_98029cf49a69]（Xcodeproj: 使用 ruby 自由的修改Xcode 工程文件）

[https://blog.csdn.net/skylin19840101/article/details/64905318][https_blog.csdn.net_skylin19840101_article_details_64905318](各语言版本的解析库)

Xcodeproj使用参考网站 [https://www.jianshu.com/p/98029cf49a69][https_www.jianshu.com_p_98029cf49a69]

[https://blog.csdn.net/darya\_1/article/details/78095821][https_blog.csdn.net_darya_1_article_details_78095821]

[https://www.jianshu.com/p/03a3f7eafe26][https_www.jianshu.com_p_03a3f7eafe26]

[https://www.jianshu.com/p/cca701e1d87c][https_www.jianshu.com_p_cca701e1d87c]

[https://blog.csdn.net/auccy/article/details/68061889][https_blog.csdn.net_auccy_article_details_68061889]

转载于:https://www.cnblogs.com/xiongwj0910/p/11040820.html

[pbxproj]: /images/20211214/5d51010bf3a24aa0a2505cf7b2190880.png
[Rectangle_2x]: /images/20211214/bcad6178a27149b2a0a4cfad1eb8ddee.png
[project.pbxproj_iOS]: /images/20211214/bb4c9650f9594901afe3d1855ef7ec06.png
[https_github.com_xiongwj0910_testXcodeProj_tree_master]: https://github.com/xiongwj0910/testXcodeProj/tree/master
[https_yulingtianxia.com_blog_2016_09_28_Let-s-Talk-About-project-pbxproj]: https://yulingtianxia.com/blog/2016/09/28/Let-s-Talk-About-project-pbxproj/
[https_www.jianshu.com_p_e82ec6a56fc2]: https://www.jianshu.com/p/e82ec6a56fc2
[http_www.monobjc.net_xcode-project-file-format.html]: http://www.monobjc.net/xcode-project-file-format.html
[https_www.jianshu.com_p_bd4e3c1a7276]: https://www.jianshu.com/p/bd4e3c1a7276#
[https_blog.csdn.net_darya_1_article_details_78095821]: https://blog.csdn.net/darya_1/article/details/78095821
[https_www.jianshu.com_p_84936d9344ff]: https://www.jianshu.com/p/84936d9344ff
[https_www.jianshu.com_p_98029cf49a69]: https://www.jianshu.com/p/98029cf49a69
[https_blog.csdn.net_skylin19840101_article_details_64905318]: https://blog.csdn.net/skylin19840101/article/details/64905318
[https_www.jianshu.com_p_03a3f7eafe26]: https://www.jianshu.com/p/03a3f7eafe26
[https_www.jianshu.com_p_cca701e1d87c]: https://www.jianshu.com/p/cca701e1d87c
[https_blog.csdn.net_auccy_article_details_68061889]: https://blog.csdn.net/auccy/article/details/68061889