pwa不依赖原生app，二者是协作关系；webview中service worker注册失败主因是环境配置缺失；ios系统级限制导致pwa无法真正独立运行；需通过原生桥接补足能力缺口，并统一登录态与离线数据管理策略。
PWA 本身不支持原生 APP，也不需要它支持——它压根不依赖原生 APP 存在。所谓“不支持”，其实是混淆了两个层面：PWA 是独立运行的 Web 应用，而原生 APP 是另一个进程；两者不是上下级关系，而是协作或共存关系。真正该问的是：当 PWA 功能不够用时，怎么让原生 APP 补上缺口？
WebView 加载 PWA 时 serviceWorker.register() 失败
这是最常卡住的第一步。报错可能是 DOMException: The user denied permission to use Service Worker，但实际往往跟权限无关，而是环境没配齐。
-
setJavaScriptEnabled(true)必须开启，否则navigator.serviceWorker根本不存在 -
setDomStorageEnabled(true)和setDatabaseEnabled(true)在部分 Android 版本中是 SW 注册前置条件 - Android 8.0+ 要求 WebView 使用与主 Activity 共享的
WebSettings实例，否则register()可能返回undefined - 加载 URL 必须是 HTTPS 或
file:///android_asset/，但后者需额外调用setAllowFileAccessFromFileURLs(true) - iOS 的
WKWebView默认禁用 Service Worker，必须确认websiteDataStore已启用，且页面加载完成（didFinishNavigation）后再注册
iOS 上 PWA 无法真正“像 App”一样运行
iOS 的限制不是配置问题，而是系统级阉割。Safari 对 PWA 的支持长期保守，很多你以为能开的功能根本没入口。
-
display: "standalone"下仍显示地址栏（iOS 17.4 起仅部分机型支持全屏），且无法通过 JS 隐藏 - Service Worker 在页面关闭后约 30 秒被系统终止，
background sync和push事件几乎不会触发 - 没有
Web Bluetooth、WebUSB、Background Fetch等 API，连摄像头调用都受限于用户手势+安全上下文双重校验 - “添加到主屏幕”创建的是 Web Clip，不是独立进程，无法后台保活、无法深度通知跳转
需要调用蓝牙/后台定位/厂商推送时怎么办
这些能力浏览器不放行，PWA 拿不到，但原生层可以。关键不是“让 PWA 支持”，而是“让原生替 PWA 做事”。
- 用 Capacitor 或 Cordova 插件桥接：JS 调用
Plugins.Bluetooth.getDevices()，原生 SDK 执行扫描并回传 - 华为 HMS 推送、小米消息通道等必须走原生 SDK，PWA 层只负责接收原生发来的消息并渲染
- 后台定位需原生持续获取坐标，再通过
postMessage或自定义事件推给 PWA 页面 - 别指望
addJavascriptInterface()直接暴露系统 API——它只适合简单同步调用，复杂异步场景建议用 WebViewClient.shouldInterceptRequest + 自定义协议（如myapp://bluetooth/scan）
登录态、缓存、离线数据如何与原生 APP 同步
Service Worker 缓存和原生 APP 的 SQLite / SharedPreferences 不互通，强行共享会出问题。得靠设计对齐，而不是技术硬连。
- 登录态必须同域：PWA 页面（
https://app.example.com）和原生 WebView 加载的 URL 必须共用同一域名，才能透传SameSite=LaxCookie - 离线订单快照这类数据，由原生 APP 主动写入本地文件或数据库，PWA 页面通过
fetch('/api/offline/orders')请求本地 HTTP 服务（如原生起一个微型 server）来读取 - 不要让 PWA 的
cachesAPI 和原生缓存同时管理同一份资源——选一个作为权威源，另一方只读不写 - 若用 intent:// 或 Universal Links 唤起 PWA，确保原生层在唤起前已将必要参数拼进 URL（如
https://app.example.com/orders?token=xxx&offline=true）
真正容易被忽略的，是 scope 和 start_url 的匹配逻辑——哪怕图标、manifest、HTTPS 全对，只要 scope 设成 "/app/" 而 start_url 是 "/"，PWA 就会白屏或 404。这个错误在调试工具里不报错，只静默失败。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
