Een MSIX-pakket maken met MSIX Core op basis van broncode

MSIX Core brengt MSIX-implementatie om eerdere versies van Windows te selecteren. U kunt gebruikmaken van het MSIX Core-installatieprogramma om een toepassing te maken met ClickOnce. Hierdoor kunnen uw gebruikers een setup.exe downloaden en de MSIX-app installeren via het MSIX Core-installatieprogramma.

Uw app hosten op een webserver

Als u uw app wilt voorbereiden op opstarten met het MSIX Core-installatieprogramma, moet u uw app-pakket hosten op een webserver. In deze sectie vindt u informatie over het instellen van een web-app in Azure, Internet Information Services (IIS) en Amazon Web Services (AWS).

Azuur

Als u deze optie wilt gebruiken, moet u een Azure-abonnement hebben. Zie de azure-accountpagina om er een te verkrijgen.

Een Azure-web-app maken

Ga naar de azure-portalpagina en volg deze stappen om aan de slag te gaan:

1. Klik op Een resource maken.
2. Klik op Web en selecteer Web-app.
3. Maak onder Instantiedetails een unieke app-naam en selecteer de juiste instellingen voor uw app. U moet bijvoorbeeld kiezen tussen code of Docker-container en de runtimestack. Anders laat u alle andere standaardwaarden staan.
4. Klik op Maken en voltooi de wizard.

Het app-pakket en de webpagina hosten

1. Nadat u de web-app hebt gemaakt, selecteert u de app.
2. Klik onder Ontwikkelhulpprogramma's op App Service Editor.
3. In de editor is er een standaardbestandhostingstart.html . Klik met de rechtermuisknop in de lege ruimte van Verkenner en selecteer Bestanden Uploaden om te beginnen met het uploaden van uw app-pakketten.
4. Klik met de rechtermuisknop op de lege ruimte van het deelvenster Verkenner en selecteer Nieuw bestand om een nieuw bestand te maken. Geef het bestand een naam op wat u wilt dat uw standaard HTML-pagina is.

De webapplicatie configureren voor MIME-typen van toepassingspakketten

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

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <system.webServer>
    <!--This is to allow the web server to serve resources with the appropriate file extensions-->
    <staticContent>
      <mimeMap fileExtension=".appx" mimeType="application/appx" />
      <mimeMap fileExtension=".msix" mimeType="application/msix" />
    </staticContent>
  </system.webServer>
</configuration>

Internet Information Services (IIS)

IIS is een optionele Windows-functie. IIS installeren:

1. Klik op Start en zoek naar Windows-functies in- of uitschakelen.
2. Selecteer Internet Information Services.
3. Zorg er ook voor dat u ASP.NET 4,5 of hoger installeert. Vouw in het dialoogvenster Windows-onderdelenInternet Information Services ->World Wide Web Services ->Application Development Features uit en selecteer een versie van ASP.NET die groter is dan of gelijk is aan ASP.NET 4.5.
4. Klik op OK om de installatie te starten.

Visual Studio 2017 (of een latere versie) en Web Development Tools zijn vereist. Als u Visual Studio 2017 of een nieuwere versie al hebt geïnstalleerd, controleert u of de ASP.NET- en webontwikkelingsworkloads zijn geïnstalleerd. Anders installeert u Visual Studio vanaf hier.

Een web-app bouwen

Start Visual Studio als beheerder en maak een nieuw Visual C#-webtoepassingsproject met een lege projectsjabloon.

IIS configureren met uw web-app

1. Klik in Solution Explorer met de rechtermuisknop op het hoofdproject en selecteer Eigenschappen.
2. Selecteer het tabblad Web in eigenschappen.
3. Kies in de sectie Serverslokale IIS in de vervolgkeuzelijst en klik op Virtuele map maken.

Het app-pakket toevoegen aan de webtoepassing

Voeg het app-pakket toe dat u wilt distribueren naar de webtoepassing:

1. Klik in Solution Explorer met de rechtermuisknop op het projectknooppunt.
2. Selecteer Add ->New Folder en geef de mappakketten een naam.
3. Als u app-pakketten wilt toevoegen aan de map, klikt u met de rechtermuisknop op de map pakketten en selecteert u Add ->Existing Item. Blader naar de locatie van het app-pakket.

Een webpagina maken

Maak een HTML-pagina of een andere web-app volgens uw behoeften. Voeg de link van uw nieuwe setup.exetoe.

De webapplicatie configureren voor MIME-typen van toepassingspakketten

Open het Web.config-bestand vanuit Solution Explorer en voeg de volgende XML toe in het <configuratie-element> .

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

Amazon Web Services (AWS)

Als u deze optie wilt gebruiken, moet u een AWS-lidmaatschap hebben. Zie aws-accountgegevens voor meer informatie.

Een Amazon S3-bucket maken en uw MSIX-pakketten en webpagina's uploaden

