related_applications用于让网页识别已安装的自家原生应用以优化跳转,仅支持HTTPS及双向验证;需在manifest.json中声明并完成平台侧反向验证(如Android的assetlinks.json、iOS的ASA文件);JS中调用navigator.getInstalledRelatedApps()检测。

明确关联目的和限制
设置 related_applications 是为了让网页能识别设备上是否已安装对应的原生应用(如 Android APK、iOS App 或封装的 PWA),从而优化跳转逻辑或隐藏重复安装提示。但要注意:它只能检查你自家的应用,不能探测第三方 App;且仅支持 HTTPS 网站,且必须完成双向验证关系。
在 manifest.json 中声明关联信息
在 Web 应用清单文件 manifest.json 的根对象中添加 related_applications 数组,并可选设 prefer_related_applications: true(表示优先引导用户打开原生应用而非网页):
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
- Android 原生应用示例:
"related_applications": [
{
"platform": "play",
"id": "com.example.myapp",
"url": "https://example.com/app"
}
]
- 使用 Bubblewrap 封装的 PWA(TWA):
"related_applications": [
{
"platform": "play",
"id": "com.example.myapp.twa",
"url": "https://example.com/"
}
]
- iOS 应用需通过 Apple App Site Association(ASA)文件验证,
manifest.json中不直接写 iOS 信息,而是靠域名级关联 - 最多只校验前三项,多余条目会被忽略
完成平台侧的反向验证
仅声明不够,还需让原生应用“认领”该网页,建立可信绑定:
-
Android(Google Play):在 Play Console 的应用发布设置中,启用「数字资产链接」并上传签名的
assetlinks.json到https://example.com/.well-known/assetlinks.json -
iOS(Apple):在服务器根目录部署
apple-app-site-association(无扩展名),内容为 JSON 格式,声明applinks和对应appID,且需通过 HTTPS 直接可访问、无重定向、无 MIME 类型错误 -
Windows(UWP):在应用包清单中配置
uap:AppListEntry并在网站部署windows-app-web-link文件
在网页中调用 API 检测安装状态
验证完成后,可在页面 JS 中使用标准 API 查询:
if ('getInstalledRelatedApps' in navigator) {
try {
const apps = await navigator.getInstalledRelatedApps();
if (apps.length > 0) {
// 已安装至少一个关联应用,例如跳转 schema
window.location.href = 'myapp://open/home';
}
} catch (err) {
console.warn('检测失败', err);
}
}
- 该方法返回 Promise,解析为对象数组,每个对象含
platform、id、url等字段 - 仅在用户已实际安装且通过验证的应用才会出现在结果中
- 建议配合
beforeinstallprompt事件做条件判断,避免干扰未安装用户的体验

















