Partage via

Distribuer une application Windows 10 à partir d’un serveur IIS

Ce tutoriel montre comment configurer un serveur IIS, vérifier que votre application web peut héberger des packages d’application et appeler et utiliser efficacement le programme d’installation d’application.

L’application Programme d’installation d’application permet aux développeurs et aux professionnels de l’informatique de distribuer des applications Windows 10 en les hébergeant sur leur propre réseau de distribution de contenu (CDN). Cela est utile pour les entreprises qui ne souhaitent pas ou n'ont pas besoin de publier leurs applications sur le Microsoft Store, mais qui souhaitent toujours tirer parti de la plateforme d'empaquetage et de déploiement de Windows 10.

Configuration

Pour suivre correctement ce didacticiel, vous aurez besoin des éléments suivants :

  1. Visual Studio 2017
  2. Outils de développement web et IIS
  3. Windows 10 package d’application - Package d’application que vous allez distribuer

Facultatif : Starter Project sur GitHub. Cela est utile si vous n’avez pas de packages d’application à utiliser, mais souhaitez quand même apprendre à utiliser cette fonctionnalité.

Étape 1 : installer IIS et ASP.NET

Internet Information Services est une fonctionnalité Windows qui peut être installée via le menu Démarrer. Dans le menu Démarrage recherchez les fonctionnalités Turn Windows activées ou désactivées.

Recherchez et sélectionnez Internet Information Services pour installer IIS.

Remarque

Vous n'avez pas besoin de cocher toutes les cases sous Internet Information Services. Seuls les éléments sélectionnés lorsque vous vérifiez Internet Information Services sont suffisants.

Vous devez également installer ASP.NET version 4.5 ou ultérieure. Pour l’installer, recherchez Internet Information Services -> World Wide Web Services -> Fonctionnalités de développement d’applications. Sélectionnez une version de ASP.NET supérieure ou égale à ASP.NET 4.5.

Screenshot d’installation de la fonctionnalité de ASP.NET

Étape 2 - Installer Visual Studio 2017 et les outils de développement web

Install Visual Studio 2017 si vous ne l’avez pas déjà installé. Si vous avez déjà Visual Studio 2017, vérifiez que les charges de travail suivantes sont installées. Si les charges de travail ne sont pas présentes sur votre installation, suivez l’utilisation du programme d’installation Visual Studio (disponible dans le menu Démarrer).

Pendant l’installation, sélectionnez ASP.NET et le développement web et toutes les autres charges de travail qui vous intéressent.

Une fois l’installation terminée, lancez Visual Studio et créez un project (File ->New Project).

Étape 3 - Créer une application web

Lancez Visual Studio 2017 en tant qu'Administrateur et créez un nouveau projet Visual C# Web Application avec un modèle de projet vide.

Capture d’écran de la création d’un projet web

Étape 4 : Configurer IIS avec notre application web

Dans le Explorateur de solutions, cliquez avec le bouton droit sur le projet racine, puis sélectionnez Properties.

Dans les propriétés de l’application web, sélectionnez l’onglet Web . Dans la section Serveurs , choisissez IIS local dans le menu déroulant, puis cliquez sur Créer un répertoire virtuel.

Capture d’écran de l’onglet web dans les propriétés du projet

Étape 5 : Ajouter un package d’application à une application web

Ajoutez le package d’application que vous allez distribuer dans l’application web. Vous pouvez utiliser le package d'application qui fait partie des packages de projet starter fournis sur GitHub si vous n'avez pas de package d'application disponible. Le certificat (MySampleApp.cer) avec lequel le package a été signé est également avec l’exemple sur GitHub. Le certificat doit être installé sur votre appareil avant d’installer l’application (étape 9).

Dans l’application web de projet de démarrage, un nouveau dossier a été ajouté à l’application web appelée packages qui contient les packages d’application à distribuer. Pour créer le dossier dans Visual Studio, cliquez avec le bouton droit sur le nœud du projet dans Explorateur de solutions, sélectionnez Add ->New Folder et nommez-le packages. Pour ajouter des packages d’application au dossier, cliquez avec le bouton droit sur le dossier des packages, puis sélectionnez Ajouter un>élément existant... et accédez à l’emplacement du package d’application.

Capture d’écran de l’ajout d’un package

Étape 6 - Créer une page web

Cet exemple d’application web utilise du code HTML simple. Vous êtes libre de créer votre application web en fonction de vos besoins.

Cliquez avec le bouton droit sur le projet racine de l’Explorateur de solutions, sélectionnez Ajouter un>nouvel élément, puis ajoutez une nouvelle page HTML à partir de la section Web.

Une fois la page HTML créée, cliquez avec le bouton droit sur la page HTML dans le Explorateur de solutions, puis sélectionnez Set As Start Page.

