App-Paketanforderungen für MSIX-App
Anforderungen
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 |
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.
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.
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 (ohne Desktop), wenn sie mit Build >=10.0.10240.0 und < 10.010250.0 eingeführt wurden, 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.
Unterstützte Sprachen
Sie können Apps in mehr als 100 Sprachen an den Microsoft Store ü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 der Microsoft Store unterstützt. 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.
| Name der Sprache | Unterstützte Sprachcodes |
|---|---|
| Arabisch | ar, ar-sa, ar-ae, ar-bh, ar-dz, ar-eg, ar-iq, ar-jo, ar-kw, ar-lb, ar-ly, ar-ma, ar-om, ar-qa, ar-sy, ar-tn, ar-ye |
| Afrikaans | af, af-za |
| Albanisch | sq, sq-al |
| Amharisch | am, am-et |
| Armenisch | hy, hy-am |
| Assamesisch | as, as-in |
| Aserbaidschanisch | az-arab, az-arab-az, az-cyrl, az-cyrl-az, az-latn, az-latn-az |
| Baskisch (Baskisch) | eu, eu-es |
| Belarussisch | be, be-by |
| Bengalisch | bn, bn-bd, bn-in |
| Bosnisch | bs, bs-cyrl, bs-cyrl-ba, bs-latn, bs-latn-ba |
| Bulgarisch | bg, bg-bg |
| Katalanisch | ca, ca-es, ca-es-valencia |
| Cherokee | chr-cher, chr-cher-us, chr-latn |
| Chinesisch (vereinfacht) | zh-Hans, zh-cn, zh-hans-cn, zh-sg, zh-hans-sg |
| Chinesisch (traditionell) | zh-Hant, zh-hk, zh-mo, zh-tw, zh-hant-hk, zh-hant-mo, zh-hant-tw |
| Kroatisch | hr, hr-hr, hr-ba |
| Tschechisch | cs, cs-cz |
| Dänisch | da, da-dk |
| Dari | prs, prs-af, prs-arab |
| Niederländisch | nl, nl-nl, nl-be |
| Deutsch | en, en-au, en-ca, en-gb, en-ie, en-in, en-nz, en-sg, en-us, en-za, en-bz, en-hk, en-id, en-jm, en-kz, en-mt, en-my, en-ph, en-pk, en-tt, en-vn, en-zw, en-053, en-021, en-029, en-011, en-018, en-014 |
| Estnisch | et, et-ee |
| Filipino | fil, fil-latn, fil-ph |
| Finnisch | fi, fi-fi |
| Französisch | fr, fr-be , fr-ca , fr-ch , fr-fr , fr-lu, fr-015, fr-cd, fr-ci, fr-cm, fr-ht, fr-ma, fr-mc, fr-ml, fr-re, frc-latn, frp-latn, fr-155, fr-029, fr-021, fr-011 |
| Galicisch | gl, gl-es |
| Georgisch | ka, ka-ge |
| Deutsch | de, de-at, de-ch, de-de, de-lu, de-li |
| Griechisch | el, el-gr |
| Gujarati | gu, gu-in |
| Haussa | ha, ha-latn, ha-latn-ng |
| Hebräisch | he, he-il |
| Hindi | hi, hi-in |
| Ungarisch | hu, hu-hu |
| Isländisch | is, is-is |
| Igbo | ig-latn, ig-ng |
| Indonesisch | id, id-id |
| Inuktitut (Lateinisch) | iu-cans, iu-latn, iu-latn-ca |
| Irisch | ga, ga-ie |
| isi Xhosa | xh, xh-za |
| isi Zulu | zu, zu-za |
| Italienisch | it, it-it, it-ch |
| Japanisch | ja , ja-jp |
| Kannada | kn, kn-in |
| Kasachisch | kk, kk-kz |
| Khmer | km, km-kh |
| K'iche' | quc-latn, qut-gt, qut-latn |
| Kinyarwanda | rw, rw-rw |
| Kisuaheli | sw, sw-ke |
| Konkani | kok, kok-in |
| Koreanisch | ko, ko-kr |
| Kurdisch | ku-arab, ku-arab-iq |
| Kirgisisch | ky-kg, ky-cyrl |
| Laotisch | lo, lo-la |
| Lettisch | lv, lv-lv |
| Litauisch | lt, lt-lt |
| Luxemburgisch | lb, lb-lu |
| Mazedonisch | mk, mk-mk |
| Malaiisch | ms, ms-bn, ms-my |
| Malayalam | ml, ml-in |
| Maltesisch | mt, mt-mt |
| Maori | mi, mi-latn, mi-nz |
| Marathi | mr, mr-in |
| Mongolisch (Kyrillisch) | mn-cyrl, mn-mong, mn-mn, mn-phag |
| Nepalesisch | ne, ne-np |
| Norwegisch | nb, nb-no, nn, nn-no, no, no-no, |
| Odia | or, or-in |
| Persisch | fa, fa-ir |
| Polnisch | pl, pl-pl |
| Portugiesisch (Brasilien) | pt-br |
| Portugiesisch (Portugal) | pt, pt-pt |
| Pandschabi | pa, pa-arab, pa-arab-pk, pa-deva, pa-in |
| Quechua | quz, quz-bo, quz-ec, quz-pe |
| Rumänisch | ro, ro-ro |
| Russisch | ru , ru-ru |
| Schottisch-Gälisch | gd-gb, gd-latn |
| Serbisch (Lateinisch) | sr-Latn, sr-latn-cs, sr, sr-latn-ba, sr-latn-me, sr-latn-rs |
| Serbisch (Kyrillisch) | sr-cyrl, sr-cyrl-ba, sr-cyrl-cs, sr-cyrl-me, sr-cyrl-rs |
| Nord-Sotho | nso, nso-za |
| Tswana | tn, tn-bw, tn-za |
| Sindhi | sd-arab, sd-arab-pk, sd-deva |
| Singhalesisch | si, si-lk |
| Slowakisch | sk, sk-sk |
| Slowenisch | sl, sl-si |
| Spanisch | es, es-cl, es-co, es-es, es-mx, es-ar, es-bo, es-cr, es-do, es-ec, es-gt, es-hn, es-ni, es-pa, es-pe, es-pr, es-py, es-sv, es-us, es-uy, es-ve, es-019, es-419 |
| Schwedisch | sv, sv-se, sv-fi |
| Tadschikisch (Kyrillisch) | tg-arab, tg-cyrl, tg-cyrl-tj, tg-latn |
| Tamilisch | ta, ta-in |
| Tatarisch | tt-arab, tt-cyrl, tt-latn, tt-ru |
| Telugu | te, te-in |
| Thailändisch | th, th-th |
| Tigrinya | ti, ti-et |
| Türkisch | tr, tr-tr |
| Turkmenisch | tk-cyrl, tk-latn, tk-tm, tk-latn-tr, tk-cyrl-tr |
| Ukrainisch | uk, uk-ua |
| Urdu | ur, ur-pk |
| Uigurisch | ug-arab, ug-cn, ug-cyrl, ug-latn |
| Usbekisch (Lateinisch) | uz, uz-cyrl, uz-latn, uz-latn-uz |
| Vietnamesisch | vi, vi-vn |
| Walisisch | cy, cy-gb |
| Wolof | wo, wo-sn |
| Yoruba | yo-latn, yo-ng |
Windows developer