QuickLook插件架构深度解析IViewer接口六步生命周期与优先级机制完整指南【免费下载链接】QuickLookBring macOS “Quick Look” feature to Windows项目地址: https://gitcode.com/gh_mirrors/qu/QuickLookQuickLook 是一款把 macOS「Quick Look」快速预览体验带到 Windows 的免费开源工具按空格键即可预览图片、PDF、音视频、压缩包、APK 等几十种文件。它的“万能”并非写死在一个程序里而是依赖一套插件架构——每种文件类型都是一个独立插件由统一的 IViewer 接口管理其六步生命周期并通过优先级机制决定谁先“接住”文件。本文带你完整看懂这套设计。QuickLook 插件化预览效果一览先看看 QuickLook 预览窗口的实际效果——同一套窗口框架装载着完全不同的插件内容选中文件按空格一个轻量浮动窗口弹出再按空格即可关闭。窗口本身只负责“壳”内容全部来自插件。IViewer所有插件的“合同”每个插件项目位于 QuickLook.Plugin/ 目录下都实现同一个接口定义见 IViewer.cspublic interface IViewer { int Priority { get; } // ① 插件优先级数值越大越优先 void Init(); // ② 应用启动时的一次性初始化 bool CanHandle(string path); // ③ 判断能否打开该文件 void Prepare(string path, ContextObject context); // ④ 窗口显示前的准备 void View(string path, ContextObject context); // ⑤ 开始加载并显示内容 void Cleanup(); // ⑥ 释放非托管资源 }没有多余的东西——5 个方法加 1 个属性就是插件与主程序之间的全部约定。六步生命周期从启动到清理逐步拆解步骤成员调用时机开发者该做什么1️⃣Priority插件加载时读取声明优先级见下文优先级机制2️⃣Init()QuickLook 启动时只执行一次解压依赖资源、加载原生 DLL 等耗时一次性工作3️⃣CanHandle(path)每次预览前判断文件扩展名并检查文件头如魔数4️⃣Prepare(path, context)预览窗口显示之前轻量准备工作不要做耗时操作5️⃣View(path, context)窗口显示后开始加载内容期间显示忙碌指示器完成后把context.IsBusy置为false6️⃣Cleanup()窗口关闭/退出时释放非托管资源GDI、COM、文件句柄等几个容易踩坑的细节Init()与Prepare()的分工Init()适合放“做一次就够了”的重活Prepare()每次预览都会执行只做轻活否则会拖慢预览速度。CanHandle()不能只看扩展名接口注释明确要求“if applicable检查文件头”。这样当多个插件都声称能处理某文件时能识别真实格式的插件才有意义。IsBusy的闭环View()期间窗口自动显示加载动画插件必须显式把context.IsBusy设为false才能让窗口“松手”。优先级机制谁先“接住”这个文件主程序预览文件时会按Priority从高到低依次询问每个插件CanHandle(path)第一个返回true的插件胜出。优先级越高的插件可以“覆盖”低优先级插件对同一文件类型的声明。查看各插件源码优先级分布非常清晰节选自 QuickLook.Plugin/插件Priority说明ELFViewer11全场最高ELF/Mach-O 可执行文件格式特征鲜明抢占优先权ChmViewer2CHM 帮助文件AppViewer、PDFViewer、HtmlViewer 等0绝大多数“常规”插件使用默认档CLSIDViewer-1回收站等系统虚拟对象ArchiveViewer、HelixViewer-5压缩包、3D 模型obj 也是二进制需压低避免误抢BinaryViewer-10兜底插件十六进制查看器谁都没接住的文件由它保底这套负数兜底设计很妙BinaryViewer 的CanHandle()几乎总是返回true任何文件都能按十六进制显示但凭借int.MinValue级别的最低优先级它永远排在最后——QuickLook 因此对“任意文件”都能给出预览。ContextObject插件与主窗口之间的“桥”Prepare()和View()的第二个参数是 ContextObject——一个实现了INotifyPropertyChanged的运行时对象插件通过它反向控制预览窗口属性用途Title/ViewerContent设置窗口标题、装载插件自己的 UI 控件IsBusy控制忙碌指示器的显示/隐藏PreferredSize/SetPreferredSizeFit()设定窗口尺寸并可自动适配屏幕分辨率CanResize/FullWindowDragging是否允许用户缩放、是否支持整窗拖动Theme响应深色/浅色主题见 Themes.csTitlebarAutoHide/TitlebarBlurVisibility标题栏自动隐藏、毛玻璃效果也就是说插件不需要也无法直接操作窗口本身所有外观调整都走这个“桥”这正是架构解耦的关键。MoreMenu插件还能给窗口加“菜单”除了预览插件还可以扩展窗口标题栏右侧的“…” 更多菜单”。接口位于 QuickLook.Common/Plugin/MoreMenu/IMoreMenu.cs插件实现它即可向菜单注入条目IMoreMenuExtended.cs增强版菜单接口MoreMenuItem.cs单个菜单项的封装例如 PdfViewer 用它提供“另存为/打印”操作CsvViewer 用它添加 CSV 导出选项。插件如何反向调用 QuickLook依赖方向上插件只引用公共库 QuickLook.Common不依赖主程序。需要主动触发预览时比如插件内点了“打开完整预览”走 PluginHelper它通过反射查找主程序的ViewWindowManager提供四个入口InvokePreview(path)/InvokePreviewWithOption(path, options)触发预览可携带命令行选项参见 OPTIONS.mdInvokePluginPreview(plugin, path)指定由某个插件打开RunAndClosePreview()关闭当前预览这种“反射桥接”保证公共库与主程序可以独立发版、独立升级——公共库以 NuGet 包形式发布插件项目直接引用即可见 QuickLook.Common/README.md。总结架构三件套IViewer 接口——6 个成员定义六步生命周期插件只需关心“我能不能开、我怎么显示”Priority 优先级——高值抢占、低值兜底int.MinValue级的 BinaryViewer 保证任何文件都有归宿ContextObject PluginHelper——双向通道插件控制窗口、也能反向驱动主程序。想深入更多细节可以翻阅 QuickLook.Common/Plugin/ 下的接口源码或对照 CHANGELOG.md 了解插件生态的演进。理解了这套机制后你写一个新文件类型的 QuickLook 插件只需要做三件事实现IViewer六个成员、注册一个优先级、把 UI 塞进ViewerContent。【免费下载链接】QuickLookBring macOS “Quick Look” feature to Windows项目地址: https://gitcode.com/gh_mirrors/qu/QuickLook创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 QuickLook插件架构深度解析：IViewer接口六步生命周期与优先级机制完整指南
QuickLook插件架构深度解析IViewer接口六步生命周期与优先级机制完整指南【免费下载链接】QuickLookBring macOS “Quick Look” feature to Windows项目地址: https://gitcode.com/gh_mirrors/qu/QuickLookQuickLook 是一款把 macOS「Quick Look」快速预览体验带到 Windows 的免费开源工具按空格键即可预览图片、PDF、音视频、压缩包、APK 等几十种文件。它的“万能”并非写死在一个程序里而是依赖一套插件架构——每种文件类型都是一个独立插件由统一的 IViewer 接口管理其六步生命周期并通过优先级机制决定谁先“接住”文件。本文带你完整看懂这套设计。QuickLook 插件化预览效果一览先看看 QuickLook 预览窗口的实际效果——同一套窗口框架装载着完全不同的插件内容选中文件按空格一个轻量浮动窗口弹出再按空格即可关闭。窗口本身只负责“壳”内容全部来自插件。IViewer所有插件的“合同”每个插件项目位于 QuickLook.Plugin/ 目录下都实现同一个接口定义见 IViewer.cspublic interface IViewer { int Priority { get; } // ① 插件优先级数值越大越优先 void Init(); // ② 应用启动时的一次性初始化 bool CanHandle(string path); // ③ 判断能否打开该文件 void Prepare(string path, ContextObject context); // ④ 窗口显示前的准备 void View(string path, ContextObject context); // ⑤ 开始加载并显示内容 void Cleanup(); // ⑥ 释放非托管资源 }没有多余的东西——5 个方法加 1 个属性就是插件与主程序之间的全部约定。六步生命周期从启动到清理逐步拆解步骤成员调用时机开发者该做什么1️⃣Priority插件加载时读取声明优先级见下文优先级机制2️⃣Init()QuickLook 启动时只执行一次解压依赖资源、加载原生 DLL 等耗时一次性工作3️⃣CanHandle(path)每次预览前判断文件扩展名并检查文件头如魔数4️⃣Prepare(path, context)预览窗口显示之前轻量准备工作不要做耗时操作5️⃣View(path, context)窗口显示后开始加载内容期间显示忙碌指示器完成后把context.IsBusy置为false6️⃣Cleanup()窗口关闭/退出时释放非托管资源GDI、COM、文件句柄等几个容易踩坑的细节Init()与Prepare()的分工Init()适合放“做一次就够了”的重活Prepare()每次预览都会执行只做轻活否则会拖慢预览速度。CanHandle()不能只看扩展名接口注释明确要求“if applicable检查文件头”。这样当多个插件都声称能处理某文件时能识别真实格式的插件才有意义。IsBusy的闭环View()期间窗口自动显示加载动画插件必须显式把context.IsBusy设为false才能让窗口“松手”。优先级机制谁先“接住”这个文件主程序预览文件时会按Priority从高到低依次询问每个插件CanHandle(path)第一个返回true的插件胜出。优先级越高的插件可以“覆盖”低优先级插件对同一文件类型的声明。查看各插件源码优先级分布非常清晰节选自 QuickLook.Plugin/插件Priority说明ELFViewer11全场最高ELF/Mach-O 可执行文件格式特征鲜明抢占优先权ChmViewer2CHM 帮助文件AppViewer、PDFViewer、HtmlViewer 等0绝大多数“常规”插件使用默认档CLSIDViewer-1回收站等系统虚拟对象ArchiveViewer、HelixViewer-5压缩包、3D 模型obj 也是二进制需压低避免误抢BinaryViewer-10兜底插件十六进制查看器谁都没接住的文件由它保底这套负数兜底设计很妙BinaryViewer 的CanHandle()几乎总是返回true任何文件都能按十六进制显示但凭借int.MinValue级别的最低优先级它永远排在最后——QuickLook 因此对“任意文件”都能给出预览。ContextObject插件与主窗口之间的“桥”Prepare()和View()的第二个参数是 ContextObject——一个实现了INotifyPropertyChanged的运行时对象插件通过它反向控制预览窗口属性用途Title/ViewerContent设置窗口标题、装载插件自己的 UI 控件IsBusy控制忙碌指示器的显示/隐藏PreferredSize/SetPreferredSizeFit()设定窗口尺寸并可自动适配屏幕分辨率CanResize/FullWindowDragging是否允许用户缩放、是否支持整窗拖动Theme响应深色/浅色主题见 Themes.csTitlebarAutoHide/TitlebarBlurVisibility标题栏自动隐藏、毛玻璃效果也就是说插件不需要也无法直接操作窗口本身所有外观调整都走这个“桥”这正是架构解耦的关键。MoreMenu插件还能给窗口加“菜单”除了预览插件还可以扩展窗口标题栏右侧的“…” 更多菜单”。接口位于 QuickLook.Common/Plugin/MoreMenu/IMoreMenu.cs插件实现它即可向菜单注入条目IMoreMenuExtended.cs增强版菜单接口MoreMenuItem.cs单个菜单项的封装例如 PdfViewer 用它提供“另存为/打印”操作CsvViewer 用它添加 CSV 导出选项。插件如何反向调用 QuickLook依赖方向上插件只引用公共库 QuickLook.Common不依赖主程序。需要主动触发预览时比如插件内点了“打开完整预览”走 PluginHelper它通过反射查找主程序的ViewWindowManager提供四个入口InvokePreview(path)/InvokePreviewWithOption(path, options)触发预览可携带命令行选项参见 OPTIONS.mdInvokePluginPreview(plugin, path)指定由某个插件打开RunAndClosePreview()关闭当前预览这种“反射桥接”保证公共库与主程序可以独立发版、独立升级——公共库以 NuGet 包形式发布插件项目直接引用即可见 QuickLook.Common/README.md。总结架构三件套IViewer 接口——6 个成员定义六步生命周期插件只需关心“我能不能开、我怎么显示”Priority 优先级——高值抢占、低值兜底int.MinValue级的 BinaryViewer 保证任何文件都有归宿ContextObject PluginHelper——双向通道插件控制窗口、也能反向驱动主程序。想深入更多细节可以翻阅 QuickLook.Common/Plugin/ 下的接口源码或对照 CHANGELOG.md 了解插件生态的演进。理解了这套机制后你写一个新文件类型的 QuickLook 插件只需要做三件事实现IViewer六个成员、注册一个优先级、把 UI 塞进ViewerContent。【免费下载链接】QuickLookBring macOS “Quick Look” feature to Windows项目地址: https://gitcode.com/gh_mirrors/qu/QuickLook创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考