Partager via

Auto-héberger en déployant des canaux en préversion

  • Article

L’auto-hébergement signifie le déploiement d’un runtime WebView2 en préversion avec votre application. Cela vous permet, à vous et à votre équipe de développement, d’utiliser votre application quotidiennement avec la préversion du runtime WebView2, afin de rechercher les problèmes qui affecteront votre application WebView2 particulière, avant que les modifications à venir n’atteignent le runtime Evergreen WebView2 (stable).

L’approche d’auto-hébergement fournit une utilisation réelle de votre application avec la dernière préversion du runtime WebView2 pour détecter les problèmes qui peuvent survenir. Vous devez héberger automatiquement votre application en parallèle avec des tests de préversion sur votre application, afin de fournir une approche structurée pour tester votre application avec la dernière version du runtime WebView2.

Effectuez des tests automatisés et manuels :

  • Pour les tests automatisés, effectuez des tests de préversion, ce qui signifie effectuer des tests avec une préversion du runtime WebView2. Consultez Test de préversion à l’aide de canaux en préversion.
  • Pour les tests manuels, utilisez l’auto-hébergement, ce qui signifie le déploiement d’une préversion du runtime WebView2 avec votre application, à utiliser quotidiennement par votre équipe. Couvert par le présent article.

Comment auto-héberger un canal en préversion de WebView2

Nous vous recommandons de vous auto-héberger à l’aide du runtime WebView2 en préversion dans le canal Dev du navigateur Edge. Le canal de développement est mis à jour chaque semaine. Il vous permet donc d’intercepter les problèmes plus tôt tout en ayant une stabilité suffisante pour une utilisation quotidienne.

Le canal Canary est également adapté, mais il peut être moins stable pour une utilisation quotidienne. Le canal bêta vous permet de tester la version du runtime qui est sur le point d’être livrée à stable, mais vous ne pourrez peut-être pas détecter les problèmes suffisamment tôt pour votre application.

Pour héberger automatiquement un canal en préversion de WebView2 :

  1. Définissez le canal d’aperçu de votre application.

    Vous pouvez définir le canal d’aperçu à l’aide de ChannelSearchKind, de sorte que votre application WebView2 utilise le canal le moins stable sur l’appareil. Nous vous recommandons d’utiliser la clé de Registre ou stratégie de groupe pour l’auto-hébergement.

  2. Installez le canal en préversion sur les machines de votre équipe.

    Pour installer des canaux en préversion sur un petit nombre d’appareils, vous pouvez les télécharger et les installer manuellement à partir de la page Devenir un Microsoft Edge Insider. Pour déployer des canaux en préversion sur un grand nombre d’appareils, consultez Comment déployer des canaux en préversion dans Tester les API et fonctionnalités à venir.

  3. Utilisez votre application quotidiennement avec le canal d’aperçu de WebView2 et diagnostiquez les problèmes potentiels liés au runtime WebView2.

    Consultez Diagnostiquer les problèmes potentiels avec le runtime WebView2, ci-dessous.

Une fois les problèmes détectés, vous pouvez les signaler via le référentiel Microsoft Edge/WebView2Feedback. Sous la Runtime Channel section , veillez à indiquer que vous avez trouvé le problème sur un canal en préversion, afin que le correctif puisse être hiérarchisé avant que le bogue ne soit fourni dans la version stable.

Diagnostiquer les problèmes potentiels avec le runtime WebView2

Pour diagnostiquer ou résoudre les problèmes potentiels liés au runtime WebView2 en préversion qui sont révélés par votre application, procédez comme suit :

Vérifiez que votre application exécute un canal d’aperçu de WebView2

  1. Dans Windows, ouvrez le Gestionnaire des tâches.

  2. Recherchez le processus de votre application, puis recherchez le processus enfant du Gestionnaire WebView2 .

  3. Cliquez avec le bouton droit sur le processus Edge WebView2 , puis sélectionnez Ouvrir l’emplacement du fichier. Le nom du dossier est le numéro de version du runtime.

Basculez vers le canal Runtime WebView2 stable pour voir si le problème est reproduit

Si le problème n’est pas reproduit sur le canal stable du runtime WebView2, il est probable qu’il s’agisse du canal d’aperçu de WebView2 ou de la façon dont votre application interagit avec le canal d’aperçu de WebView2.

Vous pouvez facilement basculer vers le canal stable (Runtime Evergreen WebView2) à l’aide de variables d’environnement, car les variables d’environnement révisées remplacent les paramètres du Registre (qui sont définis par les stratégies de groupe). Cela vous permet de passer facilement d’un canal d’aperçu au canal stable, pour voir si le problème est reproduit. Si vous utilisez déjà des variables d’environnement, il vous suffit de mettre à jour les valeurs.

Si vous définissez la variable d’environnement globalement, le canal WebView2 est modifié pour toutes les applications qui utilisent WebView2 sur l’ordinateur.

Si vous utilisez l’API, nous vous recommandons de créer une interface utilisateur dans votre application qui permet à vos utilisateurs de passer de l’utilisation du runtime stable ou d’un runtime en préversion.

Collecter des données diagnostics

  1. Consultez Collecte de diagnostics et de journaux. Les vidages sur incident et suivis d’événements pour Windows (ETW) sont les formats courants requis.

  2. Vous pouvez ensuite signaler le problème au référentiel Microsoft Edge/WebView2Feedback et inclure le fichier journal.

Voir aussi