Delen via

Aan de slag met MAUI en Xamarin

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 App Center .NET SDK in uw app om App Center Analytics en App Center Crashes te gebruiken. Als u App Center Distribueren wilt toevoegen aan uw app, raadpleegt u de documentatie voor App Center Distribute.

1. Vereisten

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

  • Uw project is ingesteld in Visual Studio of Visual Studio voor Mac.
  • U richt zich op apparaten met iOS 11.0 of hoger of Android 5.0 (API-niveau 21) of hoger.
  • U gebruikt geen andere SDK die crashrapportagefunctionaliteit biedt.

Ondersteunde platforms:

  • MAUI iOS
  • MAUI Android
  • MAUI Windows
  • .NET 6.0 macOS
  • Xamarin.Android
  • Xamarin.iOS
  • Xamarin.Mac
  • Xamarin.Forms (iOS-, macOS Android-, UWP- en Windows-bureaubladtoepassingen)

1.1 MAUI

Opmerking

Momenteel is er geen MAUI-platform in de App Center-portal. Gebruik Xamarin voor iOS en Android en UWP voor Windows.

1.2 Over Xamarin.Android

Maak een app in de App Center-portal met Android als het besturingssysteem en Xamarin als het platform.

1.3 Over het Xamarin.iOS

Maak een app in de App Center-portal met iOS als het besturingssysteem en Xamarin als het platform.

1.4 Over Xamarin.Mac

Maak een app in de App Center-portal met macOS als het besturingssysteem en Xamarin als het platform.

Waarschuwing

Er is een bekend probleem waardoor een app niet kan worden geüpload naar de App Store. Volg de voortgang op GitHub.

1.5 Over Xamarin.Forms (iOS, macOS, Android, UWP en Windows Desktop)

Maak 5 apps in het App Center: één voor elk besturingssysteem.

U moet Xamarin selecteren als het platform voor Android-, iOS- en macOS-toepassingen (UWP- en desktoptoepassingen heeft geen Xamarin-optie).

Voor de Windows Desktop - en macOS-toepassingen moet u uw project configureren voor compatibiliteit met het Xamarin.Forms-platform .

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.

  1. Ga naar appcenter.ms.
  2. 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.
  3. Voer een naam en een optionele beschrijving voor uw app in.
  4. Selecteer het juiste besturingssysteem en platform, afhankelijk van uw project, zoals hierboven beschreven.
  5. Klik rechtsonder op de knop met de tekst Nieuwe app toevoegen.

Nadat 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. Voeg de App Center SDK toe aan uw oplossing

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 voor Mac

  • Open Visual Studio.
  • Klik op Bestand>openen en kies uw oplossing.
  • Klik in de oplossingsnavigator met de rechtermuisknop op de sectie Pakketten en kies NuGet-pakketten toevoegen....
  • Zoek naar App Center en selecteer App Center Analytics en App Center Crashes.
  • Klik op Pakketten toevoegen.

Visual Studio voor Windows

  • 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 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.
  • Als u in Visual Studio voor Mac werkt, controleert u of u NuGet Package Management Extensions hebt geïnstalleerd. Hiervoor kiest u Visual Studio>Extensions, zoekt u naar NuGet en installeert u indien nodig.
  • Typ de volgende opdracht in de console:
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 secties Visual Studio voor Mac of Visual Studio voor Windows .

4. 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.

4.1 Voeg de using-instructies toe

Voeg de juiste naamruimten toe in de volgende bestanden:

  • MAUI en Xamarin.Forms - App.xaml.cs
  • Xamarin.iOS en Xamarin.Mac - AppDelegate.cs
  • Xamarin.Android - MainActivity.cs
using Microsoft.AppCenter;
using Microsoft.AppCenter.Analytics;
using Microsoft.AppCenter.Crashes;

4.2 Voeg de Start() methode toe

4.2.1 MAUI en Xamarin.Forms

U moet verschillende toepassingen maken voor elk platform in de App Center-portal. Voor elke app hebt u een ander app-geheim. Open het App.xaml.cs-bestand van het project en voeg de volgende regel toe in de constructor (of in de OnStart() methode voor Xamarin.Forms).

AppCenter.Start("ios={Your App Secret};macos={Your App Secret};android={Your App Secret};uwp={Your App Secret};windowsdesktop={Your App Secret}", typeof(Analytics), typeof(Crashes));

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

  1. Configureer of start het met de App Secret.
  2. Als de code meerdere keren kan worden aangeroepen, controleert u of het App Center al is geconfigureerd.
  3. Start de vereiste service(s) zonder het app-geheim.
AppCenter.Configure("ios={Your App Secret};macos={Your App Secret};android={Your App Secret};uwp={Your App Secret};windowsdesktop={Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics));
    AppCenter.Start(typeof(Crashes));
}

4.2.2 Xamarin.Android

Opmerking

Als u de HockeyApp SDK voor Android gebruikt, zorg ervoor dat u de HockeyApp SDK initialiseert NA de App Center SDK.

Open het MainActivity.cs-bestand van het project en voeg de Start() aanroep toe in de OnCreate() methode

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

Opmerking

Als uw toepassing achtergrondservices of meerdere toegangspunten heeft, zoals een broadcast-ontvanger, geëxporteerde activiteiten of inhoudsproviders, is het raadzaam om in de AppCenter callback te beginnen in plaats daarvan Application.OnCreate.

4.2.3 Xamarin.iOS en Xamarin.Mac

Opmerking

Het is niet mogelijk om meer dan één actieve SDK voor crashrapportage in uw app te hebben. Schakel de crashrapportagefunctionaliteit van de andere SDK's uit om ervoor te zorgen dat App Center de crashes kan opvangen.

Open het projectbestand AppDelegate.cs en voeg de Start() aanroep toe in de FinishedLaunching() methode

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

Opmerking

Als u Crashes gebruikt, moet u deze methode aanroepen in de UI/hoofdthread en voorkomen dat er achtergrondtaken worden gestart totdat de Start methode is voltooid. De reden hiervoor is dat elke null-referentie-exceptie die is gevangen in een andere thread terwijl Crashes wordt geïnitialiseerd, een systeemeigen crash kan veroorzaken en het catch-blok kan negeren. Zodra de AppCenter.Start methode wordt geretourneerd, is het veilig om null-referentie-uitzonderingen opnieuw uit te proberen/te halen. Meer informatie over de oorzaak van dit timingprobleem vindt u in het artikel Signalen en crashrapporters van derden.

Waarschuwing

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

Belangrijk

De accolades geven aan waar de daadwerkelijke geheimen van de app moeten worden geplaatst; plaats geen accolades in de Start oproep.

Opmerking

Voor een iOS-toepassing is het niet mogelijk om meer dan één actieve crash reporting SDK in je app te hebben. Schakel de crashrapportagefunctionaliteit van de andere SDK's uit om ervoor te zorgen dat App Center de crashes kan opvangen.

4.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 zowel App Center Analytics als App Center Crashes opneemt.

Als u geen van de twee services wilt gebruiken, verwijdert u de bijbehorende parameter uit de bovenstaande methodeoproep.

Tenzij u elke module 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 modules die in de eerste aanroep zijn opgenomen, zijn beschikbaar.

Als u bijvoorbeeld onboarding wilt uitvoeren voor App Center Analytics, moet u de Start() aanroep als volgt wijzigen:

4.3.1 MAUI en Xamarin.Forms

AppCenter.Start("ios={Your App Secret};macos={Your App Secret};android={Your App Secret};uwp={Your App Secret};windowsdesktop={Your App Secret}", typeof(Analytics));

4.3.2 Xamarin Native

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

Geweldig, u bent klaar om analyse- en crashesgegevens te visualiseren in de portal die de SDK automatisch 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.

Lees de documentatie van App Center Distribute voor meer informatie over hoe u aan de slag gaat met updates in apps.

Opmerking

Met behulp van de draagbare API's van Xamarin Forms ziet u API's uit alle modules, maar niet al deze API's worden ondersteund op de UWP - en Windows-bureaubladplatformen en doen niets wanneer u uw UWP - en Windows-bureaubladtoepassingen uitvoert. Met name UWP en Windows Desktop bieden geen ondersteuning voor de volgende module: Distribueren. Elke methode met een retourtype retourneert null (voor objecten), 0 (voor getallen) of false (voor booleaanse waarden) in uwp- en Windows-bureaubladtoepassing.

5. Backupregels (alleen Android)

Opmerking

Apps die zijn gericht op Android 6.0 (API-niveau 23) of hoger, hebben automatisch back-up ingeschakeld. 

Opmerking

Als u al een aangepast bestand met back-upregels hebt, schakelt u over naar de derde stap.

Als u automatische back-up gebruikt om onjuiste informatie over apparaten te voorkomen, volgt u de volgende stappen:

5.1. Voor Android 11 (API-niveau 30) of lager.

  1. Maak appcenter_backup_rule.xml bestand in de map Resources/XML .
  1. Open het AndroidManifest.xml-bestand van het project. Voeg het android:fullBackupContent kenmerk toe aan het <application> element. Het moet verwijzen naar het appcenter_backup_rule.xml hulpbestand.
android:fullBackupContent="@xml/appcenter_backup_rule"
  1. Voeg de volgende back-upregels toe aan het appcenter_backup_rule.xml-bestand :
<full-backup-content xmlns:tools="http://schemas.android.com/tools">
      <exclude domain="sharedpref" path="AppCenter.xml"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
      <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
      <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
  </full-backup-content>

5.2. Voor Android 12 (API-niveau 31) of hoger.

  1. Maak appcenter_backup_rule.xml bestand in de map Resources/XML .
  1. Open het AndroidManifest.xml-bestand van het project. Voeg het android:dataExtractionRules kenmerk toe aan het <application> element. Het moet verwijzen naar het appcenter_backup_rule.xml hulpbestand.
android:dataExtractionRules="@xml/appcenter_backup_rule"
  1. Voeg de volgende back-upregels toe aan het appcenter_backup_rule.xml-bestand :
<data-extraction-rules xmlns:tools="http://schemas.android.com/tools">
    <cloud-backup>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </cloud-backup>
    <device-transfer>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </device-transfer>
</data-extraction-rules>