UD5工具箱
什么是 Launch Handler API？它解决了什么问题？
Launch Handler API 是 W3C 标准组织定义的一组 Web API，允许 PWA 开发者控制应用如何响应启动请求。当用户从外部链接、系统分享菜单或其他来源打开 PWA 时，开发者可以通过 manifest.json 中的 launch_handler 字段来决定是聚焦现有窗口、导航现有窗口到新 URL 还是创建新窗口。该 API 解决了 PWA 在多窗口管理方面的体验短板，使 PWA 的启动行为更接近桌面原生应用，提升了用户在使用 PWA 时的连贯性和效率。
client_mode 的四个选项分别适用于哪些场景？
focus-existing：适用于希望用户回到当前任务的场景，例如音乐播放器在后台运行时，用户再次点击播放链接应该聚焦到已有窗口继续播放，而非打开新实例。navigate-existing：适用于需要响应不同 URL 的场景，例如邮件应用收到新邮件链接时，应该在现有窗口中打开该邮件详情。navigate-new：适用于多窗口工作流场景，例如设计工具允许用户同时打开多个项目窗口。auto：浏览器自动决定最佳行为，通常等同于 navigate-existing，适合对启动行为没有特殊要求的通用应用。
如何在 manifest.json 中配置 Launch Handler？
在 manifest.json 中添加 launch_handler 字段即可。基本配置格式如下：在 manifest.json 中添加 launch_handler 字段，其值为一个对象，包含 client_mode 属性。例如 {"launch_handler": {"client_mode": "focus-existing"}}。也可以使用数组语法提供回退选项：{"launch_handler": {"client_mode": ["focus-existing", "navigate-existing"]}}，浏览器会从数组中选择第一个它支持的模式。配置完成后，需要确保 manifest.json 在 HTML 中通过 link rel="manifest" 正确引用，并且 PWA 已经被浏览器识别和安装。
Launch Handler API 的浏览器兼容性如何？
目前 Launch Handler API 主要在 Chromium 内核浏览器中获得支持，包括 Chrome 98 及以上版本和 Edge 98 及以上版本。Firefox 和 Safari 尚未实现该 API。由于兼容性覆盖范围有限，开发者在使用时必须采用渐进增强策略。对于不支持的浏览器，launch_handler 配置会被忽略，PWA 的启动行为将回退到浏览器的默认处理方式。可以通过检查 window.launchQueue 是否存在来判断当前浏览器是否支持该 API。在实际项目中，建议始终提供合理的默认行为，确保所有用户都能正常使用应用。
route_to 与 client_mode 如何配合使用？
client_mode 定义了全局的启动窗口处理策略，而 route_to 提供了针对特定启动来源的细粒度控制。两者的关系是：route_to 的配置优先于 client_mode，当某个启动来源配置了 route_to 时，该来源的启动请求会按照 route_to 的策略处理，其他来源仍遵循 client_mode 的全局策略。route_to 支持三个值：existing-client 路由到现有 PWA 客户端、new-client 创建新客户端实例、existing-client-navigate 路由到现有客户端并导航。通过 launching_from 字段可以指定 route_to 作用的启动来源，如 "share-target" 或 "navigate"。
使用 Launch Handler 有哪些最佳实践？
首先，始终测试多窗口场景，确保在多个 PWA 窗口同时打开时行为符合预期。其次，处理深层链接时要确保应用能正确处理不同 URL 的导航，特别是在 navigate-existing 模式下。第三，注意移动端限制，移动端设备通常只允许 PWA 的单实例运行，navigate-new 模式在移动端可能不会创建新窗口。第四，与 share_target 配合使用时，确保 route_to 配置合理，分享内容能被正确接收和展示。最后，始终采用渐进增强策略，为不支持 Launch Handler 的浏览器提供合理的默认行为回退。
在本工具中如何测试不同的启动场景？
工具提供了三种启动场景供测试：外部链接启动、分享目标和浏览器导航。在配置面板的"模拟启动场景"区域，点击对应的按钮即可触发模拟。每种场景会模拟不同的启动参数，你可以在桌面模拟器中观察窗口状态的变化，在行为日志中查看完整的执行过程。测试完成后点击"重置模拟环境"按钮恢复初始状态，即可进行下一轮测试。建议在每种 client_mode 下逐一测试三种启动场景，确保配置在所有场景下都能产生预期行为。
本工具生成的 Manifest 代码能否直接用于生产环境？
工具生成的 manifest.json 代码片段包含了 launch_handler 配置以及基本的应用元数据字段，格式遵循 W3C 规范，可以直接作为配置参考。但在用于生产环境之前，你需要根据实际项目需求修改 name、short_name、start_url、scope、icons 等字段的值。此外，建议在真实 PWA 环境中进行最终验证，因为工具的模拟行为可能与实际浏览器实现存在细微差异。同时，确保项目中已正确配置 Service Worker、HTTPS 和其他 PWA 必需的基础组件。
Launch Handler API 与 Web App Lifecycle 有什么关系？
Launch Handler API 与 Web App Lifecycle 有什么关系？
Web App Lifecycle 是指 PWA 从启动、运行到关闭的完整生命周期管理。Launch Handler API 是该生命周期中的"启动"环节的核心组件。当 PWA 被启动时，Launch Handler 首先决定如何处理窗口实例，然后应用代码开始执行，最后用户可能关闭应用。在生命周期的其他环节，Service Worker 负责管理缓存和离线策略，beforeinstallprompt 事件控制安装提示，visibilitychange 事件处理前后台切换。Launch Handler 与这些机制协同工作，共同构建完整的 PWA 生命周期管理框架。