Android - PWA 无法在服务工作者的独立模式下打开

Android - PWA does not open in standalone mode with service worker

在开发 Progressive-Web-App 时出现以下问题:

独立模式在不包括 service worker 的情况下工作得很好 - 但不能与。

Chrome-PWA-审计:

login_mobile_tablet.jsf / 包括 service worker:

<script>
    if ('serviceWorker' in navigator) {
        navigator.serviceWorker.register('../serviceWorker.js', {scope: "/application/"})
          /* also tried ".", "/", "./" as scope value */
            .then(function(registration) {
                console.log('Service worker registration successful, scope is: ', registration.scope);
            })
            .catch(function(error) {
                console.log('Service worker registration failed, error: ', error);
            });
    }
</script>

serviceWorker.js:

var cacheName = 'pwa-cache';

// A list of local resources we always want to be cached.
var filesToCache = [
    'QS1.xhtml',
    'pdf.xhtml',
    'QS1.jsf',
    'pdf.jsf',
    'login_pages/login_mobile_tablet.jsf',
    'login_pages/login_mobile_tablet.xhtml'
];

// The install handler takes care of precaching the resources we always need.
self.addEventListener('install', function(event) {

    event.waitUntil(
        caches.open(cacheName).then(function(cache) {
            return cache.addAll(filesToCache);
        })
    );
})

// The activate handler takes care of cleaning up old caches.
self.addEventListener('activate', event => {
    event.waitUntil(self.clients.claim());
});

// The fetch handler serves responses for same-origin resources from a cache.
self.addEventListener('fetch', event => {

    // Workaround for error:
    // TypeError: Failed to execute 'fetch' on 'ServiceWorkerGlobalScope': 'only-if-cached' can be set only with 'same-origin' mode
    // see: 
    if (event.request.cache === 'only-if-cached' && event.request.mode !== 'same-origin')
        return;

    event.respondWith(
        caches.match(event.request, {ignoreSearch: true})
            .then(response => {
                return response || fetch(event.request);
            })
    );
});

manifest.json:

{
   "name":"[Hidden]",
   "short_name":"[Hidden]",
   "start_url":"/application/login_pages/login_mobile_tablet.jsf",
   "scope":".",
   "display":"standalone",
   "background_color":"#4688B8",
   "theme_color":"#4688B8",
   "orientation":"landscape",
   "icons":[
      {
         "src":"javax.faces.resource/images/icons/qsc_128.png.jsf",
         "sizes":"128x128",
         "type":"image/png"
      },
      {
         "src":"javax.faces.resource/images/icons/qsc_144.png.jsf",
         "sizes":"144x144",
         "type":"image/png"
      },
      {
         "src":"javax.faces.resource/images/icons/qsc_152.png.jsf",
         "sizes":"152x152",
         "type":"image/png"
      },
      {
         "src":"javax.faces.resource/images/icons/qsc_192.png.jsf",
         "sizes":"192x192",
         "type":"image/png"
      },
      {
         "src":"javax.faces.resource/images/icons/qsc_256.png.jsf",
         "sizes":"256x256",
         "type":"image/png"
      },
      {
         "src":"javax.faces.resource/images/icons/qsc_512.png.jsf",
         "sizes":"512x512",
         "type":"image/png"
      }
   ]
}

考虑了以下问题/答案 - 但未找到解决方案:

技术背景
当你添加你的 Service-Worker(以及所有其他 PWA-Requirements)时,你的应用程序被创建为一个真正的 PWA - 安装了 Web-APK。 因此,您还需要使用 Default-HTTPS-Port 443 - 确保您使用有效的 HTTPS 证书。
在添加 Service-Worker 之前,缺少此强制性要求,因此您的 PWA 未安装,因此需要较少的其他要求才能显示在 "standalone-mode"
遗憾的是,这没有任何记录......我们不得不 "find out" 自己。

"Installable Web-APK" 的强制性要求清单:
(由于我们找不到完整的列表,我尝试包括所有点数)

  • 已注册 Service-Worker(像您这样的默认实现就足够了)
  • manifest.json(你的有效)
  • 具有有效证书的 https
  • https 默认端口(443,例如 https://yourdomain.com/test/
  • ... 其余的只需检查 chrome 审核工具(提示:您不需要通过所有要求 - 切换到 https-default-port 时您的 web-apk 应该可以工作)