Aan de slag met macOS

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.

• Android
• Ios
• iOS-extensies
• React Native
• MAUI/Xamarin
• UWP
• WPF/WinForms
• Eenheid
• MacOS
• macOS-extensies
• tvOS

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 macOS SDK in uw app voor het gebruik van App Center Analytics en App Center-crashes.

1. Vereisten

Aan de volgende vereisten moet worden voldaan om de App Center SDK te kunnen gebruiken:

• Uw macOS-project is ingesteld in Xcode 13 of hoger op macOS versie 10.14.4 of hoger.
• U richt zich op apparaten die worden uitgevoerd op macOS 10.13 of hoger.
• U gebruikt geen andere bibliotheek die crashrapportagefunctionaliteit biedt.

Opmerking

App Center SDK zal de ondersteuning voor Xcode 10 laten vallen met de SDK-release van juni.

App Center SDK Analytics en Crashes zijn compatibel met Mac Catalyst via XCFramework of SwiftPM.

App Center SDK is compatibel met Apple Silicon.

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 macOS als het besturingssysteem en Objective-C/Swift als platform.
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. De App Center SDK-modules toevoegen

De App Center SDK voor macOS kan aan uw app worden toegevoegd via Cocoapods, Carthage, Swift Package Manager of door de binaire bestanden handmatig aan uw project toe te voegen.

Opmerking

In de 4.0.0 versie van App Center zijn belangrijke wijzigingen geïntroduceerd. Volg de sectie Migreren naar App Center SDK 4.0.0 en hoger om App Center te migreren vanuit eerdere versies.

3.1 Integratie via Cocoapods

1. Voeg de volgende afhankelijkheden toe aan uw podfile om App Center Analytics en App Center crashes in uw app op te nemen. Dit haalt de volgende frameworks op: AppCenter, AppCenterAnalytics en AppCenterCrashes. In plaats daarvan kunt u opgeven welke services u in uw app wilt gebruiken. Elke service heeft een eigen subspec en ze zijn allemaal afhankelijk van AppCenter. Het wordt automatisch binnengehaald.

    # Use the following line to use App Center Analytics and Crashes.
    pod 'AppCenter'
   
    # Use the following lines if you want to specify which service you want to use.
    pod 'AppCenter/Analytics'
    pod 'AppCenter/Crashes'
   

2. Voer pod install uit om uw nieuw gedefinieerde pod te installeren en het project te .xcworkspaceopenen.

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

3.2 Integratie via Carthage

Hieronder vindt u de stappen voor het integreren van de App Center SDK in uw Xcode-project met behulp van Carthage versie 0.30 of hoger, een gedecentraliseerde afhankelijkheidsmanager die uw afhankelijkheden bouwt en u voorziet van binaire frameworks.

1. Voeg de volgende afhankelijkheden toe aan uw Cartfile app om App Center op te nemen in uw app. Dit haalt alle frameworks op. Vervolgens kunt u alleen de frameworks koppelen die u in uw app wilt gebruiken.

   # Use the following line to get the latest version of App Center
   github "microsoft/appcenter-sdk-apple"
   

   # Use the following line to get the specific version of App Center
   github "microsoft/appcenter-sdk-apple" ~> X.X.X
   

2. Voer carthage update --platform macOSuit. Hiermee worden afhankelijkheden opgehaald in een Carthage/Checkouts map, en worden vervolgens de frameworks gebouwd.

3. Open het tabblad Algemene instellingen van uw toepassingsdoel. Sleep en zet de AppCenter.framework, AppCenterAnalytics.framework, en AppCenterCrashes.framework-bestanden uit de map Carthage/Build/macOS neer in de Project Navigator van Xcode. AppCenter.framework is noodzakelijk om de SDK te kunnen starten. Als deze niet aan het project wordt toegevoegd, werken de andere modules niet en wordt uw app niet gecompileerd.

4. Er wordt een dialoogvenster weergegeven, controleer of het app-doel is ingeschakeld. Klik vervolgens op Voltooien.

   Opmerking

   Als u in de carthage copy-frameworks gebruikt, moet u de App Center SDK's daar niet toevoegen, omdat ze als statische frameworks worden verzonden.

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

3.3 Integratie via Swift Package Manager

1. Klik in het Xcode-menu op Bestand > Swift-pakketten > Pakketafhankelijkheid toevoegen.
2. Voer in het dialoogvenster dat wordt weergegeven de URL van de opslagplaats in: https://github.com/microsoft/appcenter-sdk-apple.git.
3. Selecteer in VersieTot de volgende grote versie en kies de standaardoptie.
4. Kies de modules die u nodig hebt in de kolom Pakketproduct .

Nu u de frameworks 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 App Center integreert via SwiftPM en het ook wilt gebruiken in de extensie-target van uw app, moet u ervoor zorgen dat u deze in uw configuratie opgeeft DISABLE_DIAMOND_PROBLEM_DIAGNOSTIC=YES . Dit is nodig om SwiftPM-beperkingen te voorkomen bij het koppelen van een module aan meerdere doelen.

3.4 Integratie door de binaire bestanden naar uw project te kopiëren

Hieronder ziet u de stappen voor het integreren van de gecompileerde binaire bestanden in uw Xcode-project voor het instellen van App Center Analytics en App Center Crashes voor uw macOS-app.

Opmerking

App Center SDK ondersteunt het gebruik van XCframework. Als u XCframeworks wilt integreren in uw project, downloadt u de AppCenter-SDK-Apple-XCFramework.zip van de releasepagina en pakt u het uit. De resulterende mapinhoud is niet platformspecifiek, maar bevat XCframeworks voor elke module. Ze kunnen op dezelfde manier worden geïntegreerd als gebruikelijke frameworks, zoals hieronder wordt beschreven.

1. Download de Sdk-frameworks van App Center die zijn geleverd als een zip-bestand.

2. Pak het bestand uit en u ziet een map met de naam AppCenter-SDK-Apple met verschillende frameworks voor elke App Center-service op elke platformmap. Het aangeroepen AppCenter framework is vereist in het project omdat het code bevat die wordt gedeeld tussen de verschillende modules.

3. [Optioneel] Maak een submap voor bibliotheken van derden.

   • Bibliotheken van derden bevinden zich meestal in een submap (dit wordt vaak Leverancier genoemd), dus als uw project geen submap voor bibliotheken gebruikt, maakt u nu een submap van de leverancier .
   • Maak een groep met de naam Vendor in uw Xcode-project om de bestandsstructuur op schijf na te bootsen.

4. Open de uitgepakte map AppCenter-SDK-Apple in Finder en kopieer de map naar de map van uw project op de gewenste locatie. De map bevat frameworks in submappen voor andere platforms die door App Center SDK worden ondersteund, dus mogelijk moet u overbodige submappen verwijderen.

5. Voeg de SDK-frameworks toe aan het project in Xcode:

   • Controleer of projectnavigator zichtbaar is (⌘+1).
   • Sleep en zet nu AppCenter.framework, AppCenterAnalytics.framework en AppCenterCrashes.framework vanuit de Finder (de bestanden in de map Vendor) naar de projectnavigator van Xcode. AppCenter.framework is vereist om de SDK te starten. Als de andere modules ontbreken, werkt dit niet en wordt uw app niet gecompileerd.
   • Er wordt een dialoogvenster weergegeven, controleer of het app-doel is ingeschakeld. Klik vervolgens op Voltooien.

Opmerking

Het binaire SDK-bestand wordt niet verpakt volgens de macOS-frameworkconventie. De reden hiervoor is dat de App Center SDK voor Mac geen conventioneel framework is, maar een statisch framework. U moet het koppelen als een statisch framework: zorg ervoor dat u de binaire bestanden niet insluit en deze niet opneemt in de buildfase 'bundelbronnen kopiëren'.

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

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 aanroepen bij het starten van de SDK. Als u bezig bent met de ontwikkeling van een extensie, raadpleegt u de pagina Aan de slag met Extensies.

4.1 De importverklaringen toevoegen

Open het AppDelegate-bestand van het project en voeg de volgende importinstructies toe:

@import AppCenter;
@import AppCenterAnalytics;
@import AppCenterCrashes;

import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

4.2 Voeg de start:withServices: methode toe

Voeg de volgende regel in de gedelegeerde methode van de app didFinishLaunchingWithOptions in:

[MSACAppCenter start:@"{Your App Secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];

AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self, Crashes.self])

Als u een Katalysator-toepassing hebt, kunt u app-geheimen voor zowel iOS als macOS tegelijkertijd doorgeven:

[MSACAppCenter start:@"ios={Your iOS App Secret};macos={Your macOS App Secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];

AppCenter.start(withAppSecret:"ios={Your iOS App Secret};macos={Your macOS App Secret}", services: [Analytics.self, Crashes.self])

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:

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.

[MSACAppCenter configureWithAppSecret:@"{Your App Secret}"];
if ([MSACAppCenter isConfigured]) {
   [MSACAppCenter startService:[MSACAnalytics class]];
   [MSACAppCenter startService:[MSACCrashes class]];
}

AppCenter.configure(withAppSecret: "{Your App Secret}")
if AppCenter.isConfigured {
    AppCenter.startService(Analytics.self)
    AppCenter.startService(Crashes.self)
}

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:withServices methode (start(withAppSecret:services:) voor Swift) 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. start:withServices De API (start(withAppSecret:services:)voor Swift) kan ook slechts eenmaal worden gebruikt in de levenscyclus van uw app. Alle andere aanroepen melden een waarschuwing aan de console en alleen de modules die zijn opgenomen in de eerste aanroep, zijn beschikbaar.

Als u bijvoorbeeld onboarding wilt uitvoeren voor App Center Analytics, moet u de start:withServices API-aanroep (start(withAppSecret:services:) voor Swift) als volgt wijzigen:

[MSACAppCenter start:@"{Your App Secret}" withServices:@[[MSACAnalytics class]]];

AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self])

4.4 Internetmogelijkheden toevoegen voor sandbox-apps

Als uw app gebruikmaakt van de app-sandbox, moet u de mogelijkheid instellen om uitgaande verbindingen (Client) toe te staan zodat de app toegang heeft tot internet. Xcode 9 maakt de app-sandbox standaard mogelijk, maar de mogelijkheden voor uitgaande verbindingen moeten expliciet worden ingesteld.

Selecteer uw project in de projectnavigator, selecteer het tabblad Mogelijkheden en schakel uitgaande verbindingen in als uw app gebruikmaakt van de sandbox.

---

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 geavanceerde functies van elke service.