premake5构建macOS游戏引擎时ld提示找不到-lCocoa库如何解决

问题根源 #

macOS 平台的系统级功能以*框架（Framework）*形式提供，和普通静态/动态库的链接逻辑不同。你当前将 Cocoa、IOKit 这类系统框架直接放在 links 配置中，链接器会尝试查找名为 libCocoa.dylib/libCocoa.a 的普通库，自然会抛出 library not found for -lCocoa 错误。

修复步骤 #

premake 专门提供了 frameworks 配置项处理 Apple 平台的框架链接，你只需要调整两处配置：

1. 修改 Neurex 项目的 macOS 过滤块，将系统框架从 links 移到 frameworks 中：

filter "system:macosx"
    links {
        "GLFW",
        "glad",
        "imgui"
    }
    -- 新增frameworks字段存放系统框架
    frameworks {
        "Cocoa",
        "CoreVideo",
        "OpenGL",
        "IOKit"
    }
    defines {
        "NX_PT_OSX",
        "GLFW_INCLUDE_NONE",
        "_CRT_SECURE_NO_WARNINGS"   
    }

2. 修改 NXSandbox 项目的 macOS 过滤块，同样把系统框架移到 frameworks 中：

filter "system:macosx"
    frameworks {
        "Cocoa",
        "IOKit",
        "OpenGL",
        "CoreVideo"
    }
    defines {
        "NX_PT_OSX",
        "GLFW_INCLUDE_NONE",
        "_CRT_SECURE_NO_WARNINGS"
    }

可选优化 #

静态库本身不会合并依赖的系统框架，所以你也可以直接删掉 Neurex 项目里的 frameworks 配置，只在最终可执行文件 NXSandbox 中配置框架即可，不会影响编译结果。

生效操作 #

修改配置后执行以下命令重新生成构建文件并编译：

premake5 clean
premake5 gmake2 # 习惯使用旧版gmake可以替换为premake5 gmake
make -j$(sysctl -n hw.ncpu)

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