App-Paketanforderungen für MSIX-App

Anforderungen

Befolgen Sie diese Richtlinien, um die Pakete Ihrer App für die Übermittlung an die Microsoft Store vorzubereiten.

Bevor Sie Ihr App-Paket für den Microsoft Store erstellen

Stellen Sie sicher, dass Sie Ihre App mit dem Windows-App Certification Kit testen. Wir empfehlen Ihnen außerdem, Ihre App auf verschiedenen Hardwaretypen zu testen. Beachten Sie, dass sie nur auf Computern mit Entwicklerlizenzen installiert und ausgeführt werden kann, bis wir Ihre App zertifizieren und aus dem Microsoft Store verfügbar machen.

Erstellen des App-Pakets mithilfe von Microsoft Visual Studio

Wenn Sie Microsoft Visual Studio als Entwicklungsumgebung verwenden, verfügen Sie bereits über integrierte Tools, mit denen sie ein App-Paket schnell und einfach erstellen können. Weitere Informationen finden Sie unter Packen von Apps.

Wenn Sie Ihr Paket in Visual Studio erstellen, stellen Sie sicher, dass Sie mit demselben Konto angemeldet sind, das Ihrem Entwicklerkonto zugeordnet ist. Einige Teile des Paketmanifests enthalten spezifische Details im Zusammenhang mit Ihrem Konto. Diese Informationen werden automatisch erkannt und hinzugefügt. Ohne die zusätzlichen Informationen, die dem Manifest hinzugefügt wurden, treten möglicherweise Fehler beim Paketupload auf.

Wenn Sie die UWP-Pakete Ihrer App erstellen, kann Visual Studio eine MSIX- oder APPX-Datei oder eine MSIXUPLOAD- oder APPXUPLOAD-Datei erstellen. Für UWP-Apps empfehlen wir, dass Sie die .msixupload- oder .appxupload-Datei auf der Seite Pakete hochladen. Weitere Informationen zum Verpacken von UWP-Apps für den Store finden Sie unter Package einer UWP-App mit Visual Studio.

Codesignatur für Microsoft Store Übermittlungen

Ihre MSIX- und AppX-Pakete müssen bei der Übermittlung an die Microsoft Store nicht mit einem Zertifikat signiert werden, das in einer vertrauenswürdigen Zertifizierungsstelle verwurzelt ist. Die Microsoft Store signiert Ihre MSIX/AppX-Pakete während des Veröffentlichungsprozesses automatisch mit einem Microsoft-Zertifikat, nachdem Ihre App die Zertifizierung bestanden hat. Dies bedeutet:

• Sie müssen kein von einer CA beglaubigtes Codesignaturzertifikat für MSIX/AppX Store-Übermittlungen erwerben.
• Sie müssen keine PFX- oder .cer-Datei von einer Zertifizierungsstelle bereitstellen, um MSIX/AppX-Pakete zu übermitteln.
• USB-Token oder Hardwaresicherheitsmodule (HARDWARE Security Modules, HSMs) sind für MSIX/AppX Store-Übermittlungen nicht erforderlich.
• Der Store ersetzt alle vorhandenen Signaturen in MSIX/AppX-Paketen durch ein Microsoft-Zertifikat, das Kunden Vertrauen und Sicherheit bietet.

App-Pakete

Für UWP-Apps kann Visual Studio ein App-Bündel (MSIXBUNDLE oder .appxbundle) generieren, um die Größe der App zu verringern, die benutzer herunterladen. Dies kann hilfreich sein, wenn Sie sprachspezifische Ressourcen, eine Vielzahl von Ressourcen zur Bildskalierung oder Ressourcen definiert haben, die für bestimmte Versionen von Microsoft DirectX gelten.

Bei einem App-Paket lädt ein Benutzer nur die relevanten Dateien und nicht alle möglichen Ressourcen herunter. Weitere Informationen zu App-Bündeln finden Sie unter Packaging apps und Package a UWP app with Visual Studio.

Manuelles Erstellen des App-Pakets

Wenn Sie ihr Paket nicht mit Visual Studio erstellen, müssen Sie Das Paketmanifest manuell erstellen.

