Kom igång med tvOS

Viktigt!

Visual Studio App Center drogs tillbaka den 31 mars 2025, förutom analys- och diagnostikfunktionerna, som fortsätter att stödjas fram till den 30 juni 2026. Läs mer.

• Android
• Ios
• iOS-tillägg
• React Native
• MAUI/Xamarin
• UWP
• WPF/WinForms
• Enhet
• macOS
• macOS-tillägg
• tvOS

App Center SDK använder en modulär arkitektur så att du kan använda alla eller alla tjänster.

Låt oss börja med att installera App Center tvOS SDK i din app för att använda App Center Analytics och App Center Crashes.

1. Förutsättningar

Följande krav måste uppfyllas för att använda App Center SDK:

• Din tvOS har konfigurerats i Xcode 13 eller senare på tvOS version 11 eller senare.
• Du använder inte något annat bibliotek som tillhandahåller funktioner för kraschrapportering.

2. Skapa din app i App Center-portalen för att hämta apphemligheten

Om du redan har skapat din app i App Center-portalen kan du hoppa över det här steget.

1. Gå över till appcenter.ms.
2. Registrera dig eller logga in och tryck på den blå knappen i det övre högra hörnet i portalen där det står Lägg till ny och välj Lägg till ny app på den nedrullningsbara menyn.
3. Ange ett namn och en valfri beskrivning för din app.
4. Välj tvOS som operativsystem och Objective-C/Swift som plattform.
5. Tryck på knappen längst ned till höger där det står Lägg till ny app.

När du har skapat en app kan du hämta dess apphemlighet på sidan Inställningar på App Center-portalen. I det övre högra hörnet på sidan Inställningar klickar du på de tre lodräta punkterna och väljer Copy app secret att hämta din apphemlighet.

3. Lägg till App Center SDK-modulerna

App Center SDK för tvOS kan integreras i din app via Cocoapods, Carthage, Swift Package Manager eller genom att manuellt lägga till binärfilerna i projektet.

Anmärkning

I versionen 4.0.0 av App Center introducerades störande ändringar. Följ avsnittet Migrera till App Center SDK 4.0.0 och senare för att migrera App Center från tidigare versioner.

3.1 Integrering via CocoaPods

1. Lägg till följande beroenden till podfile för att inkludera App Center Analytics och App Center Crashes i din app. Detta hämtar följande ramverk: AppCenter, AppCenterAnalytics och AppCenterCrashes. I stället kan du ange vilka tjänster du vill använda i din app. Varje tjänst har en egen subspecifikation och alla förlitar sig på AppCenter. Den dras in automatiskt.

    # 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. Kör pod install för att installera din nyligen definierade podd och öppna projektets .xcworkspace.

Nu när du har integrerat ramverken i ditt program är det dags att starta SDK och använda App Center-tjänsterna.

3.2 Integrering via Karthage

Nedan visas stegen för hur du integrerar App Center SDK i ditt Xcode-projekt med hjälp av Carthage version 0.30 eller senare, en decentraliserad beroendehanterare som skapar dina beroenden och ger dig binära ramverk.

1. Lägg till följande beroenden till Cartfile för att inkludera App Center Analytics och App Center Crashes i din app.

   # 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. Kör carthage update --platform tvOS. Detta hämtar beroenden till mappen Carthage/Checkouts och skapar sedan varje ramverk.

3. Öppna fliken Allmänna inställningar för programmålet. Dra och släpp AppCenter.framework-, AppCenterAnalytics.framework- och AppCenterCrashes.framework-filer från mappen Carthage/Build/tvOS till Xcodes Project Navigator. AppCenter.framework krävs för att starta SDK:et. Om det inte läggs till i projektet fungerar inte de andra modulerna och appen kompileras inte.

4. En dialogruta visas och kontrollera att appmålet är markerat. Klicka sedan på Slutför.

   Anmärkning

   Om du använder carthage copy-frameworks i byggfasen bör du inte lägga till App Center SDK:er där eftersom de levereras som statiska ramverk.

Nu när du har integrerat ramverken i ditt program är det dags att starta SDK och använda App Center-tjänsterna.

3.3 Integrering via Swift Package Manager

1. På Xcode-menyn klickar du på Fil > Swift-paket > Lägg till paketberoende.
2. I dialogrutan som visas anger du lagringsplatsens URL: https://github.com/microsoft/appcenter-sdk-apple.git.
3. I Version väljer du Upp till nästa större och använder standardalternativet.
4. Välj de moduler du behöver i kolumnen Paketprodukt .

Nu när du har integrerat ramverken i ditt program är det dags att starta SDK och använda App Center-tjänsterna.

Anmärkning

Om du integrerar App Center via SwiftPM och även vill använda det i appens tilläggsmål, se till att du anger DISABLE_DIAMOND_PROBLEM_DIAGNOSTIC=YES i konfigurationen. Detta är nödvändigt för att undvika SwiftPM-begränsningar när det gäller att länka en modul till flera mål.

3.4 Integrering genom att kopiera binärfilerna till projektet

