Delen via

Aan de slag met iOS-extensies

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.

Toepassingsextensies bieden alleen ondersteuning voor crashrapportage.

Raadpleeg de documentatie voor Aan de slag met App Center iOS voor meer informatie over het toevoegen van de App Center SDK aan uw container-app.

Laten we aan de slag gaan met het instellen van App Center iOS SDK in uw app-extensie om App Center Crashes te gebruiken.

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.

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 iOS 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.

Opmerking

Het gebruik van een bestaand app-geheim uit een ander iOS-project heeft bijwerkingen. App Center biedt geen ondersteuning voor filteren op project in dezelfde App Center-toepassing. Als u bijvoorbeeld crashes voor een bepaalde versie vermeldt, worden alle crashes van beide projecten voor deze versie zonder onderscheid weergegeven. Het kan verwarrend zijn.

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. De App Center SDK-modules toevoegen

De App Center SDK kan worden geïntegreerd in uw app via Cocoapods, Carthage of door de binaire bestanden handmatig aan uw project toe te voegen.

3.1 Integratie via Cocoapods

  1. Voeg de volgende afhankelijkheden toe aan uw podfile om App Center Crashes toe te voegen aan uw app. Dit haalt de volgende frameworks op: AppCenter en AppCenterCrashes.

     pod 'AppCenter/Crashes'

  2. 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.

  1. Voeg de volgende afhankelijkheden toe aan uw Cartfile app om App Center op te nemen in uw app. Dit haalt alle frameworks op. Vervolgens kunt u alleen deze frameworks koppelen die u in uw app kunt 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

  2. Voer carthage updateuit. 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 en AppCenterCrashes.framework uit de map Carthage/Build/ 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 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

  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-crashes in te stellen voor uw app-extensie.

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

  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 en AppCenterCrashes.framework vanuit de Finder (op de locatie van de vorige stap) in het Project Navigator in 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-extensie niet gecompileerd.
    • Er wordt een dialoogvenster weergegeven, controleer of het doel van de app-extensie is ingeschakeld. Klik vervolgens op Voltooien.

Nu u de frameworks in uw app-extensie 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 voor 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

Voeg de volgende regels in het bestand in met het toegangspunt van de app-extensie. Bijvoorbeeld in het hoofdbestand ViewController van de extensie Today.

@import AppCenter;
@import AppCenterCrashes;

import AppCenter
import AppCenterCrashes

4.2 Voeg de start:withServices: methode toe

Voeg de volgende regel in het toegangspunt van de app-extensie in. Bijvoorbeeld in de viewDidLoad methode van het main ViewController-bestand van de extensie Today.

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

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

Momenteel wordt alleen crashrapportage ondersteund voor toepassingsextensies.

4.3 Vervang de tijdelijke aanduiding door uw app-geheim

Zorg ervoor dat u de tekst {Your App Secret} vervangt door de daadwerkelijke waarde voor uw toepassingsextensie. 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.

Geweldig, u bent helemaal klaar om crashgegevens te visualiseren op de portal die de SDK automatisch verzamelt.

Bekijk de documentatie voor App Center Crashes voor meer informatie over het aanpassen van uw app-extensie en het gebruik van meer geavanceerde functies.