Freigeben über

Hochladen von MSIX-App-Paketen

  • Artikel

Hochladen der App-Pakete

Auf der Seite Pakete im Prozess zur App-Übermittlung laden Sie alle Paketdateien („.msix“, „.msixupload“, „.msixbundle“, „.appx“, „.appxupload“ und/oder „.appxbundle“) für die von Ihnen übermittelte App hoch. Sie können alle Ihre Pakete für dieselbe App auf dieser Seite hochladen. Wenn Kund*innen Ihre App herunterladen, stellt der Store für alle Kund*innen automatisch das Paket bereit, das für ihre Geräte am besten geeignet ist. Nachdem Sie Ihre Pakete hochgeladen haben, sehen Sie eine nach Rangfolge geordnete Tabelle, in der angegeben ist, welche Pakete für bestimmte Windows 10- oder Windows 11-Gerätefamilien angeboten werden (und ggf. für frühere Betriebssystemversionen).

Screenshot der Übersicht über die Seite

Ausführliche Informationen dazu, was ein Paket enthält und wie es strukturiert werden muss, finden Sie unter App-Paketanforderungen. Darüber hinaus sollten Sie sich darüber informieren, wie sich Versionsnummern darauf auswirken, welche Pakete an bestimmte Kund*innen übermittelt werden und wie Sie Pakete für verschiedene Szenarien verwalten.

Hochladen von Paketen in Ihre Übermittlung

Um Pakete hochzuladen, ziehen Sie sie in das Uploadfeld, oder klicken Sie, um Ihre Dateien zu durchsuchen. Auf der Seite Pakete können Sie MSIX-, MSIXUPLOAD-, MSIXBUNDLE-, APPX-, APPXUPLOAD- und/oder APPXBUNDLE-Dateien hochladen.

Wichtig

Für Windows 10 und höher empfehlen wir, die MSIXUPLOAD- oder APPXUPLOAD-Datei hier anstelle von MSIX, .appx, MSIXBUNDLE oder APPXBUNDLE hochzuladen. Weitere Informationen zum Verpacken von UWP-Apps für den Store finden Sie unter Packen einer UWP-App mit Visual Studio.

Wenn Sie einen Test-Flight für Ihre App erstellt haben, wird eine Dropdownliste mit der Option zum Kopieren von Paketen aus einem Ihrer Test-Flights angezeigt. Wählen Sie den Test-Flight mit den Paketen aus, die Sie abrufen möchten. Sie können dann beliebige oder alle Pakete auswählen, die in diese Übermittlung eingeschlossen werden sollen.

Wenn bei der Überprüfung Fehler bei einem Paket erkannt werden, wird eine Meldung mit einem entsprechenden Hinweis angezeigt. Sie müssen das Paket entfernen, das Problem beheben und dann erneut versuchen, das Paket hochzuladen. Möglicherweise werden auch Warnungen angezeigt, um Sie über Fehler zu informieren, die zu Problemen führen können, sie aber nicht daran hindern, die Übermittlung fortzusetzen.

Paketdetails

Ihre hochgeladenen Pakete werden hier aufgelistet, gruppiert nach Zielbetriebssystem. Der Name, die Version und die Architektur des Pakets werden angezeigt. Klicken Sie auf Details anzeigen, um weitere Informationen wie die unterstützten Sprachen, App-Funktionen und Dateigröße für jedes Paket anzuzeigen.

Wenn Sie ein Paket aus Ihrer Übermittlung entfernen müssen, klicken Sie unten im Abschnitt Details der einzelnen Pakete auf den Link Entfernen.

Entfernen redundanter Pakete

Wenn wir feststellen, dass mindestens ein Paket redundant ist, wird eine Warnung mit einem Hinweis angezeigt, dass die redundanten Pakete aus dieser Übermittlung entfernt werden sollten. Dies geschieht häufig, wenn Sie zuvor Pakete hochgeladen haben und nun Pakete mit einer höheren Versionsnummer bereitstellen, die dieselben Kund*innen unterstützen. In diesem erhalten keine Kund*innen das redundante Paket, da jetzt ein besseres Paket (mit höherer Versionsnummer) verfügbar ist, um diese Kund*innen zu unterstützen.