Nedan visas stegen för hur du integrerar de kompilerade binärfilerna i Xcode-projektet för att konfigurera App Center Analytics- och App Center-krascher för din tvOS-app.

Anmärkning

App Center SDK stöder användning av XCframework. Om du vill integrera XCframeworks i projektet laddar du ned AppCenter-SDK-Apple-XCFramework.zip från lanseringssidan och packar upp den. Det resulterande mappinnehållet är inte plattformsspecifikt, utan innehåller I stället XCframeworks för varje modul. De kan integreras på samma sätt som vanliga ramverk, enligt beskrivningen nedan.

1. Ladda ned App Center SDK-ramverken som tillhandahålls som en zip-fil.

2. Packa upp filen så ser du en mapp med namnet AppCenter-SDK-Apple som innehåller olika ramverk för varje App Center-tjänst på varje plattformsmapp. Ramverket som anropas AppCenter krävs i projektet eftersom det innehåller kod som delas mellan de olika modulerna.

3. [Valfritt] Skapa en underkatalog för bibliotek från tredje part.

   • Som bästa praxis finns bibliotek från tredje part vanligtvis i en underkatalog (det kallas ofta leverantör), så om du inte har ditt projekt organiserat med en underkatalog för bibliotek skapar du nu en leverantörsunderkatalog .
   • Skapa en grupp med namnet Leverantör i Xcode-projektet för att efterlikna filstrukturen på disken.

4. Öppna den uppackade mappen AppCenter-SDK-Apple i Finder och kopiera mappen till projektets mapp på den plats där du vill ha den. Mappen innehåller ramverk i undermappar för andra plattformar som App Center SDK stöder, så du kan behöva ta bort undermappar som du inte behöver.

5. Lägg till SDK-ramverken i projektet i Xcode:

   • Kontrollera att Projektnavigatorn är synlig (⌘+1).
   • Dra och släpp nu AppCenter.framework, AppCenterAnalytics.framework och AppCenterCrashes.framework från Finder (de i mappen Leverantör ) till Xcodes Project Navigator. AppCenter.framework krävs för att starta SDK:t, se till att det läggs till i projektet, annars fungerar inte de andra modulerna och appen kompileras inte.
   • En dialogruta visas och kontrollera att appmålet är markerat. Klicka sedan på Slutför.

Anmärkning

SDK-binärfilen paketeras inte enligt tvOS-ramverkskonventionen. Anledningen är att App Center SDK för tvOS inte är ett konventionellt ramverk utan ett statiskt ramverk. Du måste länka det som ett statiskt ramverk: Se till att du inte bäddar in binärfilerna och ta inte med dem i byggfasen "kopiera paketresurser".

Nu när du har integrerat ramverken i ditt program är det dags att starta SDK och använda App Center-tjänsterna.

4. Starta SDK

Om du vill använda App Center måste du välja de moduler som du vill använda. Som standard startas inga moduler och du måste uttryckligen anropa var och en av dem när du startar SDK:n.

4.1 Lägg till importinstruktionerna

Öppna projektets AppDelegate-fil och lägg till följande importinstruktioner:

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

import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

4.2 Lägg till start:withServices: metoden

Infoga följande rad i appens didFinishLaunchingWithOptions delegatemetod:

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

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

Varning

Vi rekommenderar inte att du bäddar in din apphemlighet i källkoden.

Om du behöver starta App Center-tjänster separat bör du:

1. Konfigurera eller starta den med apphemligheten.
2. Om koden kan anropas flera gånger kontrollerar du om App Center redan har konfigurerats.
3. Starta de nödvändiga tjänsterna utan apphemligheten.

[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 Ersätt platshållaren med din apphemlighet

Ersätt {Your App Secret} text med det faktiska värdet för ditt program. Apphemligheten finns på sidan Komma igång eller på sidan Inställningar i App Center-portalen.

Sidan Komma igång innehåller kodexemplet ovan med din apphemlighet i. Du kan kopiera och klistra in hela exemplet.

Exemplet ovan visar hur du använder start:withServices metoden (start(withAppSecret:services:) för Swift) och inkluderar både App Center Analytics- och App Center-krascher.

Om du inte vill använda någon av de två tjänsterna tar du bort motsvarande parameter från metodanropet ovan.

Om du inte anger varje modul som en parameter i startmetoden kan du inte använda den App Center-tjänsten. Api:et start:withServices (start(withAppSecret:services:) för Swift) kan också endast användas en gång i appens livscykel – alla andra anrop loggar en varning till konsolen och endast modulerna som ingår i det första anropet är tillgängliga.

Till exempel – Om du vill registrera dig för App Center Analytics bör du ändra API-anropet start:withServices (start(withAppSecret:services:) för Swift) enligt följande:

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

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

---

Bra, du är redo att visualisera analys- och kraschdata på portalen som SDK:et samlar in automatiskt.

Titta på dokumentationen för App Center Analytics och App Center Crashes för att lära dig hur du anpassar och använder mer avancerade funktioner i tjänsterna.