Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
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:
- Projektet riktar sig antingen till .NET Framework 4.6.2 (eller senare) eller .NET Core 3.1 (eller senare).
- .NET Core stöds endast när WPF/WinForms-programmet körs i Windows.
- Om du använder SDK:t från ett portabelt bibliotek måste det riktas mot .NET Standard 2.0 eller senare (PCL stöds inte).
- PackageReference-projekttyp. Det här kravet kommer från
SQLitePCL.raw
biblioteket. Mer information finns på https://github.com/ericsink/SQLitePCL.raw/issues/537. - Det finns ett känt problem när du integrerar SDK:t i VSTO-projekt. Mer information finns i https://github.com/microsoft/appcenter-sdk-dotnet/issues/1583/.
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.
Anmärkning
App Center SDK använder starkt namngivna sammansättningar för kompatibilitet med program som använder starkt namngivet tecken.
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
Anmärkning
Om du använder App Center SDK i ett portabelt projekt måste du installera paketen i vart och ett av projekten: den bärbara datorn och projektet som kör WPF/WinForms-appen. För att göra det bör du öppna varje underprojekt och följa motsvarande steg som beskrivs i Visual Studio-avsnittet .
4. Starta SDK
Om du vill använda App Center väljer du 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.
4.1 Lägg till Start()
metoden
WPF (Windows Presentation Foundation)
För WPF-applikationen, ändra App.xaml.cs
och lägg till följande using-satser:
using Microsoft.AppCenter;
using Microsoft.AppCenter.Analytics;
using Microsoft.AppCenter.Crashes;
Lägg sedan till följande kod i metoden i OnStartup
samma fil:
AppCenter.Start("{Your App Secret}", typeof(Analytics), typeof(Crashes));
App.xaml.cs
Om filen inte har OnStartup
metoden kan du lägga till Application.OnStartup(StartupEventArgs)
metoden. Filen App.xaml.cs
bör se ut ungefär så här:
public partial class App : Application
{
protected override void OnStartup(StartupEventArgs e)
{
base.OnStartup(e);
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));
}
WinForms
För ditt WinForms-program ändrar du Program.cs
filen och lägger till följande med hjälp av -instruktioner:
using Microsoft.AppCenter;
using Microsoft.AppCenter.Analytics;
using Microsoft.AppCenter.Crashes;
Lägg sedan till följande kod i metoden Main
i samma fil, före instruktionen Application.Run
.
AppCenter.Start("{Your App Secret}", typeof(Analytics), typeof(Crashes));
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));
}
Varning
Vi rekommenderar inte att du bäddar in din apphemlighet i källkoden.
4.2 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.
Perfekt, du är redo att visualisera krascher på portalen som SDK:et samlar in 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.