HTML PWA与原生App是平行技术路径，无法自动兼容或打通；Service Worker仅作用于WebView内请求，不劫持原生网络栈，需桥接实现缓存共享与权限调用。
HTML PWA 本身不兼容原生 App，也不是为“兼容”而设计的——它和原生 App 是两条平行技术路径，能协同，但不能混用或自动打通。
Service Worker 和原生进程完全隔离
Service Worker 运行在浏览器或 WebView 的独立线程中，无法访问原生内存、主线程状态或 Java/Kotlin/Swift 对象。即使你在 Android WebView 中加载一个 PWA 页面，navigator.serviceWorker 注册成功，它的缓存（caches.open()）、消息通道（postMessage()）和 fetch 拦截也只作用于该 WebView 实例内的网络请求，不会影响 App 其他模块。
- 常见错误现象：在 WebView 里注册了
sw.js，但离线时原生侧发起的OkHttpClient请求仍失败——因为 Service Worker 不劫持原生网络栈 - 若需共享缓存，必须桥接：比如原生侧把图片 Base64 或文件路径通过
evaluateJavascript()传给 JS，再由 JS 存入indexedDB或cacheStorage - iOS 的 WKWebView 默认禁用 Service Worker，需手动开启：
configuration.preferences.setValue(true, forKey: "allowFileAccessFromFileURLs")且仅对 HTTPS 有效
manifest.json 图标在 Android 和 iOS 行为不一致
Android 浏览器（Chrome、Edge）会读取 manifest.json 中的 icons 数组生成桌面图标；iOS Safari 完全忽略它，只认 <link rel="apple-touch-icon" href="icon-180.png"> 标签，且尺寸必须是 180×180，否则添加到主屏幕后图标模糊或显示为截图。
- 使用场景：你希望用户“添加到主屏幕”后图标清晰统一，就得同时维护两套资源声明
- 容易踩的坑：只配了
manifest.json，没加apple-touch-icon，结果 iOS 用户看到的是网页缩略图，信任感直接掉一半 - 参数差异：
manifest.json中display: "standalone"在 iOS 上无效，Safari 始终显示地址栏；而 Android Chrome 可真正隐藏
原生权限调用必须走桥接，PWA 无权直连
PWA 调用 navigator.geolocation 或 navigator.mediaDevices.getUserMedia() 时，实际触发的是 WebView 底层的原生权限弹窗，但这个过程不可控、不可定制，且部分权限（如蓝牙、后台定位、通知声音）根本不在 Web API 范围内。
立即学习“前端免费学习笔记（深入）”；
- 常见错误现象：PWA 页面调用
getUserMedia()，Android 上正常，iOS 上静默失败——因为 WKWebView 默认关闭媒体设备访问，需在Info.plist显式声明NSCameraUsageDescription和NSMicrophoneUsageDescription - 性能影响：每次调用 Web API 都要跨一次 JS → Native → JS 的桥接，比原生调用多 2–3 倍延迟，不适合高频传感器场景（如陀螺仪实时姿态）
- 厂商差异：华为、小米等定制 ROM 可能拦截
registerProtocolHandler或屏蔽推送订阅，导致 PWA 的“安装后通知”功能在部分安卓机上失效
WebView 加载 PWA 页面不是“混合开发”，而是“嵌套运行”
把 PWA URL（如 https://app.example.com/）丢进 WebView，只是让原生容器当个壳，里面跑的仍是标准 Web 环境。它不会自动获得原生生命周期回调（如 onResume）、也不会响应系统级事件（如来电中断、分屏模式切换）。
- 使用场景：适合已有成熟 PWA，想快速打包成 APK/IPA 分发，又不想重写逻辑
- 容易被忽略的地方：PWA 的
beforeinstallprompt事件在 WebView 中永远不会触发，所以“添加到主屏幕”的引导逻辑要主动禁用，否则用户点按钮毫无反应 - 兼容性风险：Android 12+ 强制 WebView 使用独立渲染进程，PWA 的
localStorage和Service Worker缓存可能被清空，而原生侧无感知
真正难的不是让 PWA 和原生共存，而是厘清哪部分该交给 Web，哪部分必须原生兜底——比如订单查询用 PWA 缓存 + 离线展示，支付流程则切回原生 SDK 处理证书和指纹验证。边界划不清，协作就变成互相拖累。
