Een Windows-app distribueren vanuit een Azure-web-app

Waarschuwing

Het ms-appinstaller: URI-protocol dat in deze zelfstudies voor webinstallatie wordt gebruikt, is standaard uitgeschakeld vanaf december 2023. Gebruikers op de meeste apparaten kunnen het via de browser geactiveerde installatieproces niet gebruiken. Voor een brede distributie, publiceer in de Microsoft Store. Zie Windows-apps installeren vanaf een webpagina voor door ondernemingen beheerde apparaten, waar IT het protocol opnieuw kan inschakelen via Groepsbeleid.

Met de app-installatieprogramma kunnen ontwikkelaars en IT-professionals Windows apps distribueren door ze te hosten op hun eigen CDN (Content Delivery Network). Dit is handig voor ondernemingen die hun apps niet willen of publiceren naar de Microsoft Store, maar toch willen profiteren van het Windows pakket- en implementatieplatform.

In dit onderwerp worden de stappen beschreven voor het configureren van een Azure Webserver voor het hosten van Windows app-pakketten en het gebruik van de app-installatie-app om de app-pakketten te installeren.

In deze zelfstudie gaan we een IIS-server instellen om lokaal te controleren of uw webtoepassing de app-pakketten correct kan hosten en app-installatieprogramma effectief kan aanroepen en gebruiken. We hebben ook zelfstudies voor het correct hosten van uw webtoepassingen op de populaire cloudwebservices in het veld (Azure en AWS) om ervoor te zorgen dat ze voldoen aan de webinstallatievereisten voor App Installer. Deze stapsgewijze zelfstudie vereist geen expertise en is heel eenvoudig te volgen.

Configuratie

Als u deze zelfstudie wilt volgen, hebt u het volgende nodig:

  1. Microsoft Azure-abonnement
  2. Windows 10 app-pakket: het app-pakket dat u distribueert

Optioneel: Starter Project op GitHub. Dit is handig als u geen app-pakket of webpagina gebruikt om mee te werken, maar nog steeds wilt weten hoe u deze functie gebruikt.

Stap 1: een Azure-abonnement ophalen

Ga naar de Azure-accountpagina om een Azure-abonnement op te halen. Voor deze zelfstudie kunt u een gratis lidmaatschap gebruiken.

Stap 2: een Azure-web-app maken

Klik op de Azure portalpagina op de knop + Een resource maken en selecteer vervolgens Web-app

Scherm van het maken van een Azure-app

Maak een unieke app-naam en laat de rest van de velden standaard staan. Klik op Maken om de Web App-wizard te voltooien.

Schermopname van het maken van een web-app

Stap 3: het app-pakket en de webpagina hosten

Zodra de web-app is gemaakt, kunt u deze openen vanuit het dashboard in de Azure-portal. In deze stap gaan we een eenvoudige webpagina maken met de GUI van de Azure-portal.

Nadat u de zojuist gemaakte web-app hebt geselecteerd op het dashboard, gebruikt u het zoekveld om App Service-editor te zoeken en te openen.

In de editor is er een standaardbestand hostingstart.html . Klik met de rechtermuisknop in de lege ruimte van het Verkenner-venster en selecteer Bestanden uploaden om te beginnen met het uploaden van uw app-pakketten.

Opmerking

U kunt het app-pakket gebruiken dat deel uitmaakt van de opgegeven Starter Project opslagplaats op GitHub als u geen app-pakket beschikbaar hebt. Het certificaat (MySampleApp.cer) waarmee het pakket is ondertekend, is ook bij het voorbeeld op GitHub. U moet het certificaat op uw apparaat hebben geïnstalleerd voordat u de app installeert.

Schermopname van het uploaden van pakketten

Klik met de rechtermuisknop in de lege ruimte van het deelvenster Verkenner en selecteer Nieuwe bestanden om een nieuw bestand te maken. Geef het bestand de naam: default.html.

Als u het app-pakket gebruikt dat is opgegeven in de Starter Project, kopieert u de volgende HTML-code naar de nieuwe webpagina default.html. Als u uw eigen app-pakket gebruikt, wijzigt u de URL van de app-service (de URL erna source=). U kunt de URL van de app-service ophalen op de overzichtspagina van uw app in de Azure-portal.

<html>
<head>
    <meta charset="utf-8" />
    <title> Install My Sample App</title>
</head>
<body>
    <a href="ms-appinstaller:?source=https://appinstaller-azure-demo.azurewebsites.net/MySampleApp.msixbundle"> Install My Sample App</a>
</body>
</html>

Stap 4: de webapp configureren voor MIME-typen voor app-pakketten

Voeg een nieuw bestand toe aan de web-app met de naam: Web.config. Open het Web.config bestand vanuit de verkenner en voeg de volgende regels toe.

<?xml version="1.0" encoding="utf-8"?>
<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>
</configuration>

Stap 5: Uitvoeren en testen

Als u de webpagina wilt starten die u hebt gemaakt, gebruikt u de URL van stap 3 in de browser, gevolgd door /default.html.

Schermopname van het installeren van app vanaf webpagina

Klik op Mijn voorbeeld-app installeren om het app-installatieprogramma te starten en uw app-pakket te installeren.

Problemen met de foutopsporing

App Installer-app kan niet worden geïnstalleerd

De installatie van de app mislukt als het certificaat waarmee het app-pakket is ondertekend, niet op het apparaat is geïnstalleerd. U kunt dit oplossen door het certificaat te installeren vóór de installatie van de app. Als u een app-pakket host voor openbare distributie, raden we u aan uw app-pakket te ondertekenen met een certificaat van een certificeringsinstantie.

Schermopname van certificeringsfout

Zorg ervoor dat de app App Installer is geïnstalleerd. Ga naar Instellingen ->Apps & Functies en zoek het app-installatieprogramma in de lijst met geïnstalleerde apps.

  • Last updated on