Dela via

Kom igång med iOS-tillägg

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.

Programtillägg stöder endast kraschrapportering.

Mer information om hur du lägger till App Center SDK i containerappen finns i dokumentationen för Komma igång med App Center iOS.

Nu kommer vi igång med att konfigurera App Center iOS SDK i din apptillägg för att använda App Center Crashes-modul.

1. Förutsättningar

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

  • Ditt iOS-projekt har konfigurerats i Xcode 13 eller senare på macOS version 10.14.4 eller senare.
  • Du riktar in dig på enheter som körs på ios 11.0 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 iOS 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.

Anmärkning

Att använda en befintlig apphemlighet från ett annat iOS-projekt har biverkningar. App Center stöder inte filtrering efter projekt i samma App Center-program. Om du till exempel anger krascher för en viss version visas alla krascher från båda projekten för den här versionen utan åtskillnad. Det kan vara förvirrande.

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. Lägg till App Center SDK-modulerna

App Center SDK kan integreras i din app via Cocoapods, Carthage eller genom att manuellt lägga till binärfilerna i projektet.

3.1 Integrering via CocoaPods

  1. Lägg till följande beroenden i din podfile för att inkludera App Center Crashes i din app. Detta hämtar följande ramverk: AppCenter och AppCenterCrashes.

     pod 'AppCenter/Crashes'

  2. Kör pod install för att installera din nyligen definierade podd och öppna projektets .xcworkspace.

Anmärkning

Om du ser ett fel som [!] Unable to find a specification for `AppCenter` när du kör pod installkör du pod repo update för att hämta de senaste poddarna från Cocoapods-lagringsplatsen och kör pod installsedan .

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 i din Cartfile för att lägga till App Center i din app. Detta hämtar alla ramverk. Sedan kan du bara länka de ramverk som ska användas 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. 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 - och AppCenterCrashes.framework-filer från mappen Carthage/Build/ 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:erna 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-krascher för apptillägget.

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.

    • Bästa praxis är att bibliotek från tredje part vanligtvis finns i en underkatalog, ofta kallad Leverantör. Om projektet inte är 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 och AppCenterCrashes.framework från Finder (på platsen från föregående steg) 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 apptillägget kompileras inte.
    • En dialogruta visas och kontrollera att målet för apptillägget är markerat. Klicka sedan på Slutför.

Nu när du har integrerat ramverken i apptillägget är det dags att starta SDK:et 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 ska användas. 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

Infoga följande rader i filen som innehåller apptilläggets startpunkt. Till exempel i huvudfilen ViewController i ett Today-tillägg.

@import AppCenter;
@import AppCenterCrashes;

import AppCenter
import AppCenterCrashes

4.2 Lägg till start:withServices: metoden

Infoga följande rad i apptilläggets startpunkt. Till exempel i viewDidLoad metoden för den huvudsakliga ViewController-filen i ett Today-tillägg.

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

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

För närvarande stöds endast kraschrapportering för programtillägg.

4.3 Ersätt platshållaren med din apphemlighet

Ersätt {Your App Secret} text med det faktiska värdet för programtillägget. 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.

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

Titta på dokumentationen för App Center Crashes för att lära dig att anpassa apptillägget och använda mer avancerad funktionalitet.