Get Installed Related Apps API 帮助 PWA 检测原生伴侣应用

为什么重要

用户常常同时拥有 PWA 和配套原生应用。如果无法检测，你可能会重复展示安装提示或提供失效的深链。

Get Installed Related Apps API 为 Web 应用提供可靠方式，了解已安装内容。

如何使用

1. 在网站与原生应用包之间注册已验证的关系。
2. 在用户手势上下文中调用 navigator.getInstalledRelatedApps()。
3. 检查返回列表中匹配的 id 或 platform。

const relatedApps = await navigator.getInstalledRelatedApps();
const hasNative = relatedApps.some(app => app.id.includes('com.example.native'));

判断框架

• 如果伴侣应用存在，显示「用原生应用打开」。
• 仅在未检测到原生应用时回退到 PWA 安装提示。
• 用 API 结果个性化新手引导，避免双重安装摩擦。

官方来源

• Get Installed Related Apps
• Windows 应用清单需注册 URI handler 以完成验证。