Aan de slag met iOS

2025-05-05

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.

De App Center SDK maakt gebruik van een modulaire architectuur, zodat u alle of alle services kunt gebruiken.

U vindt informatie over gegevens die door App Center worden verzameld op gegevens die zijn verzameld door App Center SDK's, algemene verordening gegevensbescherming en pagina's met veelgestelde vragen . Veelgestelde vragen bevatten ook de antwoorden die u moet opgeven voor de privacyconfiguratie van de App Store.

Laten we aan de slag gaan met het instellen van app Center iOS SDK in uw app voor het gebruik van App Center Analytics en App Center-crashes. Als u App Center Distribueren aan uw app wilt toevoegen, raadpleegt u de documentatie voor App Center Distribueren.

1. Vereisten

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

Uw iOS-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 ios 11.0 of hoger.
U gebruikt geen andere bibliotheek die crashrapportagefunctionaliteit biedt (alleen voor Crashes in App Center).
Als u CocoaPods gebruikt om App Center te integreren, hebt u CocoaPods versie 1.10 of hoger nodig.

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

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.

Ga naar appcenter.ms.
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.
Voer een naam en een optionele beschrijving voor uw app in.
Selecteer iOS als het besturingssysteem en Objective-C/Swift als platform.
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 iOS kan worden toegevoegd aan uw app via Cocoapods, Freshpods, 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

Opmerking

ARM64-simulators (wanneer deze worden gestart vanaf Xcode die wordt uitgevoerd op Apple Silicon Mac) worden niet ondersteund via CocoaPods, kunt u overwegen om andere integratiemethoden te gebruiken om deze te laten werken.

Voeg de volgende afhankelijkheden toe aan uw podfile om App Center Analytics en App Center crashes in uw app op te nemen. Met deze actie worden de volgende frameworks opgehaald: AppCenter, AppCenterAnalytics en AppCenterCrashes. In plaats daarvan kunt u services opgeven die u wilt gebruiken in uw app. 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.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'
```
Voer pod install uit om uw nieuw gedefinieerde pod te installeren en het project te .xcworkspaceopenen.

Opmerking

Als u een fout ziet zoals [!] Unable to find a specification for `AppCenter` tijdens het uitvoeren van pod install, voert u pod repo update uit om de meest recente pods op te halen uit de Cocoapods-opslagplaats en voert u vervolgens pod install uit.

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.

Opmerking

De integratie van Intune werkt niet in Xcode 12. Als u het werk wilt maken, raadpleegt u deze Handleiding van De Carthaag

Voeg de volgende afhankelijkheden toe aan uw Cartfile om App Center te omvatten. Deze afhankelijkheden brengen alle frameworks binnen. 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

Voer carthage update uit om afhankelijkheden op te halen in een map Carthage/Checkouts. Bouw vervolgens elk framework.
Open het tabblad Algemene instellingen van uw toepassingsdoel. Sleep de bestanden AppCenter.framework, AppCenterAnalytics.framework en AppCenterCrashes.framework uit de map Carthage/Build/iOS naar 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.
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 worden verzonden als statische frameworks.

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

Klik in het Xcode-menu op Bestand > Swift-pakketten > Pakketafhankelijkheid toevoegen.
Voer in het dialoogvenster dat wordt weergegeven de URL van de opslagplaats in: https://github.com/microsoft/appcenter-sdk-apple.git.
Selecteer in VersieTot de volgende grote versie en kies de standaardoptie.
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 iOS-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.

Download de Sdk-frameworks van App Center die zijn geleverd als een zip-bestand.
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.
[Optioneel] Maak een submap voor bibliotheken van derden.
- Als richtlijn bevinden bibliotheken van derden zich meestal in een submap, vaak Vendor genoemd. Als het project niet is geordend met een submap voor bibliotheken, maakt u nu een leveranciersubmap.
- Maak een groep met de naam Vendor in uw Xcode-project om de bestandsstructuur op schijf na te bootsen.
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.
Voeg de SDK-frameworks toe aan het project in Xcode:
- Controleer of projectnavigator zichtbaar is (⌘+1).
- Versleep nu AppCenter.framework, AppCenterAnalytics.framework en AppCenterCrashes.framework vanuit de Finder (op de locatie uit de vorige stap) naar 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.
- Er wordt een dialoogvenster weergegeven, controleer of het app-doel is ingeschakeld. Klik vervolgens op Voltooien.

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, meldt u zich aan bij de module(s) die u wilt gebruiken. Standaard worden er geen modules gestart en moet u elke module aanroepen bij het starten van de SDK.

De onderstaande instructies verschillen enigszins, afhankelijk van de levenscyclus die u gebruikt. Vanaf Xcode 12 kunt u een van de twee levenscycluss selecteren: 'Swift UI App' (standaard geselecteerd in Xcode 12) en UI Kit AppDelegate. 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 (voor de levenscyclus van UI Kit AppDelegate) of <het ProjectName>App.swift-bestand (voor de levenscyclus van de Swift UI-app) 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

UI Kit AppDelegate

Initialisatiecode toevoegen aan didFinishLaunchingWithOptions delegate-methode:

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

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

Levenscyclus van Swift UI-app

Als u wilt controleren of de App Center SDK correct werkt met de Swift-gebruikersinterface, initialiseert u deze nadat de gebruikersinterface is geladen. De eenvoudigste manier om dit te bereiken is door de UIApplicationDelegate te gebruiken:

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

Gebruik vervolgens UIApplicationDelegateAdaptor in struct.

@main
struct YourAppName: App {

  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

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

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

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:

Configureer of start het met de App Secret.
Als de code meerdere keren kan worden aangeroepen, controleert u of het App Center al is geconfigureerd.
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 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 geavanceerdere functies van beide services.

Lees de documentatie van App Center Distribute voor meer informatie over hoe u aan de slag gaat met updates in apps.

Delen via

Aan de slag met iOS

1. Vereisten

2. Maak uw app in de App Center-portal om het app-geheim te verkrijgen

3. De App Center SDK-modules toevoegen

3.1 Integratie via Cocoapods

3.2 Integratie via Carthage

3.3 Integratie via Swift Package Manager

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

4. Start de SDK

4.1 De importverklaringen toevoegen

4.2 Voeg de start:withServices: methode toe

UI Kit AppDelegate

Levenscyclus van Swift UI-app

4.3 Vervang de tijdelijke aanduiding door uw app-geheim

Feedback

Aanvullende resources

4.2 Voeg de `start:withServices:` methode toe