macOS 10.15及以上版本OpenFilesHandler失效问题求助

核心问题分析 #

你遇到的是Java 8开发的macOS应用适配问题：旧系统（如10.13）中，双击关联文件时无论应用是否启动都能正常加载文件；但在10.15及以上版本，仅应用未启动时能正常打开文件，已启动状态下Finder仅播放动画，com.apple.eawt.OpenFilesHandler的handleOpenFile方法完全不触发。结合测试结果，核心诱因是macOS 10.15引入的事件转发机制变化，以及Java 8的AWT适配层在应用激活状态下的事件传递缺陷。

定位与修复步骤 #

1. 强制事件分发到EDT线程 #

macOS 10.15+对已激活应用的外部事件拦截更严格，Java 8的OpenFilesHandler可能因线程问题无法触发。手动将事件分发到事件调度线程（EDT），确保业务逻辑能接收到事件：

import com.apple.eawt.Application;
import com.apple.eawt.AppEvent;

public class MacFileHandler {
    public static void registerOpenHandler() {
        Application app = Application.getApplication();
        app.setOpenFileHandler((AppEvent.OpenFilesEvent event) -> {
            // 强制在EDT线程处理文件打开逻辑
            java.awt.EventQueue.invokeLater(() -> {
                loadFiles(event.getFiles());
            });
        });
    }

    private static void loadFiles(java.util.List<java.io.File> files) {
        // 你的文件加载业务逻辑
    }
}

• 临时验证：将应用切换到后台后双击文件，若能触发事件，说明是激活状态下的线程拦截问题，上述代码可修复。

2. 替换启动可执行文件并验证参数传递 #

macOS 12+要求使用编译后的启动器而非脚本，若启动器未正确转发文件路径参数，已启动的应用无法接收新事件：

• 使用jpackage（可适配Java 8）或最新版AppBundler生成编译后的启动器，确保启动器能将Finder传递的文件路径参数转发给Java进程。
• 验证参数传递：在已启动的应用中，通过System.getProperty("sun.java.command")检查是否能获取到新的文件路径参数。

3. 补充Info.plist的隐私与事件权限配置 #

10.15+的隐私机制会限制Apple Event的传递，需在Info.plist中添加必要配置：

<!-- 声明Apple Event使用权限 -->
<key>NSAppleEventsUsageDescription</key>
<string>需要接收文件打开事件以加载专有格式文件</string>

<!-- 确保文档类型配置正确 -->
<key>CFBundleDocumentTypes</key>
<array>
    <dict>
        <key>CFBundleTypeName</key>
        <string>你的专有文件类型名称</string>
        <key>CFBundleTypeRole</key>
        <string>Editor</string>
        <key>LSHandlerRank</key>
        <string>Owner</string>
        <key>LSItemContentTypes</key>
        <array>
            <string>你的文件类型UTI</string>
        </array>
    </dict>
</array>

• 若应用设置了LSUIElement为true（后台运行），需额外处理事件转发，后台应用默认不接收Finder的Open事件。

4. 直接监听Apple Events绕过AWT适配层 #

如果AWT的OpenFilesHandler完全失效，可通过JNA直接注册Apple Event处理器，绕过Java 8的适配限制：

import com.sun.jna.Native;
import com.sun.jna.platform.mac.CoreFoundation;
import com.sun.jna.platform.mac.CoreServices;

public class AppleEventHook {
    public static void installOpenDocumentHandler() {
        CoreServices.AEEventHandlerUPP handler = new CoreServices.AEEventHandlerUPP() {
            @Override
            public void invoke(CoreFoundation.AEEventID eventID, CoreFoundation.AEDesc eventData, CoreFoundation.AEDesc replyData, Object refcon) {
                // 解析eventData中的文件路径，注意在EDT线程执行UI操作
                java.awt.EventQueue.invokeLater(() -> {
                    // 处理文件加载逻辑
                });
            }
        };
        CoreServices.AEInstallEventHandler(
            CoreServices.kCoreEventClass,
            CoreServices.kAEOpenDocuments,
            handler,
            null,
            false
        );
    }
}

5. 确保应用单实例运行 #

macOS期望关联文件的应用为单实例，若应用允许多实例，事件可能被发送到未激活的实例：

Application app = Application.getApplication();
// 注册退出与偏好设置处理器，确保单实例逻辑
app.setQuitHandler((AppEvent.QuitEvent e, com.apple.eawt.QuitResponse response) -> {
    response.performQuit();
});
app.setPreferencesHandler((AppEvent.PreferencesEvent e) -> {});

验证手段 #

1. 用Console.app查看应用的系统日志，搜索AppleEvent或AWT相关错误，定位事件传递失败的具体原因。
2. 在macOS 10.15上测试编译后的启动器，确认已启动状态下的文件打开事件是否触发。
3. 检查系统隐私设置，确保应用已获得“文件与文件夹”访问权限。

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