Introduzione alle estensioni macOS

  • Articolo

Importante

Visual Studio App Center è previsto per il ritiro il 31 marzo 2025. Anche se è possibile continuare a usare Visual Studio App Center fino a quando non viene completamente ritirato, esistono diverse alternative consigliate che è possibile considerare la migrazione a.

Altre informazioni sulle sequenze temporali di supporto e sulle alternative.

Le estensioni supportano solo la segnalazione degli arresti anomali.

Per informazioni su come aggiungere App Center SDK all'app contenitore, vedere la documentazione per i Introduzione macOS di App Center.

Si inizierà a configurare App Center macOS SDK nell'estensione dell'app per l'uso degli arresti anomali di App Center.

1. Prerequisiti

I requisiti seguenti devono essere soddisfatti per l'uso di App Center SDK:

  • Il progetto macOS è configurato in Xcode 13 o versioni successive in macOS versione 10.14.4 o successiva.
  • I dispositivi in esecuzione in macOS 10.13 o versioni successive sono destinati ai dispositivi.
  • Non si usa alcuna altra libreria che fornisce funzionalità di creazione di report di arresto anomalo.

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. Passare a appcenter.ms.
  2. Iscriversi o accedere e premere il pulsante blu nell'angolo superiore destro 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 macOS 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 relativo segreto app nella pagina Impostazioni nel portale di App Center. Nell'angolo superiore destro della pagina Impostazioni fare clic sui punti verticali tripli e selezionare Copy app secret per ottenere il segreto dell'app.

Nota

L'uso di un segreto app esistente da un altro progetto macOS ha effetti collaterali. App Center non supporta il filtro in base al progetto nella stessa applicazione di App Center. Ad esempio, l'elenco degli arresti anomali per una determinata versione elenca tutti gli arresti anomali di entrambi i progetti per questa versione senza distinzione. Può essere confuso.

Nota

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

3. Aggiungere i moduli 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. Aggiungere le dipendenze seguenti all'oggetto podfile per includere arresti anomali di App Center nell'app. Questo pull nei framework seguenti: AppCenter e AppCenterCrashes. 

     pod 'AppCenter/Crashes'

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

Nota

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

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

3.2 Integrazione tramite Carthage

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

  1. Aggiungere le dipendenze seguenti all'app Cartfile per includere App Center nell'app. Questo pull in 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. Eseguire carthage update. Questo 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 file AppCenter.framework e AppCenterCrashes.framework dalla cartella Carthage/Build/ in Esplora progetti 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 clic su Fine.

    Nota

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

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

3.3 Integrazione tramite Swift Package Manager

  1. Dal menu Xcode fare clic su File > Swift Packages > Add Package Dependency(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 a Avanti principale e scegliere l'opzione predefinita.
  4. Scegliere i moduli necessari nella colonna Package Product .

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

Nota

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

3.4 Integrazione copiando i file binari nel progetto

Di seguito sono riportati i passaggi su come integrare i file binari compilati nel progetto Xcode per configurare gli arresti anomali di App Center per l'estensione dell'app.

Nota

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

  1. Scaricare i framework SDK di App Center 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 è obbligatorio nel progetto perché contiene il 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 sono in genere in una sottodirectory, spesso denominata Fornitore. 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 in Finder e copiare la cartella nella cartella del progetto nel percorso in cui si vuole. La cartella contiene framework nelle sottocartelle per altre piattaforme supportate da App Center SDK, quindi potrebbe essere necessario eliminare sottocartelle non necessarie.

  5. Aggiungere i framework SDK al progetto in Xcode:

    • Assicurarsi che Lo strumento di navigazione del progetto sia visibile (⌘+1).
    • Trascinare e rilasciare AppCenter.framework e AppCenterCrashes.framework dal Finder (nella posizione del passaggio precedente) in Esplora progetti 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 clic su Fine.

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

4. Avviare l'SDK

Per usare App Center, è necessario acconsentire esplicitamente ai moduli da usare. Per impostazione predefinita, nessun modulo viene avviato e è necessario chiamare in modo esplicito ognuno di essi all'avvio dell'SDK.

4.1 Aggiungere le istruzioni di importazione

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 viewDidLoad del 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

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

La pagina Introduzione contiene l'esempio di codice precedente con il segreto dell'app in esso, è possibile copiare l'intero esempio.

Ottimo, è tutto impostato per visualizzare i dati arresti anomali nel portale che l'SDK raccoglie automaticamente.

Esaminare la documentazione relativa agli arresti anomali di App Center per informazioni su come personalizzare l'estensione dell'app e usare funzionalità più avanzate.