Paketversionsnummerierung

Jedes bereitgestellte Paket muss über eine Versionsnummer verfügen (als Wert im Attribut Version des Elements Paket/Identität im App-Manifest angegeben). Der Microsoft Store erzwingt bestimmte Regeln im Zusammenhang mit Versionsnummern, die in verschiedenen Betriebssystemversionen etwas anders funktionieren.

Hinweis

In diesem Thema wird auf „Pakete“ verwiesen, es sei denn, die gleichen Regeln gelten für Versionsnummern für .msix/.appx- und .msixbundle/.appxbundle-Dateien.

Versionsnummerierung für Windows 10- und Windows 11-Pakete

Wichtig

Für Windows 10- oder Windows 11-Pakete (UWP) ist der letzte (vierte) Abschnitt der Versionsnummer für die Store-Verwendung reserviert und muss beim Erstellen des Pakets 0 bleiben (obwohl der Store den Wert in diesem Abschnitt möglicherweise ändert). Die anderen Abschnitte müssen auf eine ganze Zahl zwischen 0 und 65535 festgelegt werden (mit Ausnahme des ersten Abschnitts, der nicht 0 sein kann).

Wenn Sie ein UWP-Paket aus Ihrer veröffentlichten Übermittlung auswählen, verwendet der Microsoft Store immer das Paket mit der höchsten Version, das für das Windows 10- oder Windows 11-Gerät des Kunden gilt. Dadurch erhalten Sie mehr Flexibilität und können steuern, welche Pakete Kunden auf bestimmten Gerätetypen zur Verfügung gestellt werden. Wichtig ist, dass Sie diese Pakete in beliebiger Reihenfolge übermitteln können. Sie sind nicht darauf beschränkt, Pakete mit höherer Version bei jeder nachfolgenden Übermittlung bereitzustellen.

Sie können mehrere UWP-Pakete mit derselben Versionsnummer bereitstellen. Pakete, die eine Versionsnummer gemeinsam nutzen, können jedoch nicht dieselbe Architektur aufweisen, da die vollständige Identität, die der Store für jedes Ihrer Pakete verwendet, eindeutig sein muss. Weitere Informationen finden Sie unter Identität.

Wenn Sie mehrere UWP-Pakete bereitstellen, die dieselbe Versionsnummer verwenden, wird die Architektur (in der Reihenfolge x64, x86, Arm, neutral) verwendet, um zu entscheiden, welches Paket höher ist (wenn der Store bestimmt, welches Paket für das Gerät eines Kunden bereitgestellt werden soll). Beim Bewerten von App-Paketen, die dieselbe Versionsnummer verwenden, wird der höchste Architekturrang innerhalb des Pakets berücksichtigt: Ein App-Paket, das ein x64-Paket enthält, hat eine höhere Rangfolge als ein Paket, das nur ein x86-Paket enthält.

Dies gibt Ihnen viel Flexibilität, Ihre App im Laufe der Zeit weiterzuentwickeln. Sie können neue Pakete hochladen und übermitteln, die niedrigere Versionsnummern verwenden, um Unterstützung für Windows 10- oder Windows 11-Geräte hinzuzufügen, die Sie zuvor nicht unterstützt haben, Sie können Pakete mit höherer Version hinzufügen, die strengere Abhängigkeiten haben, um Hardware- oder Betriebssystemfeatures zu nutzen, oder Sie können Pakete mit höherer Version hinzufügen, die als Updates für einige oder alle Kunden Ihrer vorhandenen Kundenbasis dienen.

Im folgenden Beispiel wird veranschaulicht, wie die Versionsnummerierung verwaltet werden kann, um die vorgesehenen Pakete über mehrere Übermittlungen an Ihre Kunden zu übermitteln.

Beispiel: Wechseln zu einem einzelnen Paket über mehrere Übermittlungen

Mit Windows 10 können Sie eine einzelne Codebasis schreiben, die überall ausgeführt wird. Dies erleichtert den Start eines neuen plattformübergreifenden Projekts. Aus verschiedenen Gründen möchten Sie vorhandene Codebasen jedoch möglicherweise nicht zusammenführen, um sofort ein einzelnes Projekt zu erstellen.

Sie können die Regeln zur Paketversionierung verwenden, um Ihre Kunden schrittweise in ein einzelnes Paket für die universelle Gerätefamilie zu verschieben, während sie eine Reihe von Zwischenupdates für bestimmte Gerätefamilien (einschließlich derer, die Windows 10-APIs nutzen) versenden. Das folgende Beispiel veranschaulicht, wie die gleichen Regeln konsistent auf eine Reihe von Übermittlungen für dieselbe App angewendet werden.

