PWABuilder项目中PWA应用商店分发检测机制详解

在PWABuilder生态中，当开发者将PWA应用发布到各大应用商店后，经常需要识别应用是否通过特定平台商店启动。本文将深入解析Android和Windows平台的检测实现方案，帮助开发者构建更精准的渠道分析能力。

核心检测原理

现代应用商店在启动PWA时，会通过两种方式传递来源标识：

1. document.referrer：浏览器环境自动注入的来源信息
2. HTTP Referer头：网络请求携带的来源标记

平台特异性实现

Android平台检测

当应用通过Google Play商店启动时：

• document.referrer 会被设置为固定值："android-app://"
• 所有发出的HTTP请求都会自动携带特殊Referer头

典型检测代码示例：

if (document.referrer.includes('android-app://')) {
    console.log('通过Google Play商店启动');
}

Windows平台检测

通过Microsoft Store启动时表现不同：

• document.referrer 会包含平台标识："app-info://platform/microsoft-store"

检测逻辑建议：

const isMicrosoftStore = document.referrer === 'app-info://platform/microsoft-store';

iOS平台补充说明

虽然本Issue未直接提及，但PWABuilder文档已确认iOS的检测方案：

• 使用特定URL scheme识别App Store来源
• 可通过navigator.standalone属性辅助判断

技术实现建议

1. 初始化检测：在应用启动时立即检查referrer
2. 混合环境处理：考虑用户从浏览器直接访问的兜底逻辑
3. 数据统计集成：将渠道信息同步到数据分析平台

注意事项

• 不同平台浏览器实现可能存在细微差异
• 真机测试时建议使用平台提供的调试工具验证
• 需明确告知用户数据使用目的

通过这套检测机制，开发者可以精确识别应用分发渠道，为后续的渠道分析、用户行为追踪等功能奠定基础。PWABuilder提供的多平台支持使得一次构建即可覆盖主流应用商店场景。