Condividi tramite

Introduzione alle estensioni iOS

Importante

Visual Studio App Center è stato ritirato il 31 marzo 2025, ad eccezione delle funzionalità di Analisi e diagnostica, che continueranno a essere supportate fino al 30 giugno 2026. Ulteriori informazioni.

Le estensioni dell'applicazione supportano solo la segnalazione di arresti anomali.

Per informazioni su come aggiungere App Center SDK all'app contenitore, vedere la documentazione relativa alle attività iniziali di App Center per iOS.

Cominciamo con la configurazione dell'SDK di App Center iOS nell'estensione dell'app per utilizzare i crash di App Center.

1. Prerequisiti

Per usare App Center SDK, è necessario soddisfare i requisiti seguenti:

  • Il progetto iOS è configurato in Xcode 13 o versione successiva in macOS versione 10.14.4 o successiva.
  • La destinazione è i dispositivi in esecuzione in ios 11.0 o versione successiva.
  • Non si usa alcuna altra libreria che fornisce funzionalità di creazione di report di arresto anomalo del sistema.

2. Creare l'app nel portale di App Center per ottenere il segreto dell'app

Se l'app è già stata creata nel portale di App Center, è possibile ignorare questo passaggio.

  1. Vai a appcenter.ms.
  2. Iscriversi o accedere e premere il pulsante blu nell'angolo in alto a destra del portale che indica Aggiungi nuovo e selezionare Aggiungi nuova app dal menu a discesa.
  3. Immettere un nome e una descrizione facoltativa per l'app.
  4. Selezionare iOS come sistema operativo e Objective-C/Swift come piattaforma.
  5. Premere il pulsante in basso a destra che indica Aggiungi nuova app.

Dopo aver creato un'app, è possibile ottenere il segreto dell'app nella pagina Impostazioni del portale di App Center. Nell'angolo in alto a destra della pagina Impostazioni fare clic sui punti verticali tripli e selezionare Copy app secret per ottenere il segreto dell'app.

Annotazioni

L'uso di un segreto dell'app esistente da un altro progetto iOS può avere conseguenze indesiderate. App Center non supporta il filtro in base al progetto nella stessa applicazione App Center. Ad esempio, elencare gli arresti anomali per una determinata versione elenca tutti gli arresti anomali di entrambi i progetti per questa versione senza distinzione. Può creare confusione.

Annotazioni

4.0.0 Nella versione di App Center sono state introdotte modifiche di rilievo. Seguire la sezione Eseguire la migrazione ad App Center SDK 4.0.0 e versioni successive per eseguire la migrazione di App Center dalle versioni precedenti.

3. Aggiungere i moduli di App Center SDK

App Center SDK può essere integrato nell'app tramite Cocoapods, Carthage o aggiungendo manualmente i file binari al progetto.

3.1 Integrazione tramite Cocoapods

  1. Aggiungi le seguenti dipendenze al tuo podfile per includere i crash di App Center nella tua app. Vengono importati i seguenti framework: AppCenter e AppCenterCrashes.

     pod 'AppCenter/Crashes'

  2. Eseguire pod install per installare il pod appena definito e aprire il progetto .xcworkspace.

Annotazioni

Se viene visualizzato un errore come [!] Unable to find a specification for `AppCenter` durante l'esecuzione di pod install, eseguire pod repo update per ottenere i pod più aggiornati dal repository Cocoapods e quindi eseguire pod install.

Dopo aver integrato i framework nell'applicazione, è possibile avviare l'SDK e usare i servizi di App Center.

3.2 Integrazione tramite Carthage

Di seguito sono riportati i passaggi per integrare App Center SDK nel progetto Xcode usando Carthage versione 0.30 o successiva, un gestore delle dipendenze decentralizzato che compila le dipendenze e fornisce framework binari.

  1. Aggiungi le seguenti dipendenze al tuo Cartfile per includere App Center nell'applicazione. Questo include tutti i framework. È quindi possibile collegare solo questi framework da usare nell'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. Esegui carthage update. Questa operazione recupera le dipendenze in una cartella Carthage/Checkouts e quindi compila ogni framework.

  3. Aprire la scheda Impostazioni generali della destinazione dell'applicazione. Trascinare e rilasciare i file AppCenter.framework e AppCenterCrashes.framework dalla cartella Carthage/Build/ in Project Navigator di Xcode. AppCenter.framework è necessario per avviare l'SDK. Se non viene aggiunto al progetto, gli altri moduli non funzioneranno e l'app non verrà compilata.

  4. Verrà visualizzata una finestra di dialogo, assicurarsi che la destinazione dell'app sia selezionata. Fare quindi clic su Fine.

    Annotazioni

    Se si usa carthage copy-frameworks nella fase di compilazione , non è consigliabile aggiungere gli SDK di App Center, perché vengono forniti come framework statici.

Dopo aver integrato i framework nell'applicazione, è possibile avviare l'SDK e usare i servizi di App Center.