Double-cliquez sur le fichier HTML pour l’ouvrir dans la fenêtre de l’éditeur de code. Dans ce tutoriel, seuls les éléments de la page web requis pour appeler l’application Programme d’installation d’application avec succès pour installer une application Windows 10 seront utilisés.

Incluez le code HTML suivant dans votre page web. La clé permettant d’appeler correctement le programme d’installation d’application consiste à utiliser le schéma personnalisé que le programme d’installation d’application inscrit auprès du système d’exploitation : ms-appinstaller:?source=. Pour plus d’informations, consultez l’exemple de code ci-dessous.

Remarque

Vérifiez que le chemin d’URL spécifié après le schéma personnalisé correspond à l’URL Project sous l’onglet web de votre solution VS.

<html>
<head>
    <meta charset="utf-8" />
    <title> Install Page </title>
</head>
<body>
    <a href="ms-appinstaller:?source=http://localhost/SampleWebApp/packages/MySampleApp.msixbundle"> Install My Sample App</a>
</body>
</html>

Étape 7 : Configurer l’application web pour les types MIME du package d’application

Ouvrez le fichier Web.config à partir de l’Explorateur de solutions et ajoutez les lignes suivantes dans l’élément <configuration> .

<system.webServer>
    <!--This is to allow the web server to serve resources with the appropriate file extension-->
    <staticContent>
      <mimeMap fileExtension=".appx" mimeType="application/appx" />
      <mimeMap fileExtension=".msix" mimeType="application/msix" />
      <mimeMap fileExtension=".appxbundle" mimeType="application/appxbundle" />
      <mimeMap fileExtension=".msixbundle" mimeType="application/msixbundle" />
      <mimeMap fileExtension=".appinstaller" mimeType="application/appinstaller" />
    </staticContent>
</system.webServer>

Remarque

ASP.NET Core n’utilise pas web.config mappages MIME pour le contenu statique. Si votre application d’hébergement est générée avec ASP.NET Core, configurez les types de contenu requis pour .appx, .msix, .appxbundle, .msixbundle et .appinstaller dans l’intergiciel de fichiers statiques, généralement dans la méthode Startup.Configure. Pour plus d’informations, consultez la documentation .NET Core.

Étape 8 : Ajouter une exemption de bouclage pour le programme d’installation d’application

En raison de l’isolation réseau, les applications Windows 10, comme le programme d'installation d'applications, sont limitées à l’utilisation d’adresses de bouclage IP telles que http://localhost/. Lors de l’utilisation du serveur IIS local, le programme d’installation d’application doit être ajouté à la liste exemptée de bouclage.

Pour ce faire, ouvrez l’invite de commandes en tant qu’administrateur et entrez les éléments suivants :

CheckNetIsolation.exe LoopbackExempt -a -n=microsoft.desktopappinstaller_8wekyb3d8bbwe

Pour vérifier que l’application est ajoutée à la liste exemptée, utilisez la commande suivante pour afficher les applications dans la liste exemptée de bouclage :

CheckNetIsolation.exe LoopbackExempt -s

Vous devez trouver microsoft.desktopappinstaller_8wekyb3d8bbwe dans la liste.

Une fois que la validation locale de l’installation de l’application via le programme d’installation d’application est terminée, vous pouvez supprimer l’exemption de bouclage que vous avez ajoutée à cette étape :

CheckNetIsolation.exe LoopbackExempt -d -n=microsoft.desktopappinstaller_8wekyb3d8bbwe

Étape 9 : Exécuter l’application web

Générez et exécutez l’application web en cliquant sur le bouton Exécuter sur le ruban VS, comme illustré dans l’image ci-dessous :

Screenshot de l’exécution d’une application web dans Visual Studio

Une page web s’ouvre dans votre navigateur :

Capture d’écran de l’installation de l’application à partir de la page web

Cliquez sur le lien dans la page web pour lancer l’application Programme d’installation d’application et installer votre package d’application Windows 10.

Résolution des problèmes

Privilège insuffisant

Si l’exécution de l’application web dans Visual Studio affiche une erreur telle que « Vous n’avez pas suffisamment de privilèges pour accéder aux sites web IIS sur votre ordinateur », vous devez exécuter Visual Studio en tant qu’administrateur. Fermez l’instance actuelle de Visual Studio et rouvrez-la en tant qu’administrateur.

Configurer la page d’accueil

Si l’exécution de l’application web entraîne le chargement du navigateur avec une erreur HTTP 403.14 - Interdit, cela est dû au fait que l’application web n’a pas de page de démarrage définie. Reportez-vous à l’étape 6 de ce tutoriel pour savoir comment définir une page de démarrage.

  • Last updated on