Aan de slag met UWP/WinUI

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:

Voor UWP-project:

Uw project is ingesteld in Visual Studio 2017 Update 15.9 of hoger.
U richt zich op apparaten met Windows 10 build 16299 of hoger.
Uw project verwijst naar Universal Windows Platform 6.2.8 of hoger (dit pakket wordt doorgaans impliciet naar verwezen).
NuGet 4.3 of hoger.

Voor WinUI-project:

Uw project is ingesteld in Visual Studio 2019 Update 16.9 of hoger.
U richt zich op apparaten met Windows 10 build 17763 of hoger.
Uw project verwijst naar WinUI 3 0.8.0 of hoger.

Opmerking

Als u Xamarin.Forms voor UWP wilt gebruiken, volgt u de Xamarin Getting started-documentatie in plaats van deze.

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.

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

Nu u de SDK in uw toepassing hebt geïntegreerd, is het tijd om de SDK te starten en gebruik te maken van de App Center-services.

Opmerking

Als u de App Center SDK gebruikt in een draagbaar project (zoals Xamarin.Forms), moet u de pakketten in elk van de projecten installeren: de draagbare, Android- en iOS-pakketten. Hiervoor moet u elk subproject openen en de bijbehorende stappen volgen die worden beschreven in de sectie Visual Studio .

4. De mogelijkheid toevoegen `Internet (Client)`

Dubbelklik in Visual Studio Solution Explorer op het bestand Package.appxmanifest voor uw toepassing. Klik op het tabblad Mogelijkheden en controleer vervolgens de mogelijkheid internet (client).

5. Start de SDK

Als u App Center wilt gebruiken, moet u zich aanmelden 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.

5.1 Voeg de using-instructies toe

Voeg de juiste naamruimten toe voordat u onze API's gebruikt.

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

5.2 Voeg de `Start()` methode toe

Voeg de volgende aanroep toe aan de constructor van uw toepassing:

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)); 
}

5.3 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 Analytics te visualiseren in de portal waarop de SDK automatisch gegevens verzamelt.

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