Amazon Simple Storage Service (S3) is een AWS-aanbieding voor het verzamelen, opslaan en analyseren van gegevens. S3-buckets zijn een handige manier om Windows 10-app-pakketten en webpagina's te hosten voor distributie.

1. Meld u aan bij AWS. Zoek S3 onder Services.
2. Selecteer Bucket maken en voer een bucketnaam in voor uw website. Volg de aanwijzingen in het dialoogvenster voor het instellen van eigenschappen en machtigingen. Om ervoor te zorgen dat uw Windows 10-app kan worden gedistribueerd vanaf uw website, schakelt u lees- en schrijfmachtigingen voor uw bucket in en selecteert u Openbare leestoegang verlenen tot deze bucket. Klik op Bucket maken om deze stap te voltooien.
3. Wanneer u klaar bent, uploadt u uw MSIX-pakketten en webpagina's naar de S3-bucket.

De webapplicatie configureren voor MIME-typen van toepassingspakketten

Een webservice-interface zoals S3 browser gebruiken om nieuwe Standaard HTTP Headers toe te voegen.

1. Navigeer naar Extra en selecteer Standaard-HTTP-headers.
2. Klik in het dialoogvenster Standaard-HTTP-headers op Toevoegen.
3. Geef in het dialoogvenster Nieuwe standaard-HTTP-headers toevoegen de bucketnaam, bestandsnaam, headernaam en headerwaarde op en klik vervolgens op Nieuwe header toevoegen.
   • Bucketnaam: msix-packages
   • Bestandsnaam: *.msix
   • Koptekstnaam: Inhoudstype
   • Headerwaarde: toepassing/msix

Het MSIX Core-installatieprogramma gebruiken om de ClickOnce-toepassing te bouwen

Zoek uw toepassing ClickOnce setup.exe. Dit verwijst naar de kloon van het Git-project, bouwt en publiceert het via het Visual Studio-project.

Voer de URL-opdracht uit om nieuwe setup.exe te maken

Zorg ervoor dat u de instructies hebt gevolgd voor het klonen, bouwen en publiceren van de MSIX Core-oplossing in Visual Studio. Ter referentie vindt u het GitHub-project hier

Navigeer naar de map waarin u het setup.exe-bestand hebt gepubliceerd en voer deze opdracht uit:

.\setup.exe -url=<location of your msix in the webservice>

Bijvoorbeeld

.\setup.exe -url="https://appinstallerdemo.azurewebsites.net/MSIXCore/msixmgrWrapper.application?https://appinstallerdemo.azurewebsites.net/MSIXCore/notepadplus.msix#"

De aanvraag ondertekenen

Omdat in de vorige stap een nieuwe setup.exeis gemaakt, moet u de app opnieuw ondertekenen om te controleren of u een vertrouwde uitgever van de toepassing bent en om de integriteit van de toepassing vast te stellen. U kunt de SignTool gebruiken en uw certificaat opgeven.

De toepassing distribueren naar uw gebruikers

U kunt nu naar de nieuwe setup.exe verwijzen door middel van een koppeling of downloadknop op hun website. MSIX Core is gericht op gebruikers in Windows 10, versie 1703 en eerder. Het app-installatieprogramma is het ideale installatieproces voor MSIX-pakketten in Windows 1709 of een latere versie. App Installer optimaliseert voor schijfruimte aan de kant van de consument en kan apps rechtstreeks vanaf HTTP-locaties installeren. MSIX Core detecteert of een consument windows 1709 of een nieuwere versie heeft en stuurt deze om naar app-installatieprogramma.

In Microsoft Edge kunt u de methode getHostEnvironmentValue() aanroepen en het veld os-build in de retourwaarde geeft de versie van het besturingssysteem van de gebruiker op. Vervolgens kunt u het installatieproces vragen om MSIX Core (voor Windows 10, versie 1703 en eerder) of App Installer (voor Windows 10, versie 1709 en hoger) te gebruiken.

Gebruikerservaring

Gebruikers downloaden en voeren de setup.exe uit vanaf de webpagina van de ontwikkelaar.

• Als het MSIX Core-installatieprogramma nog niet is geïnstalleerd wanneer de gebruiker setup.exeuitvoert, ziet de gebruiker de ClickOnce-prompt en klikt hij op Installeren om het MSIX Core-installatieprogramma te installeren. Het installatieprogramma wordt automatisch gestart en toont het installatiescherm voor het MSIX-pakket dat is opgegeven in de queryreeks van de ontwikkelaar, zodat de gebruikers de app kunnen installeren.
• Als het MSIX Core-installatieprogramma al is geïnstalleerd wanneer de gebruiker setup.exeuitvoert, wordt het MSIX Core-installatieprogramma automatisch gestart en wordt het installatiescherm weergegeven voor het MSIX-pakket dat is opgegeven in de queryreeks, zodat gebruikers de app kunnen installeren.