Paketera en skrivbords- eller UWP-app i Visual Studio

Innan du distribuerar din app måste du paketera den. I den här artikeln beskrivs hur du konfigurerar, skapar och testar ett MSIX-paket med hjälp av Visual Studio.

Typer av apppaket

• Apppaket (.msix eller .appx)
  Ett enda paket som innehåller ditt program och dess resurser, som är avsett för en enda enhetsarkitektur. Till exempel ett x64- eller x86-programpaket. Om du vill rikta in dig på flera arkitekturer med ett apppaket behöver du generera en för varje arkitektur.

• Appsamling (.msixbundle eller .appxbundle)
  Ett apppaket är en typ av paket som kan innehålla flera apppaket, som var och en har skapats för att stödja en specifik enhetsarkitektur. Ett apppaket kan till exempel innehålla tre separata apppaket för konfigurationerna x86, x64 och ARM. Apppaket bör genereras när det är möjligt eftersom de gör att din app kan vara tillgänglig på så många olika enheter som möjligt.

• Uppladdningsfil för apppaket (.msixupload eller .appxupload) – endast för butikslämning
  En enda fil som kan innehålla flera apppaket eller ett apppaket som stöder olika processorarkitekturer. Apppaketets uppladdningsfil innehåller också en symbolfil för att analysera appens prestanda när din app har publicerats i Microsoft Store. Den här filen skapas automatiskt åt dig om du paketerar din app med Visual Studio i syfte att skicka den till Partnercenter för publicering till Microsoft Store.

Här är en översikt över stegen för att förbereda och skapa ett apppaket:

1. Innan du paketerar appen. Följ de här stegen för att se till att din app är redo att paketeras.

2. Konfigurera projektet. Använd Visual Studio-manifestdesignern för att konfigurera paketet. Lägg till exempel till panelbilder och välj de orienteringar som appen stöder.

3. Generera ett apppaket. Använd Visual Studio-paketeringsguiden för att skapa ett apppaket.

4. Kör, felsök och testa ett paketerat program. Kör och felsöka ditt apppaket från Visual Studio eller genom att installera paketet direkt.

Innan du paketerar din app

1. Testa din app. Innan du paketera programmet kontrollerar du att det fungerar som förväntat för alla enhetsfamiljer som du planerar att stödja. Dessa enhetsfamiljer kan omfatta stationära, mobila, Surface Hub-, Xbox-, IoT-enheter eller andra. Mer information om hur du distribuerar och testar din app med Visual Studio finns i Distribuera och felsöka UWP-appar (gäller även för paketerade skrivbordsappar).

2. Optimera din app. Du kan använda Visual Studio-profilerings- och felsökningsverktyg för att optimera prestanda för ditt paketerade program. Till exempel tidslinjeverktyget för UI-svarstider, verktyget Minnesanvändning, verktyget CPU-användning med mera. Mer information om dessa verktyg finns i avsnittet Funktionsprofileringstouren.

