Verwenden einer eingebetteten App-Installer-Datei zum Aktualisieren Ihrer App

Wichtig

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.

Hilfe & Anleitung – 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, mithilfe des MSIX Toolkits oder manuell, zu automatisieren. Leitfaden zum Erstellen einer App-Installer-Datei finden Sie in einem der folgenden DOC-Artikel:

Ö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. Wählen Sie dann 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-VerpackungstoolsPaketdateien aus.
  2. Erweitern Sie den Paket-Eintrag 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-VerpackungstoolsPaketinformationen 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 Ignorable-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. In <Properties> enthalten sind die folgenden <uap13:AutoUpdate> und untergeordneten Parameter:
    <Properties>
        ...
        <uap13:AutoUpdate>
            <uap13:AppInstaller File="Update.appinstaller" />
        </uap13:AutoUpdate>
    </Properties>
    
  6. Speichern Sie alle Änderungen, die Sie an der AppxManifest vorgenommen haben.
  7. Schließen Sie das Fenster AppxManifest Editor 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, Inkrement aus.
  3. Navigieren Sie zu der Stelle, an der Sie Ihre neu aktualisierte Windows-App speichern möchten und klicken Sie auf die Schaltfläche Speichern.
  4. Klicken Sie auf die Schaltfläche Schließen.
  5. Schließen Sie das Fenster MSIX Packaging Tool.

Hilfe & Anleitung – 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 folgende Anleitung führt Sie durch das Einbetten ihrer App Installer-Datei in Ihr Visual Studio-Projekt (Windows-App, UWP).

  1. Klicken Sie in Ihrem Visual Studio-Projekt, Projektmappen-Explorer von Visual Studio mit der rechten Maustaste auf Ihren Windows-App-Namen.
  2. Wählen Sie im Dropdownmenü Vorhandenes Element hinzufügen>> aus.
  3. Navigieren Sie zu Ihrer App-Installer-Datei, wählen Sie sie aus und klicken Sie auf die Schaltfläche Hinzufügen.
  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:

  • Dass Windows 10 SDK 2104 oder höher ist installiert
  • Die Projekteigenschaften auf Windows 10, Version 2104 oder höher, festgelegt werden.
  • Der Name der App-Installer-Datei ist Update.appinstaller
  1. Wählen Sie Build in Ihrem Visual Studio im oberen Menü.
  2. Wählen Sie im Dropdownmenü die Option Build Lösung. Sicherstellen, dass der Windows-App-Buildvorgang erfolgreich war.
  3. Wählen Sie im 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 Ignorable-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. In <Properties> enthalten sind die folgenden <uap13:AutoUpdate> und untergeordneten Parameter:
    <Properties>
        ...
        <uap13:AutoUpdate>
            <uap13:AppInstaller File="Update.appinstaller" />
        </uap13:AutoUpdate>
    </Properties>
    
  9. Speichern Sie Ihre Änderungen, und schließen Sie die Datei.

Erstellen Ihrer Windows-App

Die folgende Anleitung führt Sie durch das Erstellen des Windows-App-Pakets für die Installation auf unterstützten Betriebssystemen.

  1. Klicken Sie in Ihrem Visual Studio-Projekt, Projektmappen-Explorer von Visual Studio mit der rechten Maustaste auf den Windows-App-Namen.
  2. Wählen Sie im Dropdownmenü App-Pakete erstellen …>> veröffentlichen aus.
  3. Wählen Sie im Dialogfeld "App-Pakete erstellen" das Optionsfeld "Querladen" aus.
  4. Wählen Sie die Schaltfläche Weiter aus.
  5. Wählen Sie das Optionsfeld Ja, verwenden Sie das aktuelle Zertifikat:.
  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 aus.