Wenn wir feststellen, dass Sie über redundante Pakete verfügen, bieten wir eine Option, alle redundanten Pakete automatisch aus dieser Übermittlung zu entfernen. Sie können Pakete auch einzeln aus der Übermittlung entfernen.

Schrittweiser Paketrollout

Wenn Ihre Übermittlung ein Update einer bereits veröffentlichte App ist, wird ein Kontrollkästchen mit der Bezeichnung Update-Rollout schrittweise nach Veröffentlichung dieser Übermittlung (nur für Windows 10- oder Windows 11-Kunden) angezeigt. Dadurch können Sie den Prozentsatz von Kund*innen auswählen, die die Pakete aus der Übermittlung erhalten. So können Sie Feedback und Analysedaten beobachten und vor einem umfassenderen Rollout sicherstellen, dass das Update verlässlich ist. Sie können den Prozentsatz jederzeit erhöhen (oder das Update anhalten), ohne eine neue Übermittlung erstellen zu müssen.

Weitere Informationen finden Sie unter Schrittweiser Paketrollout.

Obligatorisches Update

Wenn Ihre Übermittlung ein Update für eine zuvor veröffentlichte App ist, wird ein Kontrollkästchen mit der Bezeichnung Dieses Update als obligatorisch kennzeichnen angezeigt. Auf diese Weise können Sie das Datum und die Uhrzeit für ein obligatorisches Update festlegen, vorausgesetzt, Sie haben die Windows.Services.Store-APIs verwendet, damit Ihre App programmgesteuert nach Paketupdates suchen und die aktualisierten Pakete herunterladen und installieren kann. Ihre App muss auf Windows 10, Version 1607 oder höher, ausgerichtet sein, damit diese Option verwendet werden kann.

Weitere Informationen finden Sie unter Herunterladen und Installieren von Paketaktualisierungen für Ihre App.

Verfügbarkeit von Gerätefamilien

Nachdem Ihre Pakete erfolgreich auf die Seite Pakete hochgeladen wurden, zeigt der Abschnitt Verfügbarkeit der Gerätefamilie eine Tabelle an, die in geordneter Reihenfolge angibt, welche Pakete für bestimmte Windows 10- oder Windows 11-Gerätefamilien (und ggf. frühere Betriebssystemversionen) angeboten werden. In diesem Abschnitt können Sie außerdem auswählen, ob die Übermittlung Kund*innen mit bestimmten Windows 10- oder Windows 11-Gerätefamilien angeboten werden soll.

Hinweis

Wenn Sie noch keine Pakete hochgeladen haben, zeigt der Abschnitt Verfügbarkeit der Gerätefamilie die Windows 10- oder Windows 11-Gerätefamilien mit Kontrollkästchen an, mit denen Sie angeben können, ob die Übermittlung Kunden in diesen Gerätefamilien angeboten wird. Die Tabelle wird angezeigt, nachdem Sie ein oder mehrere Pakete hochgeladen haben.

Dieser Abschnitt enthält auch ein Kontrollkästchen, in dem Sie angeben können, ob Microsoft die App für zukünftige Windows 10- oder Windows 11-Gerätefamilien verfügbar machen soll. Wir empfehlen, dieses Kontrollkästchen aktiviert zu lassen, damit Ihre App mehr potenziellen Kunden zur Verfügung steht, wenn neue Gerätefamilien eingeführt werden.

Auswählen der zu unterstützenden Gerätefamilien

Wenn Sie Pakete für eine einzelne Gerätefamilie hochladen, aktivieren wir das Kontrollkästchen, um diese Pakete neuen Kunden auf diesem Gerätetyp zur Verfügung zu stellen. Wenn beispielsweise ein Paket auf Windows.Desktop ausgerichtet ist, wird das Windows 10/11-Desktopfeld für dieses Paket aktiviert (und Sie können die Kontrollkästchen für andere Gerätefamilien nicht aktivieren).

