Activation des fonctionnalités d’application web progressive enabling-pwa

Grâce à une configuration simple, un auteur de contenu peut désormais activer des fonctionnalités d’application web progressive (PWA) pour les expériences créées dans AEM Sites.

CAUTION
Cette fonction avancée requiert :
  • de savoir comment fonctionnent les PWA ;
  • de savoir comment sont organisés votre site et sa structure de contenu ;
  • la compréhension des stratégies de mise en cache ;
  • l’assistance de votre équipe de développement.
Avant d’utiliser cette fonctionnalité, Adobe vous recommande de discuter de cette question avec votre équipe de développement afin de définir la meilleure manière de l’utiliser pour votre projet.

Présentation introduction

Les applications web progressives (PWA) permettent d’offrir des expériences immersives, similaires à des applications, sur des sites AEM en leur permettant d’être stockées localement sur l’ordinateur d’un utilisateur et d’être accessibles hors ligne. Un utilisateur peut parcourir un site en déplacement, même s’il ne dispose pas d’une connexion Internet. Les PWA permettent une expérience transparente même si le réseau est perdu ou instable.

Au lieu d’exiger l’enregistrement du site, un auteur de contenu peut configurer les propriétés du PWA comme onglet supplémentaire dans les propriétés de page d’un site.

  • Une fois enregistrée ou publiée, cette configuration déclenche un gestionnaire d’événements qui écrit les fichiers de manifeste et un service worker qui activent les fonctionnalités de PWA sur le site.
  • Les mappages Sling sont également conservés afin de garantir que l’agent de service est servi à partir de la racine de l’application afin d’activer le contenu proxy permettant des fonctionnalités hors ligne dans l’application.

En PWA, l’utilisateur dispose d’une copie locale du site, ce qui lui permet de vivre une expérience similaire à une application, même sans connexion Internet.

NOTE
Les applications web progressives sont une technologie en évolution et la prise en charge de l’installation d’applications locales et d’autres fonctionnalités dépend du navigateur utilisé.

Prérequis prerequisites

Pour pouvoir utiliser les fonctionnalités PWA sur votre site, l’environnement de votre projet requiert deux éléments :

  1. Utilisez les composants principaux pour tirer parti de cette fonctionnalité
  2. Ajustez vos règles Dispatcher pour exposer les fichiers requis

Il s’agit d’étapes techniques que l’auteur doit coordonner avec l’équipe de développement. Ces étapes ne sont requises qu’une seule fois par site.

Utilisez les composants principaux adjust-components

Les composants principaux de la version 2.15.0 et des versions ultérieures prennent entièrement en charge les fonctionnalités PWA d’AEM Sites. Comme AEMaaCS inclut toujours la dernière version des composants principaux, vous pouvez utiliser les fonctionnalités PWA prêtes à l’emploi. Votre projet AEMaaCS répond automatiquement à cette exigence.

NOTE
Adobe ne recommande pas d’utiliser les fonctionnalités PWA sur les composants personnalisés ou composants non étendus à partir des composants principaux.

Ajustement de votre Dispatcher adjust-dispatcher

La fonctionnalité PWA génère et utilise des fichiers /content/<sitename>/manifest.webmanifest. Par défaut, le Dispatcher n’expose pas ces fichiers. Pour exposer ces fichiers, le développeur ou la développeuse doit ajouter la configuration suivante à votre projet de site.

File location: [project directory]/dispatcher/src/conf.dispatcher.d/filters/filters.any >

# Allow webmanifest files
/0102 { /type "allow" /extension "webmanifest" /path "/content/*/manifest" }

Selon votre projet, vous pouvez inclure différents types d’extensions aux règles de réécriture. Il peut s’avérer utile d’inclure l’extension webmanifest dans les conditions de réécriture lorsque vous avez introduit une règle qui masque et redirige les requêtes vers /content/<projectName>.

RewriteCond %{REQUEST_URI} (.html|.jpe?g|.png|.svg|.webmanifest)$

Activation de fonctionnalités PWA pour votre site enabling-pwa-for-your-site

Avec les conditions préalables remplies, il est facile pour un auteur de contenu d’activer des fonctionnalités de PWA sur un site. Vous trouverez ci-dessous un aperçu basique de la procédure. Les options individuelles sont détaillées dans la section Options détaillées.

  1. Connectez-vous à AEM.

  2. Dans le menu principal, sélectionnez Navigation > Sites.

  3. Sélectionnez votre projet de sites et sélectionnez Propriétés ou utilisez la touche de raccourci p.

  4. Sélectionnez l’onglet Application web progressive et configurez les propriétés concernées. Vous souhaitez au minimum :

    1. sélectionner l’option Activer PWA  ;

    2. définir l’URL de la page d’accueil  ;

      Activer PWA

    3. charger une icône de 512 x 512 au format png sur le DAM et la référencer en tant qu’icône de l’application ;

      Définir l’icône de PWA

    4. Configurez les chemins que vous souhaitez que le service Worker prenne hors ligne. Les chemins types sont les suivants :

      • /content/<sitename>
      • /content/experiencefragements/<sitename>
      • /content/dam/<sitename>
      • Toute référence de police tierce
      • /etc/clientlibs/<sitename>

      Définir des chemins hors ligne PWA

  5. Sélectionnez Enregistrer et fermer.

