Aan de slag met tvOS

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 app Center tvOS SDK in uw app om App Center Analytics en App Center Crashes te gebruiken.

1. Vereisten

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

• Uw tvOS is ingesteld in Xcode 13 of hoger op tvOS versie 11 of hoger.
• U gebruikt geen andere bibliotheek die crashrapportagefunctionaliteit biedt.

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 tvOS 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

Het App Center SDK voor tvOS kan worden geïntegreerd in uw app 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 om App Center Analytics en App Center crashes in uw app op te nemen.

   # 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 tvOSuit. 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 bestanden AppCenter.framework, AppCenterAnalytics.framework en AppCenterCrashes.framework uit de map Carthage/Build/tvOS 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 om App Center Analytics en App Center Crashes in te stellen voor uw tvOS-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.

   • Als best practice bevinden bibliotheken van derden zich meestal in een submap (dit wordt vaak Leverancier genoemd), dus als u uw project niet hebt georganiseerd met een submap voor bibliotheken, 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 submappen verwijderen die u niet nodig hebt.

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, ervoor te zorgen dat deze wordt toegevoegd aan uw project, anders werken de andere modules 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 tvOS-frameworkconventie. De reden hiervoor is dat de App Center SDK voor tvOS geen conventioneel framework is, maar een statisch framework. Je moet het koppelen als een statisch framework: zorg ervoor dat je de binaries niet insluit en deze niet opneemt in de bouwfase 'copy bundle resources'.

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 expliciet aanroepen bij het starten van de SDK.

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])

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 opgeeft als parameter 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])

---

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.