Erstellen eines MSIX-Pakets mit MSIX Core aus QuellcodeCreate an MSIX package with MSIX Core from source code

Msix Core sorgt für die Bereitstellung von msix, um frühere Versionen von Windows auszuwählen.MSIX Core brings MSIX deployment to select previous versions of Windows. Sie können das msix Core-Installationsprogramm zum Erstellen einer Anwendung mithilfe von ClickOnce nutzen.You can leverage the MSIX Core installer to create an application using ClickOnce. Dadurch können Ihre Benutzer eine setup.exe herunterladen und die msix-App über den msix Core-Installer installieren.This will allow your users to download a setup.exe and install the MSIX app through the MSIX Core installer.

Hosten der APP auf einem WebserverHost your app on a web server

Um Ihre APP für das Bootstrapping mit dem msix Core-Installer bereit zu machen, müssen Sie das App-Paket auf einem Webserver hosten.To get your app ready for bootstrapping with the MSIX Core installer, you’ll need to host your app package on a web server. Dieser Abschnitt enthält ausführliche Informationen zum Einrichten einer Web-App in Azure, Internetinformationsdienste (IIS)und Amazon Web Services (AWS).This section provides details about how to set up a web app on Azure, Internet Information Services (IIS), and Amazon Web Services (AWS).

AzureAzure

Um diese Option verwenden zu können, müssen Sie über ein Azure-Abonnement verfügen.To use this option you must have an Azure subscription. Informationen hierzu finden Sie auf der Seite Azure-Konto.To obtain one, see the Azure account page.

Erstellen einer Azure-Web-AppCreate an Azure Web App

Wechseln Sie zunächst zur Seite Azure-Portal , und führen Sie die folgenden Schritte aus:To get started go to the Azure portal page and follow these steps:

  1. Klicken Sie auf Ressource erstellen.Click Create a Resource.
  2. Klicken Sie auf Web , und wählen Sie Web-App.Click Web and select Web App.
  3. Erstellen Sie unter Instanzdetailseinen eindeutigen APP-Namen, und wählen Sie die entsprechenden Einstellungen für die APP aus.Under Instance Details, create a unique app name and select the appropriate settings for your app. Beispielsweise müssen Sie zwischen dem Code oder dem docker-Container und dem Lauf Zeit Stapelwählen.For example, you will need to choose between Code or Docker Container and the Runtime Stack. Andernfalls sollten Sie alle anderen Standardeinstellungen belassen.Otherwise, leave everything else default.
  4. Klicken Sie auf Erstellen , und beenden Sie den Assistenten.Click Create and finish the wizard.

Hosten des App-Pakets und der WebseiteHost the app package and the web page

  1. Nachdem Sie die Web-App erstellt haben, wählen Sie die APP aus.After you create the web app, select the app.
  2. Klicken Sie unter Entwicklungs Toolsauf App Service-Editor.Under Development Tools, click App Service Editor.
  3. Im Editor gibt es eine standardmäßige hostingstart.html -Datei.In the editor, there is a default hostingstart.html file. Klicken Sie mit der rechten Maustaste in den leeren Bereich des Datei-Explorers, und wählen Sie Dateien hochladen , um mit dem Hochladen der APP-PaketeRight-click in the empty space of File Explorer and select Upload Files to begin uploading your app packages.
  4. Klicken Sie mit der rechten Maustaste auf den leeren Bereich des Bereichs "Datei-Explorer", und wählen Sie neue Dateien aus, um eine neue Datei zu erstellen.Right-click in the empty space of the File Explorer panel again and select New Files to create a new file. Benennen Sie die Datei mit der standardmäßigen HTML-Seite.Name the file what you want your default HTML page to be.

Konfigurieren der Web-App für App-Paket-MIME-TypenConfigure the web app for app package MIME types

Fügen Sie der Web-App eine neue Datei mit dem Namen Web.config hinzu.Add a new file named Web.config to the web app. Öffnen Sie die Datei Web.config, und fügen Sie der Datei den folgenden XML-Code hinzu.Open the Web.config file and add the following XML to the file.

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

Internetinformationsdienste (IIS)Internet Information Services (IIS)

IIS ist ein optionales Windows-Feature.IIS is an optional Windows feature. So installieren Sie IIS:To install IIS:

  1. Klicken Sie auf Start , und suchen Sie nach Windows-Funktionen aktivieren oder deaktivieren.Click Start and search for Turn Windows features on or off.
  2. Wählen Sie Internetinformationsdiensteaus.Select Internet Information Services.
  3. Stellen Sie außerdem sicher, dass Sie ASP.NET 4,5 oder höher installieren.Also make sure you install ASP.NET 4.5 or greater. Erweitern Sie im Dialogfeld Windows-Features den Eintrag Internetinformationsdienste -> World Wide Web Dienste -> Anwendungs Entwicklungs Features, und wählen Sie eine Version von ASP.net aus, die größer oder gleich ASP.NET 4,5ist.In the Windows Features dialog, expand Internet Information Services -> World Wide Web Services -> Application Development Features, and select a version of ASP.NET that is greater than or equal to ASP.NET 4.5.
  4. Klicken Sie auf OK , um mit der Installation zu beginnen.Click OK to begin the installation.

Visual Studio 2017 (oder eine höhere Version) und Webentwicklungs Tools sind erforderlich.Visual Studio 2017 (or a later version) and Web Development Tools are required. Wenn Sie Visual Studio 2017 oder eine neuere Version bereits installiert haben, stellen Sie sicher, dass die Workloads ASP.net und Webentwicklung installiert sind.If you already have Visual Studio 2017 or a later version installed, make sure you have the ASP.NET and Web development workloads installed. Installieren Sie andernfalls Visual Studio von hier.Otherwise, install Visual Studio from here.

Erstellen einer Web-AppBuild a web app

Starten Sie Visual Studio als Administrator, und erstellen Sie ein neues Visual c#-Webanwendungs Projekt mit einer leeren Projektvorlage.Start Visual Studio as an administrator and create a new Visual C# Web Application project with an empty project template.

Konfigurieren von IIS mit Ihrer Web-AppConfigure IIS with your Web app

  1. Klicken Sie in Projektmappen-Explorermit der rechten Maustaste auf das Stamm Projekt, und wählen Sie Eigenschaftenaus.In Solution Explorer, right-click on the root project and select Properties.
  2. Wählen Sie unter Eigenschaften die Registerkarte Web aus.In properties, select the Web tab.
  3. Wählen Sie im Abschnitt Server im Dropdown Menü die Option local IIS aus, und klicken Sie auf virtuelles Verzeichnis erstellen.In the Servers section, choose Local IIS from the dropdown menu and click Create Virtual Directory.

Hinzufügen des App-Pakets zur WebanwendungAdd the app package to the web application

Fügen Sie das App-Paket, das Sie an die-Webanwendung verteilen möchten, hinzu:Add the app package that you want to distribute to the web application:

  1. Klicken Sie in Projektmappen-Explorermit der rechten Maustaste auf den Projekt Knoten.In Solution Explorer, right-click the project node.
  2. Wählen Sie neuen Ordner Hinzufügenaus, -> New Folder und benennen Sie den Ordner Pakete.Select Add -> New Folder and name the folder packages.
  3. Um dem Ordner App-Pakete hinzuzufügen, klicken Sie mit der rechten Maustaste auf Addden Ordner Pakete, und wählen Sie -> Vorhandenes ElementhinzufügenTo add app packages to the folder, right-click the packages folder and select Add -> Existing Item. Navigieren Sie zum Speicherort des App-Pakets.Browse to the app package location.

Erstellen einer WebseiteCreate a web page

Erstellen Sie je nach Bedarf eine HTML-Seite oder eine beliebige andere Web-App.Create an HTML page or any other web app as required per your needs. Fügen Sie den Link Ihres neuen setup.exe hinzu.Add the link of your new setup.exe.

Konfigurieren der Web-App für App-Paket-MIME-TypenConfigure the web app for app package MIME types

Öffnen Sie die Datei Web.config im Projektmappen-Explorer, und fügen Sie im-Element den folgenden XML-Code hinzu Open the Web.config file from the solution explorer and add the following XML within the 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)Amazon Web Services (AWS)