Lesen Sie unbedingt die Dokumentation zum App-Paketmanifest , um vollständige Manifestdetails und Anforderungen zu erhalten. Ihr Manifest muss dem Paketmanifestschema folgen, um die Zertifizierung zu bestehen.

Ihr Manifest muss bestimmte Informationen zu Ihrem Konto und Ihrer App enthalten. Sie finden diese Informationen, indem Sie sich die Details zur App-Identität im Abschnitt Produktverwaltung auf der Übersichtsseite Ihrer App im Dashboard ansehen.

App-Pakete (.msixbundle oder .appxbundle) verwenden ein anderes Manifest. Lesen Sie die Dokumentation Paketmanifest, um die Details und Anforderungen für App-Paketmanifeste zu erhalten. Beachten Sie, dass in einem .msixbundle- oder .appxbundle-Manifest für jedes enthaltene Paket dieselben Elemente und Attribute verwendet werden müssen, mit Ausnahme des Attributs ProcessorArchitecture des Elements Identität .

Anforderungen an das Paketformat

Die Pakete Ihrer App müssen diese Anforderungen erfüllen.

Unterstützte Versionen

Für UWP-Apps müssen alle Pakete auf eine Version von Windows 10 oder Windows 11 abzielen, die vom Store unterstützt werden. Die von Ihrem Paket unterstützten Versionen müssen in den Attributen MinVersion und MaxVersionTested des Elements TargetDeviceFamily des App-Manifests angegeben werden.

StoreManifest-XML-Datei

StoreManifest.xml ist eine optionale Konfigurationsdatei, die in App-Paketen enthalten sein kann. Der Zweck besteht darin, Funktionen zu ermöglichen, wie das Deklarieren Ihrer App als Microsoft Store Geräte-App oder das Festlegen von Anforderungen, von denen ein Paket abhängig ist und die auf ein Gerät anwendbar sein müssen, die das Paketmanifest nicht abdeckt. Bei Verwendung wird StoreManifest.xml mit dem App-Paket übermittelt und muss sich im Stammordner des Standardprojekts Ihrer App befinden. Weitere Informationen finden Sie im StoreManifest-Schema.

Paketversionsnummerierung

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

Versionsnummerierung für Windows 10- und 11-Pakete

Wenn Sie ein UWP-Paket aus Ihrer veröffentlichten Übermittlung auswählen, verwendet die 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öheren Versionen hinzufügen, die strengere Abhängigkeiten aufweisen, 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 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 Paketversionsverwaltungsregeln verwenden, um Ihre Kunden schrittweise auf 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.

Verwenden der Versionsnummerierung, um zu einem zuvor bereitgestellten Paket für neue Erwerbungen zurückzukehren.

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 die Kunden zu beheben, die das problematische Paket bereits erhalten haben, können Sie ein neues Windows 10 Paket übermitteln, das eine höhere Versionsnummer als das ungültige Paket aufweist, sobald Sie dies erreichen können. Nachdem diese Übermittlung den Zertifizierungsprozess durchlaufen hat, werden alle Kunden auf das neue Paket aktualisiert, da es eine höhere Versionsnummer haben wird.

Unterstützte Sprachen

Sie können Apps an die Microsoft Store in über 100 Sprachen übermitteln.

Weitere Informationen zum Konfigurieren von Sprachen in Ihren Apps finden Sie unter Globalisierung und Lokalisierung und Grundlegendes zu Sprachen für Benutzerprofil und App-Manifest. Außerdem verfügen wir über ein mehrsprachiges App-Toolkit, mit dem Sie Apps schreiben können, die mehrere Sprachen unterstützen.

Liste unterstützter Sprachen

Dies sind die Sprachen, die vom Microsoft Store unterstützt werden. Ihre App muss mindestens eine dieser Sprachen unterstützen.

Sprachcodes, die hier nicht enthalten sind, werden vom Store nicht unterstützt. Es wird empfohlen, keine Pakete für andere Sprachcodes als die unten aufgeführten zu verwenden. Solche Pakete werden nicht an Kunden verteilt und können zu Verzögerungen oder Fehlern bei der Zertifizierung führen.