Votre site est maintenant configuré et vous pouvez l’installer en tant qu’application locale.

Utilisation de votre site compatible PWA using-pwa-enabled-site

Maintenant que vous avez configuré votre site pour prendre en charge le PWA, vous pouvez l’expérimenter par vous-même.

  1. Accédez au site dans un navigateur pris en charge.
  2. Une nouvelle icône s’affiche dans la barre d’adresse du navigateur, indiquant que le site peut être installé en tant qu’application locale.
    • Selon le navigateur, l’icône peut varier et le navigateur peut également afficher une notification (comme une bannière ou une boîte de dialogue) indiquant qu’il est possible de procéder à l’installation en tant qu’application locale.
  3. Installez l’application.
  4. L’application est installée sur l’écran d’accueil de votre appareil.
  5. Ouvrez l’application, parcourez le site et vérifiez que les pages sont disponibles hors ligne.

Options détaillées detailed-options

La section suivante fournit plus de détails sur les options disponibles lorsque vous configurez votre site pour PWA.

Configuration de l’expérience d’installation configure-installable-experience

Ces paramètres permettent à votre site de se comporter comme une application native en le rendant installable sur l’écran d’accueil du visiteur et disponible hors ligne.

  • Activer le PWA : il s’agit du principal bouton d’activation du PWA pour le site.

  • URL de démarrage : il s’agit de l’ URL de démarrage préférée que l’application ouvre lorsque l’utilisateur charge l’application installée localement.

    • Il peut s’agir de n’importe quel chemin dans votre structure de contenu.
    • Il n’est pas nécessaire qu’il s’agisse de la racine et il s’agit souvent d’une page d’accueil dédiée à l’application.
    • Si cette URL est relative, l’URL du manifeste est utilisée en tant qu’URL de base pour la résoudre.
    • Lorsqu’elle est vide, la fonction utilise l’adresse de la page web à partir de laquelle l’application a été installée.
    • Il est recommandé de définir une valeur.
  • Mode d’affichage  : une application activée pour PWA reste un site AEM mis à disposition par le biais d’un navigateur. Ces options d’affichage définissent la manière dont navigateur doit être masqué ou présenté à l’utilisateur sur l’appareil local.

    • Autonome - Le navigateur est masqué à l’utilisateur et il apparaît comme une application native. Il s’agit de la valeur par défaut.
      • Avec cette option, la navigation de l’application doit être entièrement accessible par le biais de votre contenu à l’aide de liens et de composants sur les pages du site sans utiliser les commandes de navigation du navigateur.
    • Par navigateur  : le navigateur s’affiche comme il le ferait normalement lors de la visite du site.
    • Par interface utilisateur minimale  : le navigateur est généralement masqué, comme il le serait en tant qu’application native, mais les commandes de navigation de base sont affichées.
    • Plein écran - Le navigateur est masqué, comme une application native, mais s’affiche en mode Plein écran.
      • Avec cette option, la navigation de l’application doit être entièrement accessible par le biais de votre contenu à l’aide de liens et de composants sur les pages du site sans utiliser les commandes de navigation du navigateur.
  • Orientation de l’écran - En tant qu’application locale, le PWA doit savoir gérer les orientations de périphérique.

    • Auto  : l’application s’adapte à l’orientation de l’appareil de l’utilisateur. Il s’agit de la valeur par défaut.
    • Portrait  : cette option force l’application à s’ouvrir en mode portrait, quelle que soit l’orientation de l’appareil de l’utilisateur.
    • Paysage  : cette option force l’application à s’ouvrir en mode paysage, quelle que soit l’orientation de l’appareil de l’utilisateur.
  • Couleur du thème  : définit la couleur de l’application utilisée pour l’affichage de la barre d’outils native et des commandes de navigation de l’interface utilisateur par le système d’exploitation de l’utilisateur local. En fonction du navigateur, cette option peut affecter d’autres éléments de présentation de l’application.

    • Utilisez la fenêtre contextuelle de couleurs pour sélectionner une couleur.
    • La couleur peut également être définie selon une valeur hexadécimale ou RVB.
  • Couleur d’arrière-plan  : définit la couleur d’arrière-plan de l’application qui s’affiche au chargement de l’application.

    • Utilisez la fenêtre contextuelle de couleurs pour sélectionner une couleur.
    • La couleur peut également être définie selon une valeur hexadécimale ou RVB.
    • Certains navigateurs créent automatiquement un écran de démarrage en utilisant le nom, la couleur d’arrière-plan et de l’icône de l’application.
  • Icône  : définit l’icône qui représente l’application sur l’appareil de l’utilisateur.

    • L’icône doit être constituée d’un fichier PNG de 512 x 512 pixels.
    • Elle doit être stockée sur le DAM.