Um diese Option verwenden zu können, müssen Sie über eine AWS-Mitgliedschaft verfügen.To use this option you must have an AWS membership. Weitere Informationen finden Sie unter AWS-Konto Details.For more information, see AWS account details.

Erstellen eines Amazon S3-Bucket und Hochladen von msix-Paketen und-WebseitenCreate an Amazon S3 bucket and upload your MSIX packages and web pages

Amazon Simple Storage Service (S3) ist ein AWS-Angebot zum erfassen, speichern und Analysieren von Daten.Amazon Simple Storage Service (S3) is an AWS offering for collecting, storing and analyzing data. S3-Bucket sind eine bequeme Möglichkeit zum Hosten von Windows 10-App-Paketen und-Webseiten für die Verteilung.S3 buckets are a convenient way to host Windows 10 app packages and web pages for distribution.

  1. Melden Sie sich bei AWS an.Log in to AWS. Klicken Sie unter Dienste auf S3suchen.Under Services find S3.
  2. Wählen Sie Bucket erstellen aus, und geben Sie einen Bucket-Namen für Ihre Website ein.Select Create bucket and enter a Bucket name for your website. Befolgen Sie die Anweisungen im Dialogfeld, um Eigenschaften und Berechtigungen festzulegen.Follow the dialog prompts for setting properties and permissions. Um sicherzustellen, dass Ihre Windows 10-APP von Ihrer Website verteilt werden kann, aktivieren Sie die Lese -und Schreib Berechtigungen für Ihren Bucket, und wählen Sie öffentlichen Lesezugriff auf diesen Bucket gewährenaus.To ensure that your Windows 10 app can be distributed from your website, enable Read and Write permissions for your bucket and select Grant public read access to this bucket. Klicken Sie auf Bucket erstellen , um diesen Schritt abzuschließen.Click Create bucket to finish this step.
  3. Wenn Sie fertig sind, laden Sie Ihre msix-Pakete und Webseiten in den Bucket S3 hoch.When you are finished, upload your MSIX packages and web pages to the S3 bucket.

Konfigurieren der Web-App für App-Paket-MIME-TypenConfigure the web app for app package MIME types

Verwenden einer Webdienst Schnittstelle wie S3-Browser   zum Hinzufügen neuer http-Standard Header.Using a web service interface like S3 browser to add a new Default HTTP Headers.

  1. Navigieren Sie zu Extras, und wählen Sie http-Standard Headeraus.Navigate to Tools and select Default HTTP Headers.
  2. Klicken Sie im Dialogfeld Standard-HTTP-Header auf Hinzufügen.In the Default HTTP Headers dialog, click Add.
  3. Geben Sie im Dialogfeld neue Standard-HTTP-Header hinzufügen den Bucket-Namen, den Dateinamen, den Header Namen und den Header Wert an, und klicken Sie dann auf neuen Header hinzufügen.In the Add New Default HTTP Headers dialog, specify the bucket name, file name, header name, and header value, and then click Add new header.
    • Bucket-Name: msix-PaketeBucket name: msix-packages
    • Dateiname: *. msixFile name: *.msix
    • Header Name: Content-TypeHeader name: Content-Type
    • Header Wert: Anwendung/msixHeader value: application/msix

Hinweis

 AWS hat einige strenge Richtlinien, die Sie befolgen müssen. AWS have some strict guidelines you will have to follow. Beispielsweise müssen Bucket-Namen eindeutig sein. Wenn Sie also das obige Beispiel verwenden, müssen Sie den Bucket-Namen ändern.For example, Bucket names are required to be unique and therefore if you are using the example above, you will need to change the Bucket name.

Verwenden des msix Core-Installers zum Erstellen der ClickOnce-AnwendungUse the MSIX Core installer to build the ClickOnce application

Suchen Sie nach ihrer Anwendungs Anwendung ClickOnce-setup.exe.Find your application application ClickOnce setup.exe.

Befehl "URL ausführen" zum Erstellen neuer setup.exeRun URL command to create new setup.exe

Stellen Sie sicher, dass Sie die Anweisungen zum Klonen, erstellen und Veröffentlichen der msix Core-Lösung in Visual Studio befolgt haben.Make sure you have followed the instructions to clone, build and publish the MSIX Core solution in Visual Studio.

Navigieren Sie zu dem Verzeichnis, in das Sie die setup.exe Datei heruntergeladen haben, und führen Sie diesen Befehl aus:Navigate to the directory where you downloaded the setup.exe file and then run this command:

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

Signieren der AnwendungSign the application

Da im vorherigen Schritt eine neue setup.exe erstellt wurde, müssen Sie die APP erneut signieren, um sicherzustellen, dass Sie ein vertrauenswürdiger Herausgeber der Anwendung sind und die Integrität der Anwendung festlegen.Because the previous step created a new setup.exe, you will need to sign the app again to verify that you're a trusted publisher of the application and to establish the integrity of the application. Sie können das SignTool verwenden und Ihr Zertifikat bereitstellen.You can use the SignTool and provide your certificate.

Verteilen der Anwendung an Ihre BenutzerDistribute the application to your users

Nun können Sie auf der Website auf den neuen setup.exe mit einer Link-oder Download-Schaltfläche zeigen.You can now point to the new setup.exe with a link or download button on their website. Msix Core ist für Benutzer unter Windows 10, Version 1703 und früher konzipiert.MSIX Core is targeted towards users on Windows 10, version 1703 and earlier. Das App-Installations Programm ist der ideale Installationsvorgang für msix-Pakete unter Windows 1709 oder einer höheren Version.The App Installer is the ideal installation process for MSIX packages on Windows 1709 or a later version. Der APP-Installer optimiert den Speicherplatz auf der consumerseite und kann apps direkt von HTTP-Speicherorten installieren.App Installer optimizes for disk space on the consumer side and can directly install apps from HTTP locations. Msix Core erkennt, ob ein Consumer Windows 1709 oder eine höhere Version verwendet, und leitet Sie an das App-Installationsprogramm weiter.MSIX Core will detect if a consumer is on Windows 1709 or a later version and redirect them to App Installer.

Bei Microsoft Edge können Sie die gethostumgebvalue () -Methode aufrufen, und im Feld " OS-Build " im Rückgabewert wird die Betriebssystemversion des Benutzers angegeben.On Microsoft Edge, you can call the getHostEnvironmentValue() method and the os-build field in the return value will specify the OS version of the user. Von dort aus können Sie den Installationsvorgang auffordern, den msix-Kern (für Windows 10, Version 1703 und früher) oder den APP-Installer (für Windows 10, Version 1709 und höher) zu verwenden.From there, you can then prompt the installation process to use MSIX Core (for Windows 10, version 1703 and earlier) or App Installer (for Windows 10, version 1709 and later).

BenutzererfahrungUser experience

Benutzer laden die setup.exe einfach auf der Webseite des Entwicklers herunter und führen Sie aus.Users simply download and run the setup.exe from the developer’s webpage.

  • Wenn der msix Core-Installer noch nicht installiert ist, wenn der Benutzer setup.exe ausführt, wird dem Benutzer die ClickOnce-Eingabeaufforderung angezeigt, und Sie klicken auf Installieren , um den msix Core-Installer zu installieren.If the MSIX Core installer is not yet installed when the user runs setup.exe, the user sees the ClickOnce prompt and they click Install to install the MSIX Core installer. Das Installationsprogramm wird automatisch gestartet, und der Installationsbildschirm für das in der Abfrage Zeichenfolge des Entwicklers angegebene msix-Paket wird angezeigt, sodass die Benutzer die APP installieren können.The installer automatically launches and shows the install screen for the MSIX package specified in the developer’s query string so the users can install the app.
  • Wenn der msix Core-Installer bereits installiert ist, wenn der Benutzer setup.exe ausführt, wird der msix Core-Installer automatisch gestartet und zeigt den Installationsbildschirm für das msix-Paket an, das in der Abfrage Zeichenfolge für Benutzer zum Installieren der APP angegeben ist.If the MSIX Core installer is already installed when the user runs setup.exe, the MSIX Core installer automatically launches and shows the install screen for the MSIX package specified in the query string for users to install the app.