Aan de slag met WPF/WinForms

2025-05-05

Belangrijk

Visual Studio App Center is op 31 maart 2025 buiten gebruik gesteld, met uitzondering van de functies analyse en diagnose, die tot 30 juni 2026 nog steeds worden ondersteund. Meer informatie.

De App Center SDK maakt gebruik van een modulaire architectuur, zodat u alle of alle services kunt gebruiken.

Laten we aan de slag gaan met het instellen van de App Center SDK in uw app voor het gebruik van App Center Analytics en App Center Crashes.

1. Vereisten

Voordat u begint, moet u ervoor zorgen dat aan de volgende vereisten wordt voldaan:

Uw project is gericht op .NET Framework 4.6.2 (of hoger) of .NET Core 3.1 (of hoger).
.NET Core wordt alleen ondersteund wanneer de WPF-/WinForms-toepassing wordt uitgevoerd in Windows.
Als u de SDK uit een draagbare bibliotheek gebruikt, moet deze gebruikmaken van .NET Standard 2.0 of hoger (PCL wordt niet ondersteund).
PackageReference-projecttype. Deze vereiste is afkomstig uit SQLitePCL.raw de bibliotheek. Meer informatie op https://github.com/ericsink/SQLitePCL.raw/issues/537.
Er is een bekend probleem bij het integreren van de SDK in VSTO-projecten. Ga voor meer informatie naar https://github.com/microsoft/appcenter-sdk-dotnet/issues/1583/.

2. Maak uw app in de App Center-portal om het app-geheim te verkrijgen

Als u uw app al hebt gemaakt in de App Center-portal, kunt u deze stap overslaan.

Meld u aan of meld u aan en klik op de blauwe knop in de rechterbovenhoek van de portal met de tekst Nieuwe toevoegen en selecteer Nieuwe app toevoegen in de vervolgkeuzelijst.
Voer een naam en een optionele beschrijving voor uw app in.
Selecteer het juiste besturingssysteem en platform, afhankelijk van uw project, zoals hierboven beschreven.
Klik rechtsonder op de knop met de tekst Nieuwe app toevoegen.

Zodra u een app hebt gemaakt, kunt u het app-geheim ophalen op de pagina Instellingen in de App Center-portal. Klik in de rechterbovenhoek van de pagina Instellingen op de drie verticale puntjes en selecteer Copy app secret om uw app-geheim op te halen.

3. De App Center SDK-modules toevoegen

De App Center SDK kan worden geïntegreerd met Visual Studio of de Package Manager-console.

Opmerking

App Center SDK maakt gebruik van sterk benoemde assembly's voor compatibiliteit met toepassingen die gebruikmaken van een sterkbenoemde signatuur.

Visual Studio

Open Visual Studio.
Klik op Bestand>openen en kies uw oplossing.
Klik in de oplossingsnavigator met de rechtermuisknop op Verwijzingen en kies NuGet-pakketten beheren.
Zoek op het tabblad Bladeren naar App Center en installeer Microsoft.AppCenter.Analytics en Microsoft.AppCenter.Crashes-pakketten .

Pakketbeheerconsole

Open de console in Visual Studio. Hiervoor kiest u Tools>NuGet Package Manager>Package Manager Package Manager Console.
Typ de volgende opdrachten:

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

Opmerking

Als u de App Center SDK in een draagbaar project gebruikt, moet u de pakketten in elk van de projecten installeren: de draagbare en het project waarop de WPF/WinForms-app wordt uitgevoerd. Hiervoor moet u elk subproject openen en de bijbehorende stappen volgen die worden beschreven in de sectie Visual Studio .

4. Start de SDK

Als u App Center wilt gebruiken, meldt u zich aan bij de module(s) die u wilt gebruiken. Standaard worden er geen modules gestart en moet u deze expliciet aanroepen bij het starten van de SDK.

4.1 Voeg de `Start()` methode toe

WPF (Windows Presentation Foundation)

Voor uw WPF-toepassing wijzigt u het App.xaml.cs volgende en voegt u het volgende toe met behulp van instructies:

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

Voeg vervolgens in hetzelfde bestand de volgende code toe in de OnStartup methode:

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

Als het App.xaml.cs bestand niet over de OnStartup methode beschikt, kunt u de Application.OnStartup(StartupEventArgs) methode toevoegen. Uw App.xaml.cs bestand moet er ongeveer als volgt uitzien:

public partial class App : Application
{
    protected override void OnStartup(StartupEventArgs e)
    {
      base.OnStartup(e);
      AppCenter.Start("{Your App Secret}", typeof(Analytics), typeof(Crashes));
    }
  }
}

Waarschuwing

Het is niet raadzaam om uw app-geheim in te sluiten in de broncode.

Als u App Center-services afzonderlijk moet starten, moet u het volgende doen:

Configureer of start het met de App Secret.
Als de code meerdere keren kan worden aangeroepen, controleert u of het App Center al is geconfigureerd.
Start de vereiste service(s) zonder het app-geheim.

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

WinForms

Wijzig het Program.cs bestand voor uw WinForms-toepassing en voeg het volgende toe met behulp van instructies:

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

Voeg vervolgens in hetzelfde bestand de volgende code toe aan de Main methode vóór de Application.Run instructie.

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

Als u App Center-services afzonderlijk moet starten, moet u het volgende doen:

Configureer of start het met de App Secret.
Als de code meerdere keren kan worden aangeroepen, controleert u of het App Center al is geconfigureerd.
Start de vereiste service(s) zonder het app-geheim.

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

Waarschuwing

Het is niet raadzaam om uw app-geheim in te sluiten in de broncode.

4.2 Vervang de tijdelijke aanduiding door uw app-geheim

Zorg ervoor dat u de {Your App Secret} tekst vervangt door de werkelijke waarde voor uw toepassing. Het app-geheim vindt u op de pagina Aan de slag of instellingen op de portal van App Center.

De pagina Aan de slag bevat het bovenstaande codevoorbeeld met uw app-geheim. U kunt het hele voorbeeld kopiëren en plakken.

In het bovenstaande voorbeeld ziet u hoe u de Start() methode gebruikt en App Center Analytics bevat.

Tenzij u elke service expliciet opgeeft als parameters in de startmethode, kunt u die App Center-service niet gebruiken. Bovendien kan de Start() API slechts eenmaal worden gebruikt in de levenscyclus van uw app. Alle andere aanroepen melden een waarschuwing aan de console en alleen de services die zijn opgenomen in de eerste aanroep, zijn beschikbaar.

Geweldig, u bent klaar om crashes in de portal te visualiseren die automatisch door de SDK worden verzameld.

Bekijk de documentatie voor App Center Analytics en App Center Crashes voor meer informatie over het aanpassen en gebruiken van meer geavanceerde functies van beide services.

Delen via