Kom igång med UWP/WinUI

2025-05-06

Viktigt!

Visual Studio App Center drogs tillbaka den 31 mars 2025, förutom analys- och diagnostikfunktionerna, som fortsätter att stödjas fram till den 30 juni 2026. Läs mer.

App Center SDK använder en modulär arkitektur så att du kan använda alla eller alla tjänster.

Låt oss börja med att konfigurera App Center SDK i din app för att använda App Center Analytics och App Center Crashes.

1. Förutsättningar

Innan du börjar kontrollerar du att följande krav uppfylls:

För UWP-projekt:

Projektet har konfigurerats i Visual Studio 2017 Update 15.9 eller senare.
Du riktar in dig på enheter som kör Windows 10 build 16299 eller senare.
Projektet refererar till Universal Windows Platform 6.2.8 eller senare (det här paketet refereras vanligtvis implicit).
NuGet 4.3 eller senare.

För WinUI-projekt:

Projektet har konfigurerats i Visual Studio 2019 Update 16.9 eller senare.
Du riktar in dig på enheter som kör Windows 10 build 17763 eller senare.
Projektet refererar till WinUI 3 0.8.0 eller senare.

Anmärkning

Om du vill använda Xamarin.Forms för UWP följer du dokumentationen för att komma igång med Xamarin i stället för den här.

2. Skapa din app i App Center-portalen för att hämta apphemligheten

Om du redan har skapat din app i App Center-portalen kan du hoppa över det här steget.

Registrera dig eller logga in och tryck på den blå knappen i det övre högra hörnet i portalen där det står Lägg till ny och välj Lägg till ny app på den nedrullningsbara menyn.
Ange ett namn och en valfri beskrivning för din app.
Välj rätt operativsystem och plattform beroende på ditt projekt enligt beskrivningen ovan.
Tryck på knappen längst ned till höger där det står Lägg till ny app.

När du har skapat en app kan du hämta dess apphemlighet på sidan Inställningar på App Center-portalen. I det övre högra hörnet på sidan Inställningar klickar du på de tre lodräta punkterna och väljer Copy app secret för att hämta din apphemlighet.

3. Lägg till App Center SDK-modulerna

App Center SDK kan integreras med Visual Studio eller Package Manager-konsolen.

Visual Studio

Öppna Visual Studio.
Klicka på Öppna fil> och välj din lösning.
Högerklicka på Referenser i lösningsnavigatorn och välj Hantera NuGet-paket.
På fliken Bläddra söker du efter App Center och installerar paketen Microsoft.AppCenter.Analytics och Microsoft.AppCenter.Crashs .

Package Manager-konsolen

Öppna konsolen i Visual Studio. Det gör du genom att välja Verktyg>NuGet-pakethanteraren>Paketkonsol.
Skriv följande kommandon:

Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

Nu när du har integrerat SDK:et i ditt program är det dags att starta SDK och använda App Center-tjänsterna.

Anmärkning

Om du använder App Center SDK i ett portabelt projekt (till exempel Xamarin.Forms) måste du installera paketen i vart och ett av projekten: portabla, Android och iOS. För att göra det bör du öppna varje underprojekt och följa motsvarande steg som beskrivs i Visual Studio-avsnittet .

4. Lägg till funktionen `Internet (Client)`

Dubbelklicka på filen Package.appxmanifest för ditt program i Solution Explorer i Visual Studio. Klicka på fliken Funktioner och kontrollera sedan funktionen Internet (klient ).

5. Starta SDK

Om du vill använda App Center måste du välja de moduler som du vill använda. Som standard startas inga moduler och du måste uttryckligen anropa var och en av dem när du startar SDK:n.

5.1 Lägg till användningsdirektiven

Lägg till lämpliga namnområden innan du använder våra API:er.

using Microsoft.AppCenter;
using Microsoft.AppCenter.Analytics;
using Microsoft.AppCenter.Crashes;

5.2 Lägg till `Start()` metoden

Lägg till följande anrop till programmets konstruktor:

AppCenter.Start("{Your App Secret}", typeof(Analytics), typeof(Crashes));

Varning

Vi rekommenderar inte att du bäddar in din apphemlighet i källkoden.

Om du behöver starta App Center-tjänster separat bör du:

Konfigurera eller starta den med apphemligheten.
Om koden kan anropas flera gånger kontrollerar du om App Center redan har konfigurerats.
Starta de nödvändiga tjänsterna utan apphemligheten.

AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

5.3 Ersätt platshållaren med din apphemlighet

Ersätt {Your App Secret} text med det faktiska värdet för ditt program. Apphemligheten finns på sidan Komma igång eller på sidan Inställningar i App Center-portalen.

Sidan Komma igång innehåller kodexemplet ovan med din apphemlighet i. Du kan kopiera och klistra in hela exemplet.

Exemplet ovan visar hur du använder metoden Start() och inkluderar App Center Analytics.

Såvida du inte uttryckligen anger varje tjänst som parametrar i startmetoden kan du inte använda den App Center-tjänsten. Dessutom kan API:et Start() endast användas en gång i appens livscykel – alla andra anrop loggar en varning till konsolen och endast de tjänster som ingår i det första anropet är tillgängliga.

Utmärkt, du är helt redo att visualisera analys på portalen som SDK samlar in data till automatiskt.

Titta på dokumentationen för App Center Analytics och App Center Crashes för att lära dig hur du anpassar och använder mer avancerade funktioner i tjänsterna.

Dela via