Verteilen einer Windows-App von einem IIS-Server

Warnung

Das ms-appinstaller: in diesen Webinstallationslernprogrammen verwendete URI-Protokoll ist ab Dezember 2023 standardmäßig deaktiviert. Benutzer auf den meisten Geräten können den vom Browser ausgelösten Installationsfluss mit nur einem Klick nicht verwenden. veröffentlichen Sie sie stattdessen im Microsoft Store. Informationen zu unternehmensverwalteten Geräten, auf denen die IT das Protokoll über Gruppenrichtlinien erneut aktivieren kann, finden Sie unter Installing Windows Apps von einer Webseite.

In diesem Lernprogramm wird veranschaulicht, wie Sie einen IIS-Server einrichten, überprüfen, ob Ihre Web-App App-Pakete hosten und App-Installer effektiv aufrufen und verwenden kann.

Mit der App Installer-App können Entwickler und IT-Spezialisten Windows 10 Apps verteilen, indem sie sie in ihrem eigenen Content Delivery Network (CDN) hosten. Dies ist nützlich für Unternehmen, die ihre Apps nicht für die Microsoft Store veröffentlichen möchten oder müssen, aber dennoch die Windows 10 Verpackungs- und Bereitstellungsplattform nutzen möchten.

Konfiguration

Um dieses Lernprogramm erfolgreich durchzugehen, benötigen Sie Folgendes:

1. Visual Studio 2017
2. Webentwicklungstools und IIS
3. Windows 10 App-Paket – Das App-Paket, das Sie verteilen möchten

Optional: Starter Project auf GitHub. Dies ist hilfreich, wenn Sie nicht über App-Pakete verfügen, mit denen Sie arbeiten können, aber dennoch erfahren möchten, wie Sie dieses Feature verwenden.

Schritt 1: Installieren von IIS und ASP.NET

Internetinformationsdienste ist ein Windows Feature, das über das Startmenü installiert werden kann. Suchen Sie im menü Start nach Turn Windows Features ein- oder aus.

Suchen Und wählen Sie Internetinformationsdienste aus, um IIS zu installieren.

Hinweis

Sie müssen nicht alle Kontrollkästchen unter Internetinformationsdienste aktivieren. Nur die ausgewählten Optionen, wenn Sie Internetinformationsdienste auswählen, sind ausreichend.

Außerdem müssen Sie ASP.NET 4.5 oder höher installieren. Um es zu installieren, öffnen Sie Internetinformationsdienste -> World Wide Web Services -> Application Development Features. Wählen Sie eine Version von ASP.NET aus, die größer oder gleich ASP.NET 4.5 ist.

Schritt 2 : Installieren von Visual Studio 2017- und Webentwicklungstools

Install Visual Studio 2017 wenn Sie es noch nicht installiert haben. Wenn Sie bereits über Visual Studio 2017 verfügen, stellen Sie sicher, dass die folgenden Workloads installiert sind. Wenn die Arbeitslasten in Ihrer Installation nicht vorhanden sind, folgen Sie den Anweisungen im Visual Studio Installer (im Startmenü zu finden).

Wählen Sie während der Installation ASP.NET und Webentwicklung und alle anderen Workloads aus, die Sie interessieren.

Starten Sie nach Abschluss der Installation Visual Studio, und erstellen Sie ein neues Projekt (Datei ->Neues Projekt).

Schritt 3 : Erstellen einer Web-App

Starten Sie Visual Studio 2017 als Administrator, und erstellen Sie eine neue Visual C#-Webanwendung Projekt mit einer empty Projektvorlage.

Schritt 4 : Konfigurieren von IIS mit unserer Web App

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Stammprojekt, und wählen Sie Properties aus.

Wählen Sie in den Web-App-Eigenschaften die Registerkarte "Web " aus. Wählen Sie im Abschnitt "Server " im Dropdownmenü " Lokales IIS " aus, und klicken Sie auf "Virtuelles Verzeichnis erstellen".

Schritt 5 : Hinzufügen eines App-Pakets zu einer Webanwendung

Fügen Sie das App-Paket hinzu, das Sie in die Webanwendung verteilen möchten. Sie können das App-Paket verwenden, das Teil der bereitgestellten starter-Projektpakete auf GitHub ist, wenn kein App-Paket verfügbar ist. Das Zertifikat (MySampleApp.cer), mit dem das Paket signiert wurde, ist ebenfalls zusammen mit dem Beispiel auf GitHub verfügbar. Sie müssen das Zertifikat vor der Installation der App (Schritt 9) auf Ihrem Gerät installiert haben.

In der Startprojektwebanwendung wurde der Web-App ein neuer Ordner hinzugefügt, der als Pakete bezeichnet wird, die die zu verteilenden App-Pakete enthalten. Um den Ordner in Visual Studio zu erstellen, klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf den Projektknoten, wählen Sie Add ->New Folder aus, und nennen Sie ihn packages. Wenn Sie dem Ordner App-Pakete hinzufügen möchten, klicken Sie mit der rechten Maustaste auf den Ordner "Pakete", und wählen Sie "Vorhandenes Element hinzufügen>" aus, und navigieren Sie zum Speicherort des App-Pakets.

