Cmake生成的Xcode工程相对路径与绝对路径的问题

news2024/12/26 22:59:46

Cmake生成的Xcode工程相对路径与绝对路径的问题

文章目录

Cmake生成的Xcode工程相对路径与绝对路径的问题
- 前言
- 修改`.pbxproj`文件
- 验证工程
- 小结

前言

由于Cmake的跨平台的自动化构建的方便性以及他广泛应用于编译过程的管理，在开发过程中难免用到Cmake。我也使用Cmake针对相关静态库进行编译，得到在iOS下使用的静态库，但由于Cmake生成的相关工程是绝对路径的，因此在合作开发过程中，别人不能够很方便的进行共同开发。我针对Cmake生成相对路径的工程又不熟悉，因此只能针对生成的Xcode工程进行从绝对路径到相对路径的改造，因此本文的操作方式可能不那么符合正常的工作流程
并且在相关的类似文章中，也有人提到Cmake生成的VScode工程是绝对路径，并且是有意为之的，相关文章：CMake生成的vs的工程文件为何采用的是绝对路径

使用的Cmake命令生成Xcode工程：Cmake . -G "Xcode"

修改`.pbxproj`文件

project.pbxproj文件是一个基于XML格式的文本文件，它存储了Xcode工程中几乎所有的配置信息，包括目标（Targets）、源文件（Source Files）、资源文件（Resources）、构建设置（Build Settings）等。在Xcode中，每当你对项目进行更改（如添加、删除或修改文件，更改构建设置等），这些更改都会反映到project.pbxproj文件中。参考的相关文章：Xcode工程解析：深入了解project.pbxproj文件

.pbxproj文件也是Xcode中的Build Settings, General等设置的总和，一般来说在Xcode中通过GUI来修改项目配置，.pbxproj也会同步更新，但某些情况却不会，因此可能需要打开.pbxproj来修改。（本人操作可能不规范）
修改.pbxproj文件时，需要注意备份，以免关键数据丢失。
Note：应当尝试首先修改build settings中的内容，如果能够起作用，请不要修改.pbxproj文件。

修改的原则：根据自己通过Xcode建立的工程的.pbxproj文件进行对比，修改为相对路径

其中需要用到的配置项有 $(PROJECT_DIR) 和 $(SRCROOT)，它们分别表示项目根目录和项目目录。二者的区别： $(SRCROOT) 和$ (PROJECT_DIR)和 $(inh er i t e d) 和$ {PODS_ROOT}
如果不确定二者的路径到底是什么，可以通过以下命令来查看

xcodebuild -project projectName.xcodeproj -showBuildSettings | grep "SRCROOT"
xcodebuild -project projectName.xcodeproj -showBuildSettings | grep "PROJECT_DIR"

打开.pbxproj文件，可以搜索user等绝对路径中经常有的字段，这些就是要修改的绝对路径了。

在这里插入图片描述
2. 将projectDirPatrh的路径替换为如下内容

projectDirPath = ""; //代表将项目根目录的路径替换为当前目录

将绝对路径中的替换成当前工程的$(PROJECT_DIR)，示例如下：

//未修改之前的代码，已脱敏
HEADER_SEARCH_PATHS = (
					/Users/xxxx/src/main,
					/Users/xxxx/src/main/xx,
					/Users/xxxx/src/main/xx,
					/Users/xxxx/src/main/xxxx,
					/Users/xxxx/src/main/xxx,
					/Users/xxxx/src/main/xxxx,
					/Users/xxxx/src/main/xxxxxxx,
					"$(inherited)",
				);

//修改为
HEADER_SEARCH_PATHS = (
					"$(PROJECT_DIR)/src/main",
					"$(PROJECT_DIR)/src/main/xx",
					"$(PROJECT_DIR)/src/main/xx",
					"$(PROJECT_DIR)/src/main/xxxx",
					"$(PROJECT_DIR)/src/main/xxx",
					"$(PROJECT_DIR)/src/main/xxxx",
					"$(PROJECT_DIR)/src/main/xxxxxxx",
					"$(inherited)",
				);

类似的均这样修改. Note: 在.pbxproj文件中，使用$(PROJECT_DIR)要在路径前后加上双引号，上述代码已体现。