Pakete für die Windows.Universal-Gerätefamilie können auf jedem Windows 10- oder Windows 11-Gerät (einschließlich Xbox One) ausgeführt werden. Standardmäßig stellen wir diese Pakete neuen Kunden auf allen Gerätetypen mit Ausnahme von Xbox zur Verfügung.

Sie können das Kontrollkästchen für jede Windows 10- oder Windows 11-Gerätefamilie deaktivieren, wenn Sie Ihre Übermittlung für Kunden auf diesem Gerätetyp nicht anbieten möchten. Wenn das Kontrollkästchen einer Gerätefamilie deaktiviert ist, können neue Kunden auf diesem Gerätetyp die App nicht erwerben (Kunden, die die App bereits besitzen, können sie jedoch weiterhin verwenden und erhalten alle von Ihnen übermittelten Updates).

Wenn Ihre App sie unterstützt, empfehlen wir, alle Kontrollkästchen aktiviert zu lassen, es sei denn, Sie haben einen bestimmten Grund, die Typen von Windows 10- oder Windows 11-Geräten einzuschränken, die Ihre App erwerben können. Wenn Sie beispielsweise wissen, dass Ihre App auf Surface Hub und/oder Microsoft HoloLens keine gute Erfahrung bietet, können Sie das Kontrollkästchen Windows 10 Team und/oder Windows 10 Holographic deaktivieren. Dadurch wird verhindert, dass neue Kunden die App auf diesen Geräten erwerben. Wenn Sie später entscheiden, dass Sie die App diesen Kunden anbieten möchten, können Sie eine neue Übermittlung mit aktivierten Kontrollkästchen erstellen.

Xbox-Geräte

Die einzige Windows 10- oder Windows 11-Gerätefamilie, die nicht standardmäßig für Windows.Universal-Pakete aktiviert ist, ist Windows 10 Xbox. Wenn Ihre App kein Spiel ist (oder wenn es sich um ein Spiel handelt und Sie das Xbox Live Creators-Programm aktiviert oder den Konzeptgenehmigungsprozess durchlaufen haben), und Ihre Übermittlung neutrale und/oder x64 UWP-Pakete enthält, die mit Windows 10 SDK Version 14393 oder höher kompiliert wurden, können Sie das Kontrollkästchen Windows 10 Xbox aktivieren, um Kunden die App auf Xbox One anzubieten.

Wichtig

Damit Ihre App auf Xbox-Geräten gestartet werden kann, müssen Sie ein neutrales oder x64-Paket einbinden, das mit Windows SDK Version 14393 oder höher kompiliert wird. Wenn Sie jedoch Windows 10 Xbox aktivieren, wird Ihr Paket mit der höchsten Version, das für Xbox gilt (d. h. ein neutrales oder x64-Paket, das auf die Xbox oder universelle Gerätefamilie ausgerichtet ist) Kunden auf Xbox angeboten, auch wenn es mit einer früheren SDK-Version kompiliert wird. Aus diesem Grund ist es wichtig sicherzustellen, dass das Paket mit der höchsten Version für Xbox mit der Windows SDK-Version 14393 oder höher kompiliert wird. Andernfalls wird eine Fehlermeldung angezeigt, die angibt, dass Xbox-Kunden Ihre App nicht starten können.

Zum Beheben dieses Fehlers können Sie eine der folgenden Maßnahmen ergreifen:

  • Ersetzen Sie die entsprechenden Pakete durch neue, die mit der Windows SDK-Version 14393 oder höher kompiliert wurden.
  • Wenn Sie bereits über ein Paket verfügen, das Xbox unterstützt und mit der Windows SDK-Version 14393 oder höher kompiliert ist, erhöhen Sie dessen Versionsnummer, sodass es das Paket mit der höchsten Version in der Übermittlung ist.
  • Deaktivieren Sie das Kontrollkästchen für Windows 10 Xbox.

Wenn Sie das Problem weiterhin nicht beheben können, wenden Sie sich an den Support.

Wenn Sie eine UWP-App für Windows 10 IoT Core übermitteln, sollten Sie nach dem Hochladen Ihrer Pakete keine Änderungen an den Standardauswahlen vornehmen. Für Windows 10 IoT ist kein separates Kontrollkästchen vorhanden. Weitere Informationen zum Veröffentlichen von IoT Core UWP-Apps finden Sie im Microsoft Store-Support für IoT Core UWP-Apps.

Wichtig

Um zu verhindern, dass eine bestimmte Windows 10- oder Windows 11-Gerätefamilie Ihre Übermittlung erhält, aktualisieren Sie das TargetDeviceFamily-Element in Ihrem Manifest so, dass es nur auf die Gerätefamilie ausgerichtet ist, die Sie unterstützen möchten (d. h. Windows.Desktop), anstatt sie als Windows.Universal-Wert (für die universelle Gerätefamilie) zu verlassen, den Microsoft Visual Studio standardmäßig im Manifest enthält.

Es ist wichtig, zu beachten, dass die von Ihnen im Abschnitt Verfügbarkeit der Gerätefamilie getroffene Auswahl, nur für neue Käufe gilt. Alle Personen, die Ihre App bereits besitzen, können sie weiterhin verwenden und erhalten alle von Ihnen übermittelten Updates, auch wenn Sie ihre Gerätefamilie hier entfernen. Dies gilt auch für Kunden, die Ihre App erworben haben, bevor Sie ein Upgrade auf Windows 10 oder Windows 11 durchführen.

Weitere Informationen zu Gerätefamilien finden Sie unter Programmieren mit Erweiterungs-SDKs.

Grundlegendes zur Reihenfolge

Abgesehen davon, dass Sie angeben können, welche Windows 10- oder Windows 11-Gerätefamilien Ihre Übermittlung herunterladen können, zeigt der Abschnitt Verfügbarkeit der Gerätefamilie die spezifischen Pakete an, die für verschiedene Gerätefamilien zur Verfügung gestellt werden. Wenn Sie mehrere Pakete haben, die auf einer bestimmten Gerätefamilie ausgeführt werden können, gibt die Tabelle die Reihenfolge an, in der Pakete angeboten werden, basierend auf den Versionsnummern der Pakete. Weitere Informationen dazu, wie der Store Pakete basierend auf Versionsnummern bewertet, finden Sie unter Paketversionsnummerierung.

Angenommen, Sie haben zwei Pakete: Package_A.appxupload und Package_B.appxupload. Wenn für eine bestimmte Gerätefamilie Package_A.appxupload den Rang 1 und Package_B.appxupload den Rang 2 hat, bedeutet das, dass der Store zuerst versucht, Package_A.appxupload bereitzustellen, wenn ein Kunde auf diesem Gerätetyp Ihre App erwirbt. Wenn das Gerät des Kunden nicht Package_A.appxupload ausführen kann, bietet der Store Package_B.appxupload an. Wenn das Gerät des Kunden keines der Pakete für diese Gerätefamilie ausführen kann (z. B. wenn die MinVersion Ihrer Version höher ist als die Version auf dem Gerät des Kunden), kann der Kunde die App auf diesem Gerät nicht herunterladen.

Hinweis

Die Versionsnummern in .xap-Paketen (für zuvor veröffentlichte Apps) werden bei der Bestimmung, welches Paket einem bestimmten Kunden bereitgestellt werden soll, nicht berücksichtigt. Wenn Sie über mehr als ein .xap-Paket mit gleichem Rang verfügen, wird aus diesem Grund ein Sternchen anstelle einer Zahl angezeigt, und Kunden erhalten möglicherweise eines der beiden Pakete. Um Kunden von einem .xap-Paket auf ein neueres zu aktualisieren, stellen Sie sicher, dass Sie die ältere .xap-Datei aus der neuen Übermittlung entfernen.