MacOS .app双击无法打开文件，终端运行二进制文件正常

当MacOS的.app应用通过文件关联（双击文件或open -a命令）启动时，系统并不会通过argv传递文件路径，而是通过Apple事件传递。这就是你直接运行二进制正常，但打包成.app后无法获取文件路径的核心原因。以下是具体解决步骤：

1. 代码层面修改：捕获Apple事件获取文件路径 #

给你的C++程序添加Apple事件处理逻辑，兼容终端启动和.app启动两种场景：

新增Apple事件处理代码 #

#ifdef __APPLE__
#include <Carbon/Carbon.h>
#include <vector>
#include <string>

// 处理打开文件的Apple事件回调
static OSStatus HandleOpenEvent(EventHandlerCallRef nextHandler, EventRef theEvent, void* userData) {
    AEDesc fileDesc;
    FSRef fsRef;
    char filePath[PATH_MAX];
    auto& fileList = *static_cast<std::vector<std::string>*>(userData);

    // 从事件中提取文件参数
    if (AEGetParamDesc(theEvent, keyDirectObject, typeFileURL, &fileDesc) != noErr) {
        goto cleanup;
    }
    if (AEGetDescData(&fileDesc, &fsRef, sizeof(fsRef)) != noErr) {
        goto cleanup;
    }
    // 转换为POSIX路径
    if (FSRefMakePath(&fsRef, reinterpret_cast<UInt8*>(filePath), PATH_MAX) == noErr) {
        fileList.emplace_back(filePath);
    }

cleanup:
    AEDisposeDesc(&fileDesc);
    return noErr;
}

// 注册Apple事件处理器并运行事件循环
void ProcessAppleEvents(std::vector<std::string>& fileList) {
    // 注册"打开应用"和"打开文档"事件
    EventTypeSpec eventTypes[] = {
        {kEventClassAppleEvent, kEventAppleEventOpenApplication},
        {kEventClassAppleEvent, kEventAppleEventOpenDocuments}
    };
    InstallApplicationEventHandler(
        NewEventHandlerUPP(HandleOpenEvent),
        sizeof(eventTypes)/sizeof(EventTypeSpec),
        eventTypes,
        &fileList,
        nullptr
    );
    // 运行事件循环直到处理完所有事件
    RunApplicationEventLoop();
}
#endif

修改主函数逻辑 #

#include <vector>
#include <string>

void processFile(const std::string& filePath); // 你的文件处理函数

int main(int argc, char* argv[]) {
    std::vector<std::string> inputFiles;

#ifdef __APPLE__
    // 区分终端启动和.app启动：终端启动时argc>1，.app启动时argc=1
    if (argc == 1) {
        ProcessAppleEvents(inputFiles);
    } else {
        // 终端启动，直接读取argv
        for (int i = 1; i < argc; ++i) {
            inputFiles.emplace_back(argv[i]);
        }
    }
#else
    // 非MacOS系统直接读取argv
    for (int i = 1; i < argc; ++i) {
        inputFiles.emplace_back(argv[i]);
    }
#endif

    // 执行原有文件处理逻辑
    for (const auto& file : inputFiles) {
        processFile(file);
    }

    return 0;
}

2. CMake编译配置 #

确保编译时链接Carbon框架，在CMakeLists.txt中添加：

if(APPLE)
    # 启用MacOS Bundle打包
    set(MACOSX_BUNDLE TRUE)
    # 链接Carbon框架处理Apple事件
    target_link_libraries(你的目标程序名 PRIVATE "-framework Carbon")
    # 指定自定义Info.plist路径（如果需要）
    set(MACOSX_BUNDLE_INFO_PLIST ${CMAKE_SOURCE_DIR}/path/to/your/Info.plist)
endif()

3. 验证Info.plist配置 #

确保你的Info.plist中文件关联配置正确，示例如下：

<key>CFBundleDocumentTypes</key>
<array>
    <dict>
        <key>CFBundleTypeName</key>
        <string>MDL Model File</string>
        <key>CFBundleTypeRole</key>
        <string>Editor</string>
        <key>LSHandlerRank</key>
        <string>Owner</string>
        <key>LSItemContentTypes</key>
        <array>
            <string>com.yourcompany.mdl</string>
        </array>
    </dict>
</array>
<key>UTExportedTypeDeclarations</key>
<array>
    <dict>
        <key>UTTypeIdentifier</key>
        <string>com.yourcompany.mdl</string>
        <key>UTTypeDescription</key>
        <string>MDL Model File</string>
        <key>UTTypeConformsTo</key>
        <array>
            <string>public.data</string>
        </array>
        <key>UTTypeTagSpecification</key>
        <dict>
            <key>public.filename-extension</key>
            <array>
                <string>mdl</string>
            </array>
        </dict>
    </dict>
</array>

4. 刷新系统文件关联缓存 #

打包完成后，执行以下命令刷新LaunchServices缓存，确保文件关联生效：

/System/Library/Frameworks/CoreServices.framework/Versions/A/Frameworks/LaunchServices.framework/Versions/A/Support/lsregister -f /Applications/Sengine.app

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