Schritt 6 – Erstellen einer Webseite

In dieser Beispielweb-App wird einfacher HTML-Code verwendet. Sie können Ihre Web-App nach Bedarf erstellen.

Klicken Sie mit der rechten Maustaste auf das Stammprojekt des Projektmappen-Explorer, wählen Sie Hinzufügen ->Neues Element, und fügen Sie eine neue HTML-Seite aus dem Web-Abschnitt hinzu.

Klicken Sie nach dem Erstellen der HTML-Seite im Projektmappen-Explorer mit der rechten Maustaste auf die HTML-Seite, und wählen Sie Set As Start Page aus.

Doppelklicken Sie auf die HTML-Datei, um sie im Code-Editor-Fenster zu öffnen. In diesem Lernprogramm werden nur die auf der Webseite benötigten Elemente verwendet, um die App-Installer-Anwendung erfolgreich zu starten und eine Windows 10 App zu installieren.

Fügen Sie den folgenden HTML-Code in Ihre Webseite ein. Der Schlüssel zum erfolgreichen Aufrufen des App-Installers besteht darin, das benutzerdefinierte Schema zu verwenden, das das App-Installationsprogramm mit dem Betriebssystem registriert: ms-appinstaller:?source=. Weitere Informationen finden Sie im folgenden Codebeispiel.

Hinweis

Stellen Sie sicher, dass der nach dem benutzerdefinierten Schema angegebene URL-Pfad mit der Projekt-URL im Webtab Ihrer VS-Lösung übereinstimmt.

<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>

Schritt 7 : Konfigurieren der Web-App für MIME-Typen des App-Pakets

Öffnen Sie die DateiWeb.config aus dem Lösungsexplorer und fügen Sie die folgenden Zeilen innerhalb des <configuration> Elements hinzu.

<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>

Hinweis

ASP.NET Core verwendet nicht web.config MIME-Zuordnungen für statische Inhalte. Wenn Ihre Hosting-App mit ASP.NET Core erstellt wird, konfigurieren Sie die erforderlichen Inhaltstypen für .appx, .msix, .appxbundle, .msixbundle und .appinstaller in der statischen Datei-Middleware, in der Regel in der methode Startup.Configure. Weitere Informationen finden Sie in der .NET Core-Dokumentation.

Schritt 8: Hinzufügen von Loopback-Ausnahmen für das App-Installationsprogramm

Aufgrund der Netzwerkisolation sind Windows 10 Apps wie App Installer auf die Verwendung von IP-Loopbackadressen wie http://localhost/. beschränkt. Wenn Sie lokalen IIS-Server verwenden, muss das App-Installationsprogramm der Loopback-Ausnahmeliste hinzugefügt werden.

Öffnen Sie dazu die Eingabeaufforderung als Administrator , und geben Sie Folgendes ein:

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

Um zu überprüfen, ob die App zur Liste der Ausgenommenen hinzugefügt wird, verwenden Sie den folgenden Befehl, um die Apps in der Loopback-Ausnahmeliste anzuzeigen:

CheckNetIsolation.exe LoopbackExempt -s

Sie sollten microsoft.desktopappinstaller_8wekyb3d8bbwe in der Liste finden.

Sobald die lokale Überprüfung der App-Installation über das App-Installationsprogramm abgeschlossen ist, können Sie die Loopbackausnahme entfernen, die Sie in diesem Schritt hinzugefügt haben:

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

Schritt 9 : Ausführen der Web-App

Erstellen Sie die Webanwendung, und führen Sie sie aus, indem Sie auf die Schaltfläche "Ausführen" im VS-Menüband klicken, wie in der abbildung unten dargestellt:

Eine Webseite wird in Ihrem Browser geöffnet:

Klicken Sie auf den Link auf der Webseite, um die App-Installer-App zu starten und Ihr Windows 10 App-Paket zu installieren.

Probleme bei der Fehlerbehebung

Nicht ausreichende Berechtigungen

Wenn die Web-App in Visual Studio einen Fehler anzeigt, z. B. "Sie verfügen nicht über ausreichende Berechtigungen für den Zugriff auf IIS-Websites auf Ihrem Computer", müssen Sie Visual Studio als Administrator ausführen. Schließen Sie die aktuelle Instanz von Visual Studio, und öffnen Sie sie als Administrator erneut.

Startseite festlegen

Wenn die Web-App ausgeführt wird, wird der Browser mit einem HTTP 403.14 - Forbidden-Fehler geladen, weil die Web-App keine definierte Startseite hat. In diesem Lernprogramm erfahren Sie in Schritt 6, wie Sie eine Startseite definieren.