3.3 Integrazione tramite Swift Package Manager

  1. Dal menu di Xcode fare clic su File > Pacchetti Swift > Aggiungi dipendenza pacchetto.
  2. Nella finestra di dialogo visualizzata immettere l'URL del repository: https://github.com/microsoft/appcenter-sdk-apple.git.
  3. In Versione, selezionare Fino al prossimo aggiornamento maggiore e scegliere l'opzione predefinita.
  4. Scegliere i moduli necessari nella colonna Pacchetto prodotto .

Dopo aver integrato i framework nell'applicazione, è possibile avviare l'SDK e usare i servizi di App Center.

Annotazioni

Se si sta integrando App Center tramite SwiftPM e si vuole usarlo anche nella destinazione dell'estensione dell'app, si assicuri di fornire DISABLE_DIAMOND_PROBLEM_DIAGNOSTIC=YES nella configurazione. Ciò è necessario per evitare limitazioni di SwiftPM nel collegamento di un modulo a più destinazioni.

3.4 Integrazione copiando i file binari nel progetto

Di seguito i passaggi su come integrare i binari compilati nel tuo progetto Xcode per configurare gli arresti anomali di App Center per l'estensione della tua app.

Annotazioni

App Center SDK supporta l'uso di XCframework. Se si vuole integrare XCframeworks nel progetto, scaricare il AppCenter-SDK-Apple-XCFramework.zip dalla pagina delle versioni e decomprimerlo. Il contenuto della cartella risultante non è specifico della piattaforma, ma contiene XCframeworks per ogni modulo. Possono essere integrati allo stesso modo dei normali framework, come descritto di seguito.

  1. Scaricare i framework di App Center SDK forniti come file ZIP.

  2. Decomprimere il file e verrà visualizzata una cartella denominata AppCenter-SDK-Apple che contiene framework diversi per ogni servizio App Center in ogni cartella della piattaforma. Il framework chiamato AppCenter è necessario nel progetto perché contiene codice condiviso tra i diversi moduli.

  3. [Facoltativo] Creare una sottodirectory per le librerie di terze parti.

    • Come procedura consigliata, le librerie di terze parti si trovano in genere in una sottodirectory, spesso denominata Vendor. Se il progetto non è organizzato con una sottodirectory per le librerie, creare ora una sottodirectory Vendor.
    • Creare un gruppo denominato Vendor all'interno del progetto Xcode per simulare la struttura di file su disco.

  4. Aprire la cartella AppCenter-SDK-Apple decompressa in Finder e copiare la cartella nella cartella del progetto nel percorso desiderato. La cartella contiene framework nelle sottocartelle per altre piattaforme supportate da App Center SDK, quindi potrebbe essere necessario eliminare le sottocartelle non necessarie.

  5. Aggiungere i framework SDK al progetto in Xcode:

    • Assicurarsi che il Navigatore del Progetto sia visibile (⌘+1).
    • Ora trascina e rilascia AppCenter.framework e AppCenterCrashes.framework dal Finder (nella posizione del passaggio precedente) nel navigatore del progetto di Xcode. AppCenter.framework è necessario per avviare l'SDK. Se non viene aggiunto al progetto, gli altri moduli non funzioneranno e l'estensione dell'app non verrà compilata.
    • Verrà visualizzata una finestra di dialogo, assicurarsi che la destinazione dell'estensione dell'app sia selezionata. Fare quindi clic su Fine.

Dopo aver integrato i framework nell'estensione dell'app, è possibile avviare l'SDK e usare i servizi app Center.

4. Avviare l'SDK

Per usare App Center, è necessario acconsentire esplicitamente ai moduli da usare. Per impostazione predefinita, non vengono avviati moduli ed è necessario chiamarli in modo esplicito all'avvio dell'SDK.

4.1 Aggiungere le istruzioni import

Inserire le righe seguenti nel file contenente il punto di ingresso dell'estensione dell'app. Ad esempio, all'interno del file ViewController principale di un'estensione Today.

@import AppCenter;
@import AppCenterCrashes;

import AppCenter
import AppCenterCrashes

4.2 Aggiungere il start:withServices: metodo

Inserire la riga seguente nel punto di ingresso dell'estensione dell'app. Ad esempio, all'interno del viewDidLoad metodo del file ViewController principale di un'estensione Today.

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

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

Attualmente è supportata solo la segnalazione degli arresti anomali per le estensioni dell'applicazione.

4.3 Sostituire il segnaposto con il segreto dell'app

Assicurati di sostituire il testo {Your App Secret} con il valore effettivo per l'estensione dell'applicazione. Il segreto dell'app è disponibile nella pagina Attività iniziali o nella pagina Impostazioni del portale di App Center.

La pagina Introduzione contiene l'esempio di codice precedente che include il tuo segreto dell'app. È possibile effettuare il copia-incolla dell'intero esempio.

Perfetto, ora puoi visualizzare i dati sugli arresti anomali nel portale raccolti automaticamente dall'SDK.

Consultare la documentazione per App Center Crashes per informazioni su come personalizzare l'estensione dell'app e utilizzare funzionalità più avanzate.