App-Paketanforderungen

  • Artikel

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

Vor dem Erstellen des App-Pakets für den Microsoft Store

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 im Microsoft Store verfügbar machen.

Erstellen des App-Pakets mit 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.

Hinweis

Achten Sie darauf, dass alle Ihre Dateinamen ANSI verwenden.

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 file-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 Paketieren von UWP-Apps für den Store finden Sie unter Paketieren einer UWP-App mit Visual Studio.

Die Pakete Ihrer App müssen nicht mit einem Zertifikat signiert sein, das von einer vertrauenswürdigen Zertifizierungsstelle stammt.

App-Pakete

Für UWP-Apps kann Visual Studio ein App-Paket (.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.

Hinweis

 Ein App-Paket kann Ihre Pakete für alle Architekturen enthalten.

Bei einem App-Paket lädt ein Benutzer nur die relevanten Dateien und nicht alle möglichen Ressourcen herunter. Weitere Informationen zu App-Paketen finden Sie unter Paketieren von Apps und Paketieren einer UWP-App mit Visual Studio.

Manuelles Erstellen des App-Pakets

Wenn Sie Visual Studio nicht zum Erstellen des Pakets verwenden, müssen Sie Ihr 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.

Hinweis

 Bei Werten im Manifest wird zwischen Groß- und Kleinschreibung unterschieden. Leerzeichen und andere Interpunktionszeichen müssen ebenfalls übereinstimmen. Geben Sie die Werte sorgfältig ein, und überprüfen Sie sie, um sicherzustellen, dass sie korrekt sind.

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 .

Tipp

 Führen Sie unbedingt das Zertifizierungskit für Windows-Apps aus, bevor Sie Ihre Pakete übermitteln. Auf diese Weise können Sie ermitteln, ob Ihr Manifest Probleme hat, die zu Zertifizierungs- oder Übermittlungsfehlern führen können.

Anforderungen an das Paketformat

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

Eigenschaft des App-Pakets Anforderung
Paketgröße .msixbundle oder .appxbundle: maximal 25 GB pro Paket
.msix- oder .appx-Pakete für Windows 10 oder Windows 11: maximal 25 GB pro Paket
Blockzuordnungshashes SHA2-256-Algorithmus

Wichtig

Sie können keine neuen XAP-Pakete mehr hochladen, die mit den Windows Phone 8.x SDKs erstellt wurden. Apps, die bereits mit XAP-Paketen im Store verfügbar sind, funktionieren weiterhin auf Windows 10 Mobile-Geräten. Weitere Informationen finden Sie in diesem Blogbeitrag.

Unterstützte Versionen

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

Die derzeit unterstützten Versionen reichen von:

  • Mindestwert: 10.0.10240.0
  • Maximum: 10.0.22621.0

StoreManifest-XML-Datei

StoreManifest.xml ist eine optionale Konfigurationsdatei, die in App-Paketen enthalten sein kann. Ihr Zweck besteht darin, Funktionen zu ermöglichen, z. B. das Deklarieren Ihrer App als Microsoft Store-Geräte-App oder das Deklarieren von Anforderungen, von denen ein Paket abhängt, um auf ein Gerät anwendbar zu sein, 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.

Senden Sie eine HTTPS-fähige Download-URL (direkter Link) an die Installationsbinärdateien des Produkts. Auf diese Weise übermittelte Produkte unterliegen den folgenden Anforderungen:

  • Die Binärdatei des Installationsprogramms eine MSI- oder EXE-Datei sein.

  • Die Binärdatei und alle zugehörigen PE-Dateien (Portable Executable) müssen digital mit einem Codesignaturzertifikat signiert werden, das mit einem Zertifikat verkettet ist, das von einer Zertifizierungsstelle (ZS) ausgestellt wurde, die Teil des Microsoft Trusted Root-Programms ist.

  • Sie müssen eine Download-URL mit Versionsangabe in Partner Center übermitteln. Die dieser URL zugeordnete Binärdatei darf nach der Übermittlung nicht geändert werden.

  • Wenn Sie eine aktualisierte Binärdatei verteilen möchten, müssen Sie eine aktualisierte Download-URL mit Versionsangabe in Partner Center bereitstellen, die der aktualisierten Binärdatei zugeordnet ist. Sie sind für die Verwaltung und Aktualisierung der Download-URL verantwortlich.

  • Beim Initiieren der Installation darf keine Benutzeroberfläche für die Installation angezeigt werden (d. h. es ist eine automatische Installation erforderlich). Das Dialogfeld für die Benutzerkontensteuerung (User Account Control, UAC) ist jedoch zulässig.

  • Das Installationsprogramm ist ein eigenständiges Installationsprogramm und kein Downloadprogramm-Stub/Webinstaller, der bei der Ausführung etwas herunterlädt.

Wichtig

App-Paketanforderungen werden für App-Add-Ons nicht unterstützt.