Übermittlung	Contents	Benutzerfreundlichkeit
1	– Paketversion: 1.1.10.0 – Gerätefamilie: Windows.Desktop, minVersion 10.0.10240.0	– Geräte unter Windows 10 und Windows 11 Desktop Build 10.0.10240.0 und höher erhalten 1.1.10.0 – Andere Gerätefamilien können die App nicht kaufen und installieren.
2	– Paketversion: 1.1.10.0 – Gerätefamilie: Windows.Desktop, minVersion 10.0.10240.0 – Paketversion: 1.0.0.0 – Gerätefamilie: Windows.Universal, minVersion 10.0.10240.0	– Geräte unter Windows 10 und Windows 11 Desktop Build 10.0.10240.0 und höher erhalten 1.1.10.0 – Andere Gerätefamilien (keine Desktopgeräte) erhalten bei Einführung 1.0.0.0. – Desktopgeräten, auf denen die App bereits installiert ist, werden keine Updates angezeigt (da sie bereits über die beste verfügbare Version verfügen – 1.1.10.0 und sind höher als 1.0.0.0)
3	– Paketversion: 1.1.10.0 – Gerätefamilie: Windows.Desktop, minVersion 10.0.10240.0 – Paketversion: 1.1.5.0 – Gerätefamilie: Windows.Universal, minVersion 10.0.10250.0 – Paketversion: 1.0.0.0 – Gerätefamilie: Windows.Universal, minVersion 10.0.10240.0	– Geräte unter Windows 10 und Windows 11 Desktop Build 10.0.10240.0 und höher erhalten 1.1.10.0 - Andere Gerätefamilien (keine Desktopgeräte), die mit Build 10.0.10250.0 und höher eingeführt werden, erhalten 1.1.5.0 - Andere Gerätefamilien (keine Desktopgeräte), die mit Build >=10.0.10240.0 und < 10.010250.0 eingeführt werden, erhalten 1.1.0.0 – Desktopgeräten, auf denen die App bereits installiert ist, werden keine Updates angezeigt (da sie bereits über die beste verfügbare Version verfügen – 1.1.10.0, die höher als 1.1.5.0 und 1.0.0.0 ist)
4	– Paketversion: 2.0.0.0 – Gerätefamilie: Windows.Universal, minVersion 10.0.10240.0	– Alle Kunden auf allen Gerätefamilien unter Windows 10 und Windows 11 Build v10.0.10240.0 und höher erhalten Paket 2.0.0.0.0

Hinweis

 In allen Fällen erhalten Kundengeräte das Paket mit der höchsten Versionsnummer, für die sie sich qualifizieren. In der dritten Übermittlung oben erhalten beispielsweise alle Desktopgeräte v1.1.10.0, auch wenn sie über die Betriebssystemversion 10.0.10250.0 oder höher verfügen und somit auch v1.1.5.0 akzeptieren können. Da 1.1.10.0 die höchste für sie verfügbare Versionsnummer ist, ist dies das Paket, das sie erhalten.

Verwenden der Versionsnummerierung zum Zurücksetzen auf ein zuvor bereitgestelltes Paket für neue Käufe

Wenn Sie Kopien Ihrer Pakete beibehalten, haben Sie die Möglichkeit, das App-Paket im Store auf ein früheres Windows 10-Paket zurückzusetzen, wenn Sie Probleme mit einer Version feststellen sollten. Dies ist eine vorübergehende Möglichkeit, die Beeinträchtigung Ihrer Kunden zu begrenzen, während Sie sich Zeit nehmen, das Problem zu beheben.

Erstellen Sie dazu eine neue Übermittlung. Entfernen Sie das problematische Paket, und laden Sie das alte Paket hoch, das Sie im Store bereitstellen möchten. Kunden, die das Paket, das Sie zurücksetzen, bereits erhalten haben, verfügen weiterhin über das problematische Paket (da Ihr älteres Paket eine frühere Versionsnummer hat). Dadurch wird jedoch verhindert, dass andere Personen das problematische Paket erwerben, während die App weiterhin im Store verfügbar ist.

Um das Problem für Kunden zu beheben, die das problematische Paket bereits erhalten haben, können Sie so schnell wie möglich ein neues Windows 10-Paket mit einer höheren Versionsnummer als das fehlerhafte Paket einreichen. Nachdem diese Übermittlung den Zertifizierungsprozess durchlaufen hat, werden alle Kunden auf das neue Paket aktualisiert, da es eine höhere Versionsnummer haben wird.

Sie können die Paketversionsnummerierung über Ihr Installationsprogramm verwalten. Die Paketversionsnummerierung für Win32 wird nicht über den Store unterstützt.

Wichtig

Die Paketversionsnummerierung wird für App-Add-Ons nicht unterstützt.