3. Kontrollera intern .NET-kompatibilitet (för VB- och C#-appar). I Den universella Windows-plattformen finns det en inbyggd kompilator som förbättrar appens körningsprestanda. Med den här ändringen bör du testa appen i den här kompileringsmiljön. Som standard aktiverar versionskonfigurationen den interna .NET-verktygskedjan , så det är viktigt att testa din app med den här versionskonfigurationen och kontrollera att din app fungerar som förväntat.

Konfigurera projektet

Appmanifestfilen (Package.appxmanifest) är en XML-fil som innehåller de egenskaper och inställningar som krävs för att skapa apppaketet. Egenskaper i appmanifestfilen beskriver till exempel den bild som ska användas som panelen i din app och de orienteringar som appen stöder när en användare roterar enheten.

Med Visual Studio-manifestdesignern kan du uppdatera manifestfilen utan att redigera filens råa XML.

Konfigurera ett paket med manifestdesignern

1. I Solution Explorer expanderar du projektnoden för ditt programprojekt.

2. Dubbelklicka på filen Package.appxmanifest. Om manifestfilen redan är öppen i XML-kodvyn uppmanar Visual Studio dig att stänga filen.

3. Nu kan du bestämma hur du ska konfigurera din app. Varje flik innehåller information som du kan konfigurera om din app och länkar till mer information om det behövs.

   

   Kontrollera att du har alla bilder som krävs för en app på fliken Visuella tillgångar . Det är här du skulle tillhandahålla appikoner och logotyper.

   På fliken Paketering kan du ange publiceringsdata. Det är här du kan välja vilket certifikat som ska användas för att signera din app. Alla MSIX-appar måste signeras med ett certifikat.

   Anmärkning

   Från och med Visual Studio 2019 genereras inte längre ett tillfälligt certifikat i paketerade skrivbords- eller UWP-projekt. Om du vill skapa eller exportera certifikat använder du PowerShell-cmdletarna som beskrivs i den här artikeln. I de senaste versionerna av Visual Studio kan du också signera din app med ett certifikat som lagras i Azure Key Vault för utvecklings- och testscenarier.

   Viktigt!

   Om du publicerar din app i Microsoft Store kommer din app att signeras med ett betrott certifikat åt dig. På så sätt kan användaren installera och köra din app utan att installera det associerade certifikatet för appsignering.

   Om du installerar apppaketet på enheten måste du först lita på paketet. För att kunna lita på paketet måste certifikatet vara installerat på användarens enhet.

4. Spara filen Package.appxmanifest när du har gjort nödvändiga ändringar för din app.

Om du distribuerar din app via Microsoft Store kan Visual Studio associera ditt paket med Store. Det gör du genom att högerklicka på projektnamnet i Solution Explorer och välja Publicera->Associera app med Store (innan Visual Studio 2019 version 16.3 hette menyn PubliceraStore). Du kan också göra detta i guiden Skapa apppaket , som beskrivs i följande avsnitt. När du associerar din app uppdateras vissa av fälten på fliken Paketering i manifestdesignern automatiskt.

Generera ett apppaket

Appar kan installeras utan att publiceras i Store genom att publicera dem på din webbplats, med hjälp av programhanteringsverktyg som Microsoft Intune och Configuration Manager osv. Du kan också installera ett MSIX-paket direkt för testning på din lokala dator eller fjärrdator.

Skapa ett apppaket med hjälp av paketeringsguiden

Anmärkning

Följande instruktioner och skärmbilder beskriver processen från och med Visual Studio 2019 version 16.3. Om du använder en tidigare version kan en del av användargränssnittet se annorlunda ut. Om du paketerar ett skrivbordsprogram högerklickar du på noden Windows Application Packaging Project.

1. Öppna lösningen för ditt programprojekt i Solution Explorer.

2. Högerklicka på projektet och välj Publicera-Skapa>apppaket (före Visual Studio 2019 version 16.3 heter menyn Publicerastore).

   

3. Välj Sideloading på den första sidan i guiden och klicka sedan på Nästa.

   

4. På sidan Välj signeringsmetod väljer du om du vill hoppa över paketeringssignering eller välja ett certifikat för signering. Du kan välja ett certifikat från ditt lokala certifikatarkiv, välja en certifikatfil eller skapa ett nytt certifikat. För att ett MSIX-paket ska installeras på en slutanvändares dator måste det signeras med ett certifikat som är betrott på datorn.

   

5. Slutför sidan Välj och konfigurera paket enligt beskrivningen i avsnittet Skapa din apppaketuppladdningsfil med Visual Studio .

Installera ditt apppaket genom att dubbelklicka

Apppaket kan installeras genom att dubbelklicka på appaketfilen. Det gör du genom att gå till apppaketet eller appsamlingsfilen och dubbelklicka på den. App Installer startar och tillhandahåller grundläggande appinformation samt en installationsknapp, installationsförloppsindikator och eventuella relevanta felmeddelanden.

Anmärkning

App Installer förutsätter att paketet signerades med ett certifikat som är betrott på enheten. Om det inte var det måste du installera signeringscertifikatet i lagringen Betrodda personer eller Betrodda utgivares certifieringsmyndigheter på enheten. Om du inte är säker på hur du gör det kan du läsa Installera testcertifikat.

Installera ditt apppaket med hjälp av ett installationsskript

1. Öppna mappen *_Test.

2. Högerklicka på filenAdd-AppDevPackage.ps1 . Välj Kör med PowerShell och följ anvisningarna.
   

   När apppaketet har installerats visas det här meddelandet i PowerShell-fönstret: Appen har installerats.

3. Klicka på startknappen för att söka efter appen efter namn och starta den.

Nästa steg: Felsöka och testa ditt apppaket

Se Köra, felsöka och testa ett apppaket för hur du kan felsöka ditt program i Visual Studio eller med hjälp av Felsökningsverktyg för Windows.

Generera en apppaketuppladdningsfil för inlämning till butiken

För att distribuera din app till Microsoft Store rekommenderar vi att du genererar en fil för uppladdning av apppaket (.msixupload eller .appxupload) och skickar den här filen till Partnercenter. Även om det är möjligt att skicka ett apppaket eller ett apppaket enbart till Partnercenter rekommenderar vi att du skickar en fil för uppladdning av apppaket i stället.

Du kan skapa en apppaketuppladdningsfil med hjälp av guiden Skapa apppaket i Visual Studio, eller så kan du skapa en manuellt från befintliga apppaket eller apppaket.

Anmärkning

Om du vill skapa ett apppaket (.msix or.appx) eller ett apppaket (.msixbundle eller .appxbundle) manuellt läser du Skapa ett apppaket med verktyget MakeAppx.exe.

Skapa din apppaketuppladdningsfil med Visual Studio

Anmärkning

Följande instruktioner och skärmbilder beskriver processen från och med Visual Studio 2019 version 16.3. Om du använder en tidigare version kan en del av användargränssnittet se annorlunda ut.

1. Öppna lösningen för UWP-appprojektet i Solution Explorer.

2. Högerklicka på projektet och välj Publicera-Skapa>apppaket (före Visual Studio 2019 version 16.3 heter menyn Publicerastore). Om det här alternativet är inaktiverat eller inte visas alls kontrollerar du att projektet är ett Universellt Windows-projekt.

   

   Guiden Skapa apppaket visas.

3. Välj Microsoft Store med ett nytt appnamn i den första dialogrutan och klicka sedan på Nästa.

   

   Om du redan har associerat projektet med en app i Store kan du också skapa paket för den associerade Store-appen. Om du väljer Sidladdning genererar Visual Studio inte apppaketets uppladdningsfil (.msixupload eller .appxupload) för Partner Center-inlämningar. Om du bara vill skapa ett MSIX-paket eller en bunt för distribution utanför Store kan du välja det här alternativet.

4. På nästa sida loggar du in med ditt utvecklarkonto till Partnercenter. Om du inte har något utvecklarkonto än hjälper guiden dig att skapa ett.

   

5. Välj appnamnet för ditt paket i listan över appar som för närvarande är registrerade på ditt konto eller reservera ett nytt om du inte redan har reserverat ett i Partnercenter.

   Anmärkning

   Om du använder Visual Studio 2017 kan du inte lista appar som för närvarande är registrerade på ditt konto eller reservera nya appnamn när du använder ett Microsoft-konto (MSA) , endast Azure Active Directory-konton (AAD) fungerar. MSA-konton stöds från och med Visual Studio 2019.

6. Se till att du väljer alla tre arkitekturkonfigurationerna (x86, x64 och ARM) i dialogrutan Välj och konfigurera paket för att säkerställa att din app kan distribueras till det bredaste utbudet av enheter. I listrutan Generera apppaket väljer du Alltid. Ett apppaket (.appxbundle eller .msixbundle) föredras framför en enda appaketfil eftersom den innehåller en samling apppaket som konfigurerats för varje typ av processorarkitektur. När du väljer att generera apppaketet inkluderas apppaketet i den slutliga apppaketuppladdningsfilen (.appxupload eller .msixupload) tillsammans med felsökning och kraschanalysinformation. Om du är osäker på vilken eller vilka arkitekturer som ska väljas, eller om du vill veta mer om vilka arkitekturer som används av olika enheter, kan du läsa Apppaketarkitekturer.

   

7. Inkludera offentliga symbolfiler för att analysera appprestanda från Partnercenter när din app har publicerats. Konfigurera eventuell ytterligare information, till exempel versionsnumrering eller paketets utdataplats.

8. Klicka på Skapa för att generera apppaketet. Om du valde något av alternativen Jag vill skapa paket för att ladda upp till Microsoft Store i steg 3 och skapar ett paket för att skicka till Partner Center, kommer guiden att skapa en paketuppladdningsfil (.appxupload eller .msixupload). Om du har valt Jag vill skapa paket för sidladdning i steg 3 skapar guiden antingen ett enda apppaket eller en appbunt baserat på dina val i steg 6.

9. När din app har paketerats visas den här dialogrutan och du kan hämta din apppaketuppladdningsfil från den angivna utdataplatsen. Nu kan du verifiera ditt apppaket på den lokala datorn eller en fjärrdator och automatisera lagringsöverföringar.

   

Skapa din apppaketuppladdningsfil manuellt

1. Placera följande filer i en mapp:

   • Ett eller flera apppaket (.msix eller .appx) eller ett apppaket (.msixbundle eller .appxbundle).
   • En .appxsym-fil. Det här är en komprimerad .pdb-fil som innehåller offentliga symboler för din app som används för kraschanalys i Partnercenter. Du kan utelämna den här filen, men om du gör det blir ingen kraschanalys eller felsökningsinformation tillgänglig för din app.

2. Markera alla filer i mappen, högerklicka på filerna och välj Skicka till ->Komprimerad (zippad) mapp.

3. Ändra den nya zip-filens tilläggsnamn från .zip till .msixupload eller .appxupload.

Verifiera ditt apppaket

Verifiera din app innan du skickar den till Partnercenter för certifiering på en lokal eller fjärransluten dator. Du kan bara validera versionsversioner för ditt apppaket, inte felsökningsversioner. Mer information om hur du skickar din app till Partnercenter finns i Appöverföringar.

Verifiera ditt apppaket lokalt

1. På den sista sidan Om paketet har skapats i guiden Skapa apppaket låter du alternativet Lokal dator vara valt och klickar på Starta Windows App Certification Kit. Mer information om hur du testar din app med Windows App Certification Kit finns i Windows App Certification Kit.

   Windows App Certification Kit (WACK) utför olika tester och returnerar resultatet. Mer specifik information finns i Windows App Certification Kit-tester .

   Om du har en fjärransluten Windows 10-enhet som du vill använda för testning måste du installera Windows App Certification Kit manuellt på den enheten. I nästa avsnitt går vi igenom de här stegen. När du har gjort det kan du välja Fjärrdator och klicka på Starta Windows App Certification Kit för att ansluta till fjärrenheten och köra valideringstesterna.

2. När WACK har slutförts och din app har godkänts är du redo att skicka din app till Partnercenter. Se till att du laddar upp rätt fil. Standardplatsen för filen finns i rotmappen för din lösning \[AppName]\AppPackages och slutar med filtillägget .appxupload eller .msixupload. Namnet kommer att vara i formuläret [AppName]_[AppVersion]_x86_x64_arm_bundle.appxupload eller [AppName]_[AppVersion]_x86_x64_arm_bundle.msixupload om du valde ett apppaket med hela paketarkitekturen vald.

Verifiera ditt apppaket på en fjärransluten Windows 10-enhet

1. Aktivera din Windows 10-enhet för utveckling genom att följa anvisningarna aktivera enheten för utveckling .

   Viktigt!

   Du kan inte verifiera apppaketet på en fjärransluten ARM-enhet för Windows 10.

2. Ladda ned och installera fjärrverktygen för Visual Studio. Dessa verktyg används för att fjärrköra Windows App Certification Kit. Du kan få mer information om dessa verktyg, inklusive var du kan ladda ned dem genom att besöka Kör MSIX-program på en fjärrdator.

3. Ladda ned det nödvändiga Certifieringspaketet för Windows-appar och installera det sedan på din fjärranslutna Windows 10-enhet.

4. På sidan Slutförd paketgenerering i guiden väljer du alternativknappen Fjärrdator och väljer sedan ellipsknappen bredvid knappen Testa anslutning .

   Anmärkning

   Alternativknappen Fjärrdator är endast tillgänglig om du har valt minst en lösningskonfiguration som stöder validering. Mer information om hur du testar din app med WACK finns i Windows App Certification Kit.

5. Ange ett enhetsformulär i undernätet eller ange DNS-namnet (Domain Name Server) eller IP-adressen för en enhet som är utanför undernätet.

6. I listan Autentiseringsläge väljer du Ingen om enheten inte kräver att du loggar in på den med dina Windows-autentiseringsuppgifter.

7. Välj knappen Välj och välj sedan knappen Starta Windows App Certification Kit . Om fjärrverktygen körs på enheten ansluter Visual Studio till enheten och utför sedan valideringstesterna. Se tester för Windows App Certification Kit.

Automatisera butiksinlämningar

Från och med Visual Studio 2019 kan du skicka den genererade .appxupload-filen till Microsoft Store direkt från IDE genom att välja alternativet Skicka automatiskt till Microsoft Store efter validering av Windows App Certification Kit i slutet av guiden Skapa apppaket. Den här funktionen använder Azure Active Directory för att få åtkomst till den partnercenterkontoinformation som behövs för att publicera din app. Om du vill använda den här funktionen behöver du associera Azure Active Directory med ditt Partnercenter-konto och hämta flera autentiseringsuppgifter som krävs för inlämningar.

Associera Azure Active Directory med ditt Partnercenter-konto

Innan du kan hämta de autentiseringsuppgifter som krävs för automatiska Store-inlämningar måste du först följa dessa steg på instrumentpanelen i Partnercenter om du inte redan har gjort det.

1. Associera ditt Partnercenter-konto med organisationens Azure Active Directory. Om din organisation redan använder Office 365 eller andra företagstjänster från Microsoft har du redan Azure AD. Annars kan du skapa en ny Azure AD-klient från Partnercenter utan extra kostnad.

2. Lägg till ett Azure AD-program till ditt partnercenterkonto. Det här Azure AD-programmet representerar den app eller tjänst som du kommer att använda för att få åtkomst till inlämningar för ditt Dev Center-konto. Du måste tilldela det här programmet till rollen Ansvarig. Om det här programmet redan finns i din Azure AD-katalog kan du välja det på sidan Lägg till Azure AD-program för att lägga till det i ditt Dev Center-konto. Annars kan du skapa ett nytt Azure AD-program på sidan Lägg till Azure AD-program .

Hämta de autentiseringsuppgifter som krävs för inlämningar

Därefter kan du hämta de autentiseringsuppgifter för Partnercenter som krävs för inlämningar: Azure-klient-ID, klient-ID och klientnyckeln.

1. Gå till instrumentpanelen i Partnercenter och logga in med dina Azure AD-autentiseringsuppgifter.

2. På instrumentpanelen i Partnercenter väljer du kugghjulsikonen (i det övre högra hörnet på instrumentpanelen) och väljer sedan Utvecklarinställningar.

3. I menyn Inställningar i den vänstra rutan klickar du på Användare.

4. Klicka på namnet på ditt Azure AD-program för att gå till programmets inställningar. På den här sidan kopierar du värdena klient-ID och klient-ID .

5. I avsnittet Nycklar klickar du på Lägg till ny nyckel. På nästa skärm kopierar du nyckelvärdet , vilket motsvarar klienthemligheten. Du kommer inte att kunna komma åt den här informationen igen när du har lämnat den här sidan, så se till att inte förlora den. Mer information finns i Hantera nycklar för ett Azure AD-program.

Konfigurera automatiska butiksinskick i Visual Studio

När du har slutfört föregående steg kan du konfigurera automatiska Store-inlämningar i Visual Studio 2019.

1. I slutet av guiden Skapa apppaket väljer du Skicka automatiskt till Microsoft Store efter validering av Windows App Certification Kit och klickar på Konfigurera om.

2. I dialogrutan Konfigurera inställningar för inlämning av Microsoft Store anger du azure-klient-ID, klient-ID och klientnyckel.

   

   Viktigt!

   Dina autentiseringsuppgifter kan sparas i din profil som ska användas i framtida inskickningar

3. Klicka på OK.

Sändningen startar när WACK-testet har slutförts. Du kan spåra inskickningsframsteg i fönstret Verifiera och publicera.