Auto-hôte en déployant des canaux d’aperçu

L’auto-hébergement consiste à déployer un runtime de prévisualisation WebView2 avec votre application. Cela vous permet, à vous et à votre équipe de développement, d’utiliser votre application quotidiennement avec un runtime de prévisualisation 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 le dernier runtime de prévisualisation WebView2 pour détecter tout problème qui peut survenir. Vous devez auto-héberger votre application en parallèle avec la réalisation de tests préliminaires sur votre application, afin de fournir une approche structurée du test de 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 préliminaires, c’est-à-dire des tests avec un runtime de préversion WebView2. Consultez Test de préversion à l’aide des canaux d’aperçu de Microsoft Edge.
  • Pour les tests manuels, utilisez l’auto-hébergement, ce qui signifie le déploiement d’un runtime de prévisualisation WebView2 avec votre application, à utiliser quotidiennement par votre équipe. Couvert par le présent article.

Comment auto-héberger un canal d’aperçu de WebView2

Nous vous recommandons de vous auto-héberger à l’aide du WebView2 Preview Runtime dans le canal Dev du navigateur Edge. Le canal Dev est mis à jour chaque semaine, ce qui vous permet de détecter les problèmes tôt tout en ayant une stabilité suffisante pour une utilisation quotidienne.

Le canal Canary convient également, 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 mise à niveau ; toutefois, vous risquez de ne pas pouvoir détecter les problèmes suffisamment tôt pour votre application.

Pour auto-héberger un canal d’aperçu de WebView2 :

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

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

  2. Installez le canal d’aperçu sur les ordinateurs de votre équipe.

    Pour installer des canaux d’aperçu 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 de préversion sur un grand nombre d’appareils, consultez Comment déployer des canaux de préversion dans Basculer vers un canal de préversion pour 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 avec le runtime WebView2.

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

Lorsque des problèmes sont trouvés, vous pouvez les signaler via le dépôt Microsoft Edge/WebView2Feedback. Sous la Runtime Channel section, veillez à indiquer que vous avez trouvé le problème sur un canal d’aperçu, afin que le correctif puisse être hiérarchisé avant que le bogue ne soit inclus dans la version stable.

Diagnostiquer les problèmes potentiels avec le runtime WebView2

Pour diagnostiquer ou résoudre les problèmes potentiels du WebView2 Preview Runtime 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 WebView2 Manager .

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

Basculez vers le canal stable WebView2 Runtime 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 que le problème provienne 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 (Evergreen WebView2 Runtime) à 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, elle modifie le canal WebView2 pour toutes les applications qui utilisent WebView2 sur la machine.

Si vous utilisez l’API, nous vous recommandons de créer une interface utilisateur dans votre application qui permet à vos utilisateurs de basculer entre l’utilisation du runtime stable WebView2 et d’un runtime WebView2 Preview.

Collecter des données de diagnostics

  1. Voir Collecte des diagnostics et des journaux. Les vidages sur incident et les 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

Externe :