如何在CMake中优雅地向macOS Bundle添加资源（解决.obj文件错误）

问题根源 #

把.obj模型文件直接加入add_executable时，CMake会误将其识别为目标文件（Windows平台下目标文件扩展名就是.obj），导致链接器ld尝试处理它，最终抛出"unknown file type"错误。

优雅解决方案 #

方案1：标记资源文件为仅头文件

通过set_source_files_properties将.obj文件标记为HEADER_FILE_ONLY，告诉CMake不需要编译/链接该文件，仅作为资源打包进Bundle：

# 先标记.obj文件为仅头文件
set_source_files_properties(models/cube.obj PROPERTIES HEADER_FILE_ONLY TRUE)

# 正常添加可执行文件和所有资源
add_executable(YourApp MACOSX_BUNDLE
    main.cpp
    shaders/vertex.glsl
    shaders/fragment.glsl
    models/cube.obj
)

# 设置所有资源在Bundle中的位置
set_source_files_properties(
    shaders/vertex.glsl
    shaders/fragment.glsl
    models/cube.obj
    PROPERTIES
    MACOSX_PACKAGE_LOCATION Resources
)

方案2：使用CMake资源文件集（推荐）

CMake 3.13+支持FILE_SET语法，专门用于管理资源文件，完全避免资源被误当作编译目标：

# 创建可执行目标
add_executable(YourApp MACOSX_BUNDLE
    main.cpp
)

# 定义所有资源文件
set(APP_RESOURCES
    shaders/vertex.glsl
    shaders/fragment.glsl
    models/cube.obj
)

# 将资源以RESOURCE类型添加到目标
target_sources(YourApp PRIVATE
    FILE_SET resources TYPE RESOURCE FILES ${APP_RESOURCES}
)

# 设置资源在Bundle中的存放路径
set_target_properties(YourApp PROPERTIES
    RESOURCE_LOCATION "Resources"
)

运行时资源访问提示 #

打包完成后，代码中需要通过macOS Bundle API获取资源路径，比如C++中可以用CoreFoundation实现：

#include <CoreFoundation/CoreFoundation.h>

std::string getResourcePath(const std::string& name, const std::string& ext) {
    CFStringRef fileName = CFStringCreateWithCString(nullptr, name.c_str(), kCFStringEncodingUTF8);
    CFStringRef fileExt = CFStringCreateWithCString(nullptr, ext.c_str(), kCFStringEncodingUTF8);
    CFURLRef url = CFBundleCopyResourceURL(CFBundleGetMainBundle(), fileName, fileExt, nullptr);
    
    char path[PATH_MAX];
    if (CFURLGetFileSystemRepresentation(url, true, (UInt8*)path, PATH_MAX)) {
        CFRelease(fileName);
        CFRelease(fileExt);
        CFRelease(url);
        return std::string(path);
    }
    
    CFRelease(fileName);
    CFRelease(fileExt);
    CFRelease(url);
    return "";
}

// 使用示例
std::string cubePath = getResourcePath("cube", "obj");

内容的提问来源于stack exchange，提问作者julcs