LocalSend macOS 分享扩展功能失效问题分析与解决方案

问题背景

LocalSend 是一款开源的跨平台文件传输工具，其 macOS 版本提供了一个分享扩展功能，允许用户直接从 Finder 或其他应用中通过系统分享菜单发送文件。然而，在最近的开发过程中，开发团队发现该功能出现了异常：当 LocalSend 主应用未运行时，通过分享扩展发送文件会失败。

问题现象

在早期版本中，分享扩展功能可以正常工作，即使用户未启动 LocalSend 主应用也能成功发送文件。但在最近的代码更新后，该功能出现了以下异常表现：

1. 当 LocalSend 主应用未运行时，通过分享扩展发送文件会失败
2. 即使主应用启动后，分享功能也无法正常工作
3. 调试日志显示 getPendingFiles() 方法返回空列表

技术分析

通过对代码的深入分析，发现问题根源在于 macOS 平台特有的应用生命周期管理与 Flutter 方法通道初始化时序问题。

核心机制

LocalSend 的分享扩展功能实现依赖于以下技术组件：

1. UserDefaults 共享：主应用和分享扩展通过 App Group 共享数据
2. 方法通道：Flutter 与原生平台间的通信机制
3. 事件时序：应用启动时各模块的初始化顺序

问题根源

当用户通过分享扩展发送文件时，系统会执行以下流程：

1. 分享扩展将文件路径保存到共享的 UserDefaults
2. 系统启动 LocalSend 主应用
3. 主应用初始化时尝试读取共享数据并通知 Flutter 层

问题出在第3步：主应用的原生代码在 Flutter 引擎完全初始化前就尝试通过方法通道发送数据，导致消息丢失。具体表现为：

1. 原生代码过早调用 invokeMethod("onPendingFiles")
2. 此时 Flutter 端的方法处理器尚未注册
3. 随后 getPendingFiles() 被调用时，UserDefaults 已被清空

解决方案

经过团队讨论，确定了以下解决方案：

1. 时序控制：确保方法通道处理器注册完成后再发送数据
2. 简化流程：移除冗余的 getPendingFiles() 调用
3. 错误处理：增加对方法通道未就绪情况的处理

具体实现上，团队调整了初始化流程：

1. 让原生代码等待 Flutter 端明确请求数据后再发送
2. 简化数据传递流程，避免不必要的中间步骤
3. 增加调试日志帮助追踪问题

技术启示

这个问题为跨平台开发提供了几个重要经验：

1. 平台特性考量：macOS 的应用生命周期与移动平台有所不同
2. 初始化时序：Flutter 与原生代码交互需要考虑引擎初始化时间
3. 调试技巧：在关键路径添加日志有助于快速定位问题
4. 数据共享：App Group 的使用需要注意数据同步时机

总结

LocalSend 的 macOS 分享扩展功能失效问题展示了跨平台开发中常见的平台特性适配挑战。通过深入分析应用生命周期和方法通道工作机制，开发团队不仅解决了当前问题，还为未来的功能开发积累了宝贵经验。这类问题的解决往往需要开发者同时理解 Flutter 框架和原生平台的工作机制，才能在复杂场景下确保功能的可靠性。