Gestion du cache (avancé) offline-configuration

Ces paramètres rendent des parties de ce site disponibles hors ligne et localement sur l’appareil de votre visiteur. Ils permettent de contrôler le cache de l’application web pour optimiser les demandes réseau et prendre en charge les expériences hors ligne.

  • Stratégie de mise en cache et fréquence d’actualisation du contenu  : ce paramètre définit le modèle de mise en cache de votre PWA.

    • Modérée  : ce paramètre est valable pour la plupart des sites et est défini comme valeur par défaut.
      • Avec ce paramètre, le contenu affiché pour la première fois par la personne utilisatrice est chargé à partir du cache. Pendant que la personne consomme ce contenu, le reste du contenu du cache est revalidé.
    • Fréquemment - C’est le cas pour les sites qui ont besoin de mises à jour pour être rapides, comme les maisons d’enchères.
      • Avec ce paramètre, l’application recherche d’abord le contenu le plus récent par le biais du réseau. S’il n’est pas disponible, il revient au cache local.
    • Rare  : concerne les sites qui sont pour ainsi dire statiques, tels que les pages de référence.
      • Avec ce paramètre, l’application recherche d’abord le contenu dans le cache, et s’il n’est pas disponible, il revient au réseau pour le récupérer.
  • Prémise en cache des fichiers  : ces fichiers hébergés sur AEM sont enregistrés dans la mémoire cache du navigateur local lorsque l’agent de service s’installe et avant son utilisation. Cela garantit que l’application web est entièrement fonctionnelle hors ligne.

  • Inclusions des chemins  : les demandes réseau pour les chemins définis sont interceptées et le contenu mis en cache est renvoyé conformément à la stratégie de mise en cache et à la fréquence d’actualisation configurées pour le contenu.

  • Exclusions du cache - Ces fichiers ne sont jamais mis en cache, quels que soient les paramètres définis sous Pré-mise en cache de fichier et Inclusions de chemin d’accès.

TIP
Votre équipe de développeurs peut probablement vous offrir un avis précieux sur votre configuration hors ligne.

Restrictions et recommandations limitations-recommendations

Toutes les fonctionnalités PWA ne sont pas disponibles pour AEM Sites. Il existe quelques cas importants de restriction.

  • Les pages ne sont pas automatiquement synchronisées ni mises à jour si l’utilisateur n’utilise pas l’application.

Adobe recommande également ce qui suit lorsque vous implémentez PWA.

Réduisez le nombre de ressources à mettre en cache. minimize-precache

Adobe recommande de limiter le nombre de pages à mettre en cache.

  • Incorporer des bibliothèques afin de réduire le nombre d’entrées à gérer lors de la pré-mise en cache.
  • Limitez le nombre de variations d’image à mettre en cache.

Activez PWA une fois que les scripts et les feuilles de style du projet sont stabilisés. pwa-stabilized

Les bibliothèques clientes sont fournies avec un sélecteur de cache qui se conforme au modèle suivant lc-<checksumHash>-lc. Chaque fois que l’un des fichiers (et dépendances) qui composent une bibliothèque change, ce sélecteur change. Si vous avez répertorié une bibliothèque cliente à mettre en cache par le biais de l’agent de service et que vous souhaitez vous référer à une nouvelle version, vous récupérez et mettez à jour manuellement l’entrée. Par conséquent, Adobe vous recommande de configurer votre site pour qu’il soit PWA une fois que les scripts du projet et les feuilles de style ont été stabilisés.

Réduisez le nombre de variations d’image. minimize-variations

Le composant d’image des composants principaux AEM détermine laquelle des variations doit être utilisée en front-end pour générer le meilleur rendu. Ce mécanisme inclut également un horodatage correspondant à l’heure de la dernière modification de cette ressource. Ce mécanisme complique la configuration PWA mise en cache.

Lors de la configuration du pré-cache, l’utilisateur doit répertorier toutes les variations de chemin pouvant être récupérées. Ces variations comportent des paramètres tels que la qualité et la largeur. Il est conseillé de réduire le nombre de ces variations à un maximum de trois : petit, moyen, grand. Vous pouvez le faire à l’aide de la boîte de dialogue content-policy du composant d’image.

Si les fonctionnalités PWA ne sont pas configurées correctement, la consommation de mémoire et de réseau peut avoir un impact important sur leurs performances. En outre, si vous avez l’intention de prédéfinir, disons, 50 images et d’avoir trois largeurs par image, l’utilisateur qui gère le site doit conserver une liste de 150 entrées au maximum dans la section de pré-mise en cache du PWA des propriétés de la page.

Adobe vous conseille également de configurer votre site pour qu’il active ses fonctionnalités PWA une fois que l’utilisation des images du projet est stable.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab