Freigeben über

Verwenden einer eingebetteten App Installer-Datei zum Aktualisieren Ihrer App

Von Bedeutung

Die Verwendung einer eingebetteten App Installer-Datei ist in Windows Version 10.0.21300.0 verfügbar. Um dieses Feature zu nutzen, stellen Sie sicher, dass maxVersionTested auf diese oder eine neuere Version des Windows-Betriebssystems verweist.

Die App Installer-Datei stellt einen Updatepfad bereit, über den eine Windows-App nach Updates suchen und reparieren kann.

Wenn Sie Visual Studio zum Erstellen und Veröffentlichen Ihrer Windows-App mit einer eingebetteten App Installer-Datei verwenden, müssen Sie sicherstellen, dass das Windows 10 SDK 2104 (oder höher) installiert wurde und die Projekteigenschaften Windows 10 21H1 (oder höher) als Zielversionen (MaxVersionTested und MinVersion) aufweisen. Wenn dies nicht konfiguriert wurde, legt die Windows-App die eingebetteten AppInstaller-Konfigurationen nicht auf das Gerät fest, wenn die Windows-App installiert wird.

Wie Sie - MSIX Packaging Tool

Die folgenden Schritte führen Sie durch die Verwendung des MSIX Packaging Tools zum Bearbeiten einer bereits vorhandenen Windows-App, um eine eingebettete App-Installer-App einzuschließen.

Hinweis

Im folgenden Leitfaden wird davon ausgegangen, dass Sie zuvor die App-Installer-Datei mit Visual Studio erstellt haben, um die Erstellung einer App-Installer-Datei mit verwendung des MSIX Toolkits oder manuell zu automatisieren. Anleitungen zum Erstellen einer App-Installer-Datei finden Sie in einem der folgenden Dokumentationsartikel:

Öffnen der Windows-App für die Bearbeitung

Die folgenden Schritte führen Sie durch die Verwendung der Microsoft MSIX Packaging Tool App, um mit der Bearbeitung einer Windows-App zu beginnen.

  1. Starten Sie das Microsoft MSIX Packaging Tool (Im Microsoft Store verfügbar: MSIX Packaging Tool).
  2. Wählen Sie die Schaltfläche "Paket-Editor " aus, um ein vorhandenes Paket zu bearbeiten.
  3. Wählen Sie die Schaltfläche " Durchsuchen " aus, und suchen Sie im angezeigten Fenster Ihre Windows-App, und wählen Sie die Schaltfläche " Öffnen " aus.
  4. Wählen Sie die Schaltfläche " Paket öffnen " aus.

Importieren der App Installer-Datei in die Windows-App

Die folgenden Schritte führen Sie durch das Einbetten einer App Installer-Datei in eine bereits vorhandene Windows-App mithilfe der Microsoft MSIX Packaging Tool-App. Bei diesen Schritten wird davon ausgegangen, dass Sie Ihre Windows-App bereits zur Bearbeitung mit der Microsoft MSIX Packaging Tool-App geöffnet haben.

  1. Wählen Sie auf der linken Seite des MSIX-Verpackungstools"Paketdateien" aus.
  2. Erweitern Sie den Paketeintrag in der Strukturansicht.
  3. Klicken Sie mit der rechten Maustaste auf "Paket" , und wählen Sie im Dropdownmenü " Datei hinzufügen " aus.
  4. Wählen Sie die Schaltfläche " Durchsuchen " innerhalb des angezeigten Fensters aus, navigieren Sie zu der App-Installer-Datei, und wählen Sie die Schaltfläche " Öffnen " aus.
  5. Wählen Sie die Schaltfläche Speichern aus.

Aktualisieren des AppxManifest

Die folgenden Schritte führen Sie durch das Aktualisieren des AppxManifests, um auf die App Installer-Datei zu verweisen, die zuvor der Windows-App hinzugefügt wurde.

  1. Wählen Sie auf der linken Seite des MSIX-Verpackungstools"Paketinformationen" aus.
  2. Scrollen Sie zum Ende des Abschnitts "Paketinformationen ".
  3. Wählen Sie die Schaltfläche " Datei öffnen" aus, um das AppxManifest in einem Editor-Fenster zu öffnen.
  4. Stellen Sie sicher, dass die <Package> Eigenschaften die folgenden Namespaces und ignorierbare Namespaces enthalten: 
    <Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
    xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
    xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
    xmlns:uap13="http://schemas.microsoft.com/appx/manifest/uap/windows10/13" 
    xmlns:build="http://schemas.microsoft.com/developer/appx/2015/build"
    IgnorableNamespaces="uap mp uap13 build">
  5. Fügen Sie im Inneren von <Properties> die folgenden <uap13:AutoUpdate> und untergeordneten Parameter ein: 
    <Properties>
    ...
    <uap13:AutoUpdate>
        <uap13:AppInstaller File="Update.appinstaller" />
    </uap13:AutoUpdate>
</Properties>
  6. Speichern Sie die Änderungen, die Sie am AppxManifest vorgenommen haben.
  7. Schließen Sie das AppxManifest Editor-Fenster, und kehren Sie zum MSIX-Verpackungstool zurück.

Hinweis

In den obigen Anweisungen wird davon ausgegangen, dass der Dateiname des App-Installers "Update.appinstaller" lautet.

Schließen und Verpacken der Windows-App

Die folgenden Schritte führen Sie durch das Verpacken Ihrer Windows-App als neuere Version. Bei diesen Schritten wird davon ausgegangen, dass Sie Ihre Signatureinstellungen so konfiguriert haben, dass sie Ihren Organisations- oder Clientanforderungen entsprechen.

  1. Wählen Sie im MSIX Packaging Tool die Schaltfläche " Speichern" aus .
  2. Wählen Sie im angezeigten Fenster die Schaltfläche "Ja", "Inkrementierung " aus.
  3. Navigieren Sie zu der Stelle, an der Sie Ihre neu aktualisierte Windows-App speichern möchten, und wählen Sie die Schaltfläche " Speichern" aus .
  4. Klicken Sie auf die Schaltfläche Schließen.
  5. Schließen Sie das MSIX Packaging Tool Fenster.

Gewusst wie – Visual Studio

Bevor Sie beginnen, stellen Sie sicher, dass Sie auf einem Windows 10-Gerät arbeiten, auf dem windows 10 SDK 2104 oder höher installiert ist. Dieses SDK ist erforderlich, um sicherzustellen, dass die Zielversion und die Mindestversionseigenschaften mit den richtigen Werten festgelegt werden, während Sie Ihre App erstellen.

Einbetten der App-Installer-Datei

Die folgenden Schritte führen Sie durch das Einbetten ihrer App Installer-Datei in Ihr Visual Studio-Projekt (Windows-App, UWP).

  1. Klicken Sie im Visual Studio-Projekt, im Lösungs-Explorer, mit der rechten Maustaste auf den Namen Ihrer Windows-App.
  2. Wählen Sie im Dropdownmenü "Vorhandenes Element>>" aus.
  3. Navigieren Sie zu Ihrer App-Installer-Datei, wählen Sie sie aus, und wählen Sie die Schaltfläche "Hinzufügen " aus.
  4. Doppelklicken Sie im Projektmappen-Explorer auf "Update.appinstaller ", um die Datei zur Überprüfung zu öffnen.
  5. Vergewissern Sie sich, dass die App-Installer-Datei korrekt ist, und schließen Sie die Datei.

Aktualisieren des AppxManifest

Die folgenden Schritte enthalten Anleitungen zum Aktualisieren des AppxManifests in Ihrem Visual Studio-Projekt für die neu eingebettete App Installer-Datei.

In diesem Leitfaden wird davon ausgegangen:

  • Das Windows 10 SDK 2104 oder höher ist installiert.
  • Die Projekteigenschaften sind auf Windows 10, Version 2104 oder höher, festgelegt.
  • Der Name der App Installer-Datei lautet "Update.appinstaller".
  1. Wählen Sie in Ihrem Visual Studio-Projekt im oberen Menü " Erstellen" aus.
  2. Wählen Sie im Dropdown-Menü "Lösung erstellen" aus. Stellen Sie sicher, dass der Windows-App-Build erfolgreich ist.
  3. Wählen Sie im Menüband " Lokaler Computer" aus, um die Funktionalität der Windows-App zu testen.
  4. Schließen Sie die Windows-App kurz nach dem Start, und beenden Sie das Debuggen.
  5. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf "Package.appxmanifest".
  6. Wählen Sie im Dropdownmenü " Code anzeigen " aus.
  7. Stellen Sie sicher, dass die <Package> Eigenschaften die folgenden Namespaces und ignorierbare Namespaces enthalten: 
    <Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
    xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
    xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
    xmlns:uap13="http://schemas.microsoft.com/appx/manifest/uap/windows10/13" 
    xmlns:build="http://schemas.microsoft.com/developer/appx/2015/build"
    IgnorableNamespaces="uap mp uap13 build">
  8. Fügen Sie im Inneren von <Properties> die folgenden <uap13:AutoUpdate> und untergeordneten Parameter ein: 
    <Properties>
    ...
    <uap13:AutoUpdate>
        <uap13:AppInstaller File="Update.appinstaller" />
    </uap13:AutoUpdate>
</Properties>
  9. Speichern Sie Ihre Änderungen in der Datei, und schließen Sie sie.

Erstellen Ihrer Windows-App

Die folgenden Schritte führen Sie durch das Erstellen des Windows-App-Pakets für die Installation auf unterstützten Betriebssystemen.

  1. Klicken Sie in Ihrem Visual Studio-Projekt mit der rechten Maustaste auf den Namen der Windows-App.
  2. Wählen Sie im Dropdownmenü "App-Pakete>> aus.
  3. Wählen Sie das Optionsfeld Sideloading im neuen Dialogfenster App-Pakete erstellen aus.
  4. Wählen Sie die Schaltfläche Weiter aus.
  5. Wählen Sie die Schaltfläche Ja aus, verwenden Sie das aktuelle Zertifikat: Optionsfeld aus.
  6. Importieren Sie ein vorhandenes Zertifikat, oder generieren Sie automatisch ein Zertifikat, um Ihre Windows-App zu signieren.
  7. Wählen Sie die Schaltfläche Weiter aus.
  8. Geben Sie die Lösungskonfiguration, Version und optionalen Build eines Windows-App-Bundles für Ihre Windows-App an.
  9. Wählen Sie die Schaltfläche Erstellen.