Kom igång med iOS

2025-05-06

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.

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

Du hittar information om data som samlas in av App Center om data som samlas in av App Center SDK:er, allmänna dataskyddsförordningar och sidor med vanliga frågor och svar . Vanliga frågor och svar innehåller också svaren, som du behöver ange för appbutikens sekretesskonfiguration.

Låt oss börja med att konfigurera App Center iOS SDK i din app för att använda App Center Analytics och App Center Crashes. Om du vill lägga till App Center-distribution i din app kan du titta på dokumentationen för App Center-distribution.

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 (endast för App Center-krascher).
Om du använder CocoaPods för att integrera App Center behöver du CocoaPods version 1.10 eller senare.

App Center SDK-analyser och kraschrapporter är kompatibla med Mac Catalyst via XCFramework eller SwiftPM.

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.

Gå över till appcenter.ms.
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.
Ange ett namn och en valfri beskrivning för din app.
Välj iOS som operativsystem och Objective-C/Swift som plattform.
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 iOS kan läggas till i din app via Cocoapods, Carthage, Swift Package Manager eller genom att lägga till binärfilerna manuellt 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

Anmärkning

ARM64-simulatorer (när de startas från Xcode som körs på Apple Silicon Mac) stöds inte via CocoaPods, överväg att använda andra integreringsmetoder för att det ska fungera.

Lägg till följande beroenden till podfile för att inkludera App Center Analytics och App Center Crashes i din app. Den här åtgärden hämtar följande ramverk: AppCenter, AppCenterAnalytics och AppCenterCrashes. I stället kan du ange tjänster som du vill använda i din app. Varje tjänst har en egen underart och de förlitar sig alla på AppCenter. Den dras in automatiskt.
```
 # Use the following line to use App Center Analytics and Crashes.x
 pod 'AppCenter'

 # Use the following lines if you want to specify which service you want to use.
 pod 'AppCenter/Analytics'
 pod 'AppCenter/Crashes'
 pod 'AppCenter/Distribute'
```
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.

Anmärkning

Carthage-integrering fungerar inte direkt i Xcode 12. För att få det att fungera, se den här Carthage-instruktionen

Lägg till följande beroenden i Cartfile för att inkludera App Center. Dessa beroenden drar in alla ramverk. Sedan kan du bara länka de ramverk som du vill använda 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

Kör carthage update för att hämta beroenden till mappen Carthage/Checkouts . Skapa sedan varje ramverk.
Ö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/iOS 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.
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

På Xcode-menyn klickar du på Fil > Swift-paket > Lägg till paketberoende.
I dialogrutan som visas anger du lagringsplatsens URL: https://github.com/microsoft/appcenter-sdk-apple.git.
I Version väljer du Upp till nästa större och använder standardalternativet.
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 iOS-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.

Ladda ned App Center SDK-ramverken som tillhandahålls som en zip-fil.
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.
[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.
Ö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.
Lägg till SDK-ramverken i projektet i Xcode:
- Kontrollera att Projektnavigatorn är synlig (⌘+1).
- Dra nu och släpp AppCenter.framework, AppCenterAnalytics.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 appen kompileras inte.
- En dialogruta visas och kontrollera att appmålet är markerat. Klicka sedan på Slutför.

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 väljer du de moduler som du vill använda. Som standard startas inga moduler och du måste anropa var och en när du startar SDK:n.

Anvisningarna nedan skiljer sig något beroende på vilken livscykel du använder. Från och med Xcode 12 kan du välja en av två livscykeler: "Swift UI App" (vald som standard i Xcode 12) och "UI Kit AppDelegate". Om du utvecklar för ett tillägg kan du läsa sidan Komma igång med tillägget.

4.1 Lägg till importinstruktionerna

Öppna projektets AppDelegate-fil (för UI Kit AppDelegate-livscykeln) eller <ProjectName>App.swift-filen (för Swift UI App-livscykeln) 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

UI Kit AppDelegate

Lägg till initieringskod i didFinishLaunchingWithOptions ombudsmetoden:

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

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

Swift UI-applivscykel

För att se till att App Center SDK fungerar korrekt med Swift-användargränssnittet initierar du det när användargränssnittet har lästs in. Det enklaste sättet att uppnå detta är genom att använda UIApplicationDelegate:

class AppDelegate: NSObject, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
          AppCenter.start(withAppSecret: "{Your App Secret}", services:[
            Crashes.self, Analytics.self, Distribute.self])
        return true
    }
}

UIApplicationDelegateAdaptor Använd sedan i struct:

@main
struct YourAppName: App {

  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

Om du har ett Catalyst-program kan du skicka apphemligheter för både iOS och macOS samtidigt:

AppCenter.start(withAppSecret:"ios={Your iOS App Secret};macos={Your macOS 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:

Konfigurera eller starta den med apphemligheten.
Om koden kan anropas flera gånger kontrollerar du om App Center redan har konfigurerats.
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.

Såvida du inte uttryckligen 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 om App Center Analytics och dokumentationen om App Center Crashes för att lära dig hur du anpassar och använder mer avancerade funktioner i båda tjänsterna.

Mer information om hur du kommer igång med uppdateringar i appen finns i dokumentationen för App Center Distribute.

Dela via

Kom igång med iOS

1. Förutsättningar

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

3. Lägg till App Center SDK-modulerna

3.1 Integrering via CocoaPods

3.2 Integrering via Karthage

3.3 Integrering via Swift Package Manager

3.4 Integrering genom att kopiera binärfilerna till projektet

4. Starta SDK

4.1 Lägg till importinstruktionerna

4.2 Lägg till start:withServices: metoden

UI Kit AppDelegate

Swift UI-applivscykel

4.3 Ersätt platshållaren med din apphemlighet

Feedback

Ytterligare resurser

4.2 Lägg till `start:withServices:` metoden