启用渐进式 Web 应用程序功能 enabling-pwa
通过简单配置,内容作者现在可以为在 AEM Sites 中创建的体验启用渐进式 Web 应用程序 (PWA) 功能。
- 了解 PWA
- 了解您的站点和内容结构
- 了解缓存策略
- 来自开发团队的支持
简介 introduction
利用渐进式 Web 应用程序 (PWA),可以将 AEM 站点本地存储在用户计算机上并使其可供脱机访问,从而实施针对 AEM 站点的像应用程序一样的沉浸式体验。即使失去 Internet 连接,用户也可以在旅途中浏览站点。即使网络中断或不稳定,PWA 也能提供无缝体验。
内容作者无需为站点重新编码,而是可将 PWA 属性配置为站点的页面属性中一个额外的选项卡。
- 保存或发布此配置后,它触发一个写出清单文件的事件处理程序和一个在站点上启用 PWA 功能的 Service Worker。
- 此外,还将维护 Sling 映射,确保从应用程序根提供 Service Worker 以启用代理内容,从而允许应用程序内的离线功能。
利用 PWA,用户可以获得站点的本地副本,并提供像应用程序一样的体验,即使没有 Internet 连接也是如此。
前提条件 prerequisites
要为您的站点启用 PWA 功能,您的项目环境需达到两个要求:
- 使用核心组件以利用此功能
- 调整 Dispatcher 规则以公开所需文件
这些是作者必须与开发团队协调的技术步骤。每个站点只需执行一次这些步骤。
使用核心组件 adjust-components
核心组件版本 2.15.0 及更高版本完全支持 AEM Sites 的 PWA 功能。由于 AEMaaCS 始终包含最新版本的核心组件,因此您可以利用现成的 PWA 功能。您的 AEMaaCS 项目将自动满足此要求。
调整您的 Dispatcher adjust-dispatcher
PWA 功能会生成和使用 /content/<sitename>/manifest.webmanifest
文件。默认情况下,Dispatcher 不公开此类文件。要公开这些文件,开发人员必须将以下配置添加到您的站点项目。
File location: [project directory]/dispatcher/src/conf.dispatcher.d/filters/filters.any >
# Allow webmanifest files
/0102 { /type "allow" /extension "webmanifest" /path "/content/*/manifest" }
根据您的项目,您可能需要加入对重写规则的各种类型的扩展。当您引入隐藏请求并将请求重定向到 /content/<projectName>
的规则时,将 webmanifest
扩展包含在重写条件中会很有用。
RewriteCond %{REQUEST_URI} (.html|.jpe?g|.png|.svg|.webmanifest)$
为站点启用 PWA enabling-pwa-for-your-site
满足前提条件后,内容作者可以轻松地为站点启用 PWA 功能。以下是有关如何执行此操作的基本概览。详细选项部分中详述了各个选项。
-
登录 AEM。
-
从主菜单中选择 导航 > 站点。
-
选择您的站点项目,然后选择 属性 或使用热键
p
。 -
选择 渐进式 Web 应用程序 选项卡,并配置适用的属性。至少您需要:
-
选择 启用 PWA 选项。
-
定义 启动 URL。
-
将 512x512 png 图标上传到 DAM 并将它引用为应用程序的图标。
-
配置要让 Service Worker 在离线时采用的路径。典型路径为:
/content/<sitename>
/content/experiencefragements/<sitename>
/content/dam/<sitename>
- 任何第三方字体引用
/etc/clientlibs/<sitename>
-
-
选择 保存并关闭。
您的站点现已配置,您可以将它作为本地应用程序安装。
使用已启用 PWA 的站点 using-pwa-enabled-site
现在,您已配置站点以支持 PWA,您可以自行体验它。
- 在支持的浏览器中访问该站点。
- 您在浏览器的地址栏中看到一个新图标,这表明可将该站点安装为本地应用程序。
- 此图标可能会因浏览器而异,并且浏览器也可能会显示一个通知(例如,横幅或对话框),指示可以作为本地应用程序安装。
- 安装应用程序。
- 应用程序会安装在设备的主屏幕上。
- 打开应用程序,浏览一下,看看页面是否可供离线使用。
详细选项 detailed-options
以下部分提供了有关在为 PWA 配置站点时可用的选项的更多详细信息。
配置安装体验 configure-installable-experience
以下这些设置通过让您的站点可安装在访客的主屏幕上并离线使用,使其可表现得如同原生应用程序一样。
-
启用 PWA - 这是用于为站点启用 PWA 的主切换开关。
-
启动 URL - 这是在用户加载本地安装的应用程序时应用程序打开的首选启动 URL。
- 它可以是您的内容结构中的任意路径。
- 它不一定是根,通常是应用程序的专用欢迎页面。
- 如果此 URL 是相对的,则清单 URL 将用作基础 URL 以对其进行解析。
- 当留空时,该功能使用从其安装该应用程序的网页的地址。
- 建议您设置一个值。
-
显示模式 – 启用了 PWA 的应用程序仍然是通过浏览器交付的 AEM 站点。这些显示选项定义应如何隐藏浏览器或如何以其他方式将浏览器提供给本地设备上的用户。
- 独立 - 对用户隐藏浏览器,使其看起来如同原生应用程序一样。这是默认值。
- 利用此选项,必须能够使用站点页面上的链接和组件完全通过内容进行应用程序导航,而无需使用浏览器的导航控件。
- 浏览器 – 在访问站点时,浏览器将正常显示。
- 最小化 UI – 浏览器的大部分组件是隐藏的,就像本地应用程序一样,但会显示基础导航控件。
- 全屏 - 隐藏浏览器,使其如同原生应用程序一样,但在全屏模式下呈现它。
- 利用此选项,必须能够使用站点页面上的链接和组件完全通过内容进行应用程序导航,而无需使用浏览器的导航控件。
- 独立 - 对用户隐藏浏览器,使其看起来如同原生应用程序一样。这是默认值。
-
屏幕方向 - 作为本地应用程序,PWA 必须了解如何处理设备方向。
- 任意 – 该应用程序会根据用户设备的方向进行调整。 这是默认值。
- 纵向 – 强制应用程序以纵向布局打开,而不管用户设备的方向如何。
- 横向 – 强制应用程序以横向布局打开,而不管用户设备的方向如何。
-
主题颜色 – 定义应用程序的颜色,将影响本地用户的操作系统显示本机 UI 工具栏和导航控件的方式。它可能会影响其他应用程序演示元素,具体取决于浏览器。
- 使用颜色井弹出窗口选择颜色。
- 还可通过十六进制值或 RGB 值定义颜色。
-
背景颜色 – 定义应用程序的背景颜色,此颜色在应用程序加载时显示。
- 使用颜色井弹出窗口选择颜色。
- 还可通过十六进制值或 RGB 值定义颜色。
- 某些浏览器会自动从应用程序名称、背景颜色和图标构建启动画面。
-
图标 – 这将定义在用户设备上表示应用程序的图标。
- 图标必须是大小为 512x512 像素的 png 文件。
- 图标必须存储在 DAM 中。
缓存管理(高级) offline-configuration
这些设置使该站点的某些部分可以离线使用,并且可以在访客的设备上本地使用。这将允许控制 Web 应用程序的缓存,优化网络请求并支持离线体验。
-
缓存策略和内容刷新频率 – 此设置定义 PWA 的缓存模型。
- 适度 – 此设置适用于大多数站点,并且是默认值。
- 利用此设置,会从缓存中加载用户首先查看的内容,而当用户使用该内容时,缓存中的其余内容会经过重新验证。
- 频繁 - 这适用于拍卖行等需要快速更新的站点。
- 在此设置下,应用程序首先通过网络查找最新内容,如果无此内容可用,则它回退到本地缓存。
- 很少 - 这适用于参考页面等几乎静态的站点。
- 在此设置下,应用程序首先在缓存中查找内容,如果无此内容可用,则回退到网络以检索它。
- 适度 – 此设置适用于大多数站点,并且是默认值。
-
文件预缓存 - 在安装 Service Worker 时和使用它之前将这些托管在 AEM 上的文件保存到本地浏览器缓存。这可保证 Web 应用程序在离线时具有完整功能。
-
路径包含 - 拦截对于所定义的路径的网络请求,并根据所配置的 缓存策略和内容刷新频率 返回缓存的内容。
-
缓存排除 - 无论 文件预缓存 和 路径包含 下的设置如何,都从不缓存这些文件。
限制和建议 limitations-recommendations
并非所有 PWA 功能都可用于 AEM Sites。这些是几项值得注意的限制。
- 如果用户不使用应用程序,则页面不会自动同步或更新。
Adobe 还建议在您实施 PWA 时做到以下几点。
最大程度地减少要预缓存的资源数量。 minimize-precache
Adobe 建议您限制要预缓存的页数。
- 嵌入库,以使您可减少在预缓存时要管理的条目数。
- 限制要预缓存的图像变体的数量。
在项目脚本和样式表稳定后再启用 PWA。 pwa-stabilized
在提供客户端库时添加了一个遵循以下模式的缓存选择器:lc-<checksumHash>-lc
。每次在构成库的文件(和依赖项)之一发生变化时,此选择器即发生变化。如果列出了 service-worker 要预缓存的客户端库并要引用新版本,则可手动检索并更新该条目。因此,Adobe 建议您在项目脚本和样式表稳定后再将您的站点配置为 PWA。
最大程度地减少图像变体的数量。 minimize-variations
AEM 核心组件的图像组件决定了要获取的前端的最佳演绎版。此机制还包括与该资源的最后修改时间对应的时间戳。此机制使 PWA 预缓存的配置难以理解。
在配置预缓存时,用户必须列出所有可获取的路径变体。这些变体由质量和宽度等参数组成。建议您将这些变体的数量减少到最多三个:小、中、大。可通过图像组件的内容策略对话框做到这一点。
如果不仔细配置,则消耗大量内存和网络资源可能会严重影响 PWA 的性能。此外,如果您打算预缓存比如 50 个图像,并且每个图像有三个宽度,则维护站点的用户不得不在页面属性的 PWA 预缓存部分中维护多达 150 个条目的列表。
Adobe 还建议您在项目对图像的使用情况稳定后再将站点配置为 PWA。