MSIX-app-pakketten uploaden

De pakketten van uw app uploaden

Op de pagina Pakketten van het indieningsproces voor apps uploadt u alle pakketbestanden (.msix, .msixupload, .msixbundle, .appx, .appxupload en/of .appxbundle) voor de app die u verzendt. U kunt al uw pakketten voor dezelfde app op deze pagina uploaden. Wanneer een klant uw app downloadt, ontvangt elke klant automatisch het pakket dat het beste werkt voor hun apparaat. Nadat u uw pakketten hebt geüpload, ziet u een tabel die aangeeft welke pakketten worden aangeboden aan specifieke Windows 10- of Windows 11-apparaatfamilies (en eerdere versies van het besturingssysteem, indien van toepassing) in gerangschikte volgorde.

Zie App-pakketvereisten voor meer informatie over wat een pakket bevat en hoe het moet worden gestructureerd. U wilt ook weten hoe versienummers van invloed zijn op welke pakketten aan specifieke klanten worden geleverd en hoe u pakketten voor verschillende scenario's beheert.

Pakketten uploaden naar uw inzending

Als u pakketten wilt uploaden, sleept u ze naar het uploadveld of klikt u om door uw bestanden te bladeren. Op de pagina Pakketten kunt u .msix-, .msixupload-, .msixbundle-, .appx-, .appxupload- en/of .appxbundle-bestanden uploaden.

Belangrijk

Voor Windows 10 en hoger raden we u aan het .msixupload- of .appxupload-bestand hier te uploaden in plaats van .msix, .appx, .msixbundle of .appxbundle. Zie Een UWP-app verpakken met Visual Studio voor meer informatie over het verpakken van UWP-apps voor de Store.

Als u pakketvluchten voor uw app hebt gemaakt, ziet u een vervolgkeuzelijst met de optie om pakketten van een van uw pakketvluchten te kopiëren. Selecteer de pakketvlucht met de pakketten die u wilt ophalen. Vervolgens kunt u een of alle bijbehorende pakketten selecteren die u wilt opnemen in deze inzending.

Als er fouten met een pakket worden gedetecteerd tijdens het valideren, wordt er een bericht weergegeven om u te laten weten wat er mis is. U moet het pakket verwijderen, het probleem oplossen en het vervolgens opnieuw uploaden. U ziet mogelijk ook waarschuwingen die u op de hoogte stellen van problemen die weliswaar problemen kunnen veroorzaken, maar u niet zullen weerhouden door te gaan met uw inzending.

Pakketdetails

Uw geüploade pakketten worden hier weergegeven, gegroepeerd op doelbesturingssysteem. De naam, versie en architectuur van het pakket worden weergegeven. Klik op Details weergeven voor meer informatie, zoals de ondersteunde talen, app-mogelijkheden en bestandsgrootte voor elk pakket.

Als u een pakket uit uw inzending wilt verwijderen, klikt u onder aan de sectie Details van elk pakket op de koppeling Verwijderen.

Redundante pakketten verwijderen

Als we detecteren dat een of meer van uw pakketten overbodig zijn, wordt een waarschuwing weergegeven die aangeeft dat u de redundante pakketten uit deze inzending verwijdert. Dit gebeurt vaak wanneer u eerder pakketten hebt geüpload en nu u pakketten met een hogere versie levert die dezelfde set klanten ondersteunen. In dit geval zouden er geen klanten het redundante pakket krijgen, omdat u nu een beter (hoger versiebeheerd) pakket hebt om deze klanten te ondersteunen.

Wanneer we detecteren dat u redundante pakketten hebt, bieden we een optie om alle redundante pakketten automatisch uit deze inzending te verwijderen. U kunt desgewenst ook pakketten uit de inzending afzonderlijk verwijderen.

Geleidelijke implementatie van pakketten

Als uw inzending een update is voor een eerder gepubliceerde app, ziet u een selectievakje met de melding Update geleidelijk uitrollen nadat deze inzending is gepubliceerd (alleen voor klanten van Windows 10 of Windows 11). Hiermee kunt u een percentage van de klanten selecteren die de pakketten van de indiening ontvangen, zodat u feedback en analysegegevens kunt controleren om er zeker van te zijn dat u vertrouwen hebt in de update voordat u deze breder uitrolt. U kunt het percentage (of de update stoppen) op elk gewenst moment verhogen zonder dat u een nieuwe inzending hoeft te maken.

Zie De geleidelijke implementatie van pakketten voor meer informatie.

Verplichte update

Als uw inzending een update is voor een eerder gepubliceerde app, ziet u een selectievakje met de tekst Deze update verplicht maken. Hiermee kunt u de datum en tijd voor een verplichte update instellen, ervan uitgaande dat u de Windows.Services.Store API's hebt gebruikt om uw app programmatisch te laten controleren op pakketupdates en de bijgewerkte pakketten te downloaden en te installeren. Uw app moet zijn gericht op Windows 10, versie 1607 of hoger om deze optie te kunnen gebruiken.

Zie Pakketupdates voor uw app downloaden en installeren voor meer informatie.

Beschikbaarheid van apparaatfamilies

Nadat uw pakketten zijn geüpload op de pagina Pakketten, wordt in het gedeelte Apparaatfamiliebeschikbaarheid een tabel weergegeven die aangeeft welke pakketten worden aangeboden aan specifieke Windows 10- of Windows 11-apparaatfamilies (en eerdere versies van het besturingssysteem, indien van toepassing), in gerangschikte volgorde. In deze sectie kunt u ook kiezen of u de verzending aan klanten wilt aanbieden voor specifieke Windows 10- of Windows 11-apparaatfamilies.

Opmerking

Als u nog geen pakketten hebt geüpload, worden in de sectie Apparaatfamilies de windows 10- of Windows 11-apparaatfamilies met selectievakjes weergegeven waarmee u kunt aangeven of de verzending wordt aangeboden aan klanten op die apparaatfamilies. De tabel wordt weergegeven nadat u een of meer pakketten hebt geüpload.

Deze sectie bevat ook een selectievakje waarin u kunt aangeven of u Microsoft wilt toestaan om de app beschikbaar te maken voor toekomstige Windows 10- of Windows 11-apparaatfamilies. We raden u aan dit selectievakje ingeschakeld te houden, zodat uw app beschikbaar kan zijn voor meer potentiële klanten wanneer nieuwe apparaatfamilies worden geïntroduceerd.

Kiezen welke apparaatfamilies u wilt ondersteunen

Als u pakketten uploadt die gericht zijn op één afzonderlijke apparaatfamilie, schakelt u het selectievakje in om deze pakketten beschikbaar te maken voor nieuwe klanten op dat type apparaat. Als een pakket bijvoorbeeld is gericht op Windows.Desktop, wordt het vak Windows 10/11 Desktop ingeschakeld voor dat pakket (en u kunt de selectievakjes voor andere apparaatfamilies niet inschakelen).

Pakketten die gericht zijn op de Windows.Universal-apparaatfamilie kunnen worden uitgevoerd op elk Windows 10- of Windows 11-apparaat (inclusief Xbox One). Standaard maken we deze pakketten beschikbaar voor nieuwe klanten op alle apparaattypen, met uitzondering van Xbox.

U kunt het selectievakje voor elke Windows 10- of Windows 11-apparaatfamilie uitschakelen als u uw inzending niet wilt aanbieden aan klanten op dat type apparaat. Als het selectievakje van een apparaatfamilie is uitgeschakeld, kunnen nieuwe klanten op dat type apparaat de app niet verkrijgen (hoewel klanten die de app al hebben, deze nog kunnen gebruiken en eventuele updates ontvangen die u verzendt).

Als uw app deze ondersteunt, raden we u aan alle selectievakjes ingeschakeld te houden, tenzij u een specifieke reden hebt om de typen Windows 10- of Windows 11-apparaten te beperken die uw app kunnen verkrijgen. Als u bijvoorbeeld weet dat uw app geen goede ervaring biedt op Surface Hub en/of Microsoft HoloLens, kunt u het selectievakje Windows 10 Team en/of Windows 10 Holographic uitschakelen. Hiermee voorkomt u dat nieuwe klanten de app op deze apparaten verkrijgen. Als u later besluit dat u deze aan deze klanten wilt aanbieden, kunt u een nieuwe inzending maken met de selectievakjes ingeschakeld.

Xbox-apparaten

De enige Windows 10- of Windows 11-apparaatfamilie die niet standaard wordt gecontroleerd voor Windows.Universal-pakketten is Windows 10 Xbox. Als uw app geen game is (of als het een game is en u het Xbox Live Creators Program hebt ingeschakeld of het conceptgoedkeuringsproces hebt doorlopen) en uw inzending neutraal en/of x64 UWP-pakketten bevat die zijn gecompileerd met Windows 10 SDK-versie 14393 of hoger, kunt u het selectievakje Windows 10 Xbox inschakelen om de app aan klanten op Xbox One te bieden.

Belangrijk

Als u uw app wilt starten op Xbox-apparaten, moet u een neutraal of x64-pakket opnemen dat is gecompileerd met Windows SDK-versie 14393 of hoger. Als u Echter Windows 10 Xbox controleert, wordt uw pakket met de hoogste versie dat van toepassing is op Xbox (dat wil zeggen een neutraal of x64-pakket dat is gericht op de Xbox- of Universal-apparaatfamilie) altijd aangeboden aan klanten op Xbox, zelfs als het is gecompileerd met een eerdere SDK-versie. Daarom is het essentieel om ervoor te zorgen dat het pakket met de hoogste versie dat van toepassing is op Xbox, wordt gecompileerd met Windows SDK-versie 14393 of hoger. Als dit niet het probleem is, ziet u een foutbericht waarin wordt aangegeven dat Xbox-klanten uw app niet kunnen starten.

U kunt deze fout oplossen door een van de volgende handelingen uit te voeren:

• Vervang de toepasselijke pakketten door nieuwe pakketten die zijn gecompileerd met Windows SDK versie 14393 of hoger.
• Als u al een pakket hebt dat Ondersteuning biedt voor Xbox en is gecompileerd met Windows SDK-versie 14393 of hoger, verhoogt u het versienummer zodat het het hoogste versiepakket in de verzending is.
• Schakel het selectievakje voor Windows 10 Xbox uit.

Neem contact op met de ondersteuning als u het probleem nog steeds niet kunt oplossen.

Als u een UWP-app voor Windows 10 IoT Core indient, moet u na het uploaden van uw pakketten geen wijzigingen aanbrengen in de standaardselecties; er is geen afzonderlijk selectievakje voor Windows 10 IoT. Zie Microsoft Store-ondersteuning voor IoT Core UWP-apps voor meer informatie over het publiceren van IoT Core UWP-apps.

Belangrijk

Als u wilt voorkomen dat een specifieke Windows 10- of Windows 11-apparaatfamilie uw inzending ontvangt, werkt u het element TargetDeviceFamily in uw manifest bij om alleen de apparaatfamilie te richten die u wilt ondersteunen (bijvoorbeeld Windows.Desktop), in plaats van het te verlaten als de Windows.Universal-waarde (voor de universele apparaatfamilie) die Microsoft Visual Studio standaard in het manifest bevat.

Het is belangrijk om te weten dat selecties die u maakt in de sectie Beschikbaarheid van apparaatfamilies alleen van toepassing zijn op nieuwe overnames. Iedereen die uw app al heeft, kan deze blijven gebruiken en ontvangt alle updates die u verzendt, zelfs als u hier de apparaatfamilie verwijdert. Dit geldt zelfs voor klanten die uw app hebben aangeschaft voordat ze upgraden naar Windows 10 of Windows 11.

Zie Programmeren met extensie-SDK's voor meer informatie over apparaatfamilies.

Inzicht in classificatie

Behalve dat u kunt aangeven welke Windows 10- of Windows 11-apparaatfamilies uw inzending kunnen downloaden, toont de sectie Beschikbaarheid van apparaatfamilies de specifieke pakketten die beschikbaar worden gesteld aan verschillende apparaatfamilies. Als u meer dan één pakket hebt dat kan worden uitgevoerd op een bepaalde apparaatfamilie, geeft de tabel de volgorde aan waarin pakketten worden aangeboden, op basis van de versienummers van de pakketten. Zie Pakketversienummering voor meer informatie over hoe de Store pakketten rangschikt op basis van versienummers.

Stel dat u twee pakketten hebt: Package_A.appxupload en Package_B.appxupload. Als voor een bepaalde apparaatfamilie Package_A.appxupload 1 is gerangschikt en Package_B.appxupload 2 is, betekent dit dat wanneer een klant op dat type apparaat uw app verkrijgt, de Store eerst probeert Package_A.appxupload te leveren. Als het apparaat van de klant niet in staat is om Package_A.appxupload uit te voeren, zal de Store Package_B.appxupload aanbieden. Als het apparaat van de klant geen pakketten voor die apparaatfamilie kan uitvoeren (bijvoorbeeld als de MinVersion die uw app ondersteunt hoger is dan de versie op het apparaat van de klant), kan de klant de app niet downloaden op dat apparaat.

Opmerking

De versienummers in .xap-pakketten (voor eerder gepubliceerde apps) worden niet meegenomen bij het bepalen van welk pakket een bepaalde klant moet leveren. Als u meer dan één xap-pakket met gelijke rangschikking hebt, ziet u een sterretje in plaats van een getal en kunnen klanten beide pakketten ontvangen. Als u klanten wilt bijwerken van één .xap-pakket naar een nieuwer pakket, moet u ervoor zorgen dat u de oudere .xap in de nieuwe inzending verwijdert.