Introduzione a macOS

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.

• Android
• iOS
• Estensioni iOS
• React Native
• MAUI/Xamarin
• UWP
• WPF/WinForms
• Unity
• macOS
• Estensioni macOS
• tvOS
• Cordova

App Center SDK usa un'architettura modulare in modo da poter usare qualsiasi o tutti i servizi.

Si inizierà a configurare App Center macOS SDK nell'app per usare App Center Analytics e App Center Arresti anomali.

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.

Nota

App Center SDK rilascia il supporto per Xcode 10 con la versione di Giugno SDK.

App Center SDK Analytics e Arresti anomali sono compatibili con Mac Catalyst tramite XCFramework o SwiftPM.

App Center SDK è compatibile con Apple Silicon.

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

3. Aggiungere i moduli app Center SDK

App Center SDK per macOS può essere aggiunto all'app tramite Cocoapods, Carthage, Swift Package Manager o aggiungendo manualmente i file binari al progetto.

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.1 Integrazione tramite Cocoapods

1. Aggiungere le dipendenze seguenti all'utente podfile per includere App Center Analytics e App Center Arresti anomali nell'app. Questo pull nei framework seguenti: AppCenter, AppCenterAnalytics e AppCenterCrashes. È invece possibile specificare i servizi da usare nell'app. Ogni servizio dispone di un proprio sottospec e si basano su AppCenter. Verrà eseguito automaticamente il pull.

    # Use the following line to use App Center Analytics and Crashes.
    pod 'AppCenter'
   
    # Use the following lines if you want to specify which service you want to use.
    pod 'AppCenter/Analytics'
    pod 'AppCenter/Crashes'
   

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

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 i framework che si desidera 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 --platform macOS. 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, AppCenterAnalytics.framework e AppCenterCrashes.framework dalla cartella Carthage/Build/macOS in Esplora progetti 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 clic su Fine.

   Nota

   Se si usa carthage copy-frameworks nella fase di compilazione , non è consigliabile aggiungere gli SDK di App Center in quanto 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 App Center Analytics e App Center Arresti anomali per l'app macOS.

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.

   • Le librerie di terze parti sono in genere in una sottodirectory (spesso denominata Fornitore), quindi se il progetto non usa una sottodirectory per le librerie, creare una sottodirectory fornitore ora.
   • 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, AppCenterAnalytics.framework e AppCenterCrashes.framework dal Finder (quelli all'interno della cartella Vendor) in Esplora progetti di Xcode. AppCenter.framework è necessario per avviare l'SDK. Se mancano gli altri moduli non funzioneranno e l'app non verrà compilata.
   • Verrà visualizzata una finestra di dialogo, assicurarsi che la destinazione dell'app sia selezionata. Fare clic su Fine.

Nota

Il file binario DELL'SDK non viene creato in un pacchetto seguendo la convenzione del framework macOS. Il motivo è che App Center SDK per Mac non è un framework convenzionale, ma uno statico. È necessario collegarlo come framework statico: assicurarsi di non incorporare i file binari e non includerli nella fase di compilazione "copia risorse bundle".

Dopo aver integrato i framework nell'applicazione, è possibile 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, non vengono avviati moduli ed è necessario chiamare ognuno di essi all'avvio dell'SDK. Se si sta sviluppando per un'estensione, fare riferimento alla pagina introduttiva dell'estensione.

4.1 Aggiungere le istruzioni import

Aprire il file AppDelegate del progetto e aggiungere le istruzioni import seguenti:

@import AppCenter;
@import AppCenterAnalytics;
@import AppCenterCrashes;

import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

4.2 Aggiungere il start:withServices: metodo

Inserire la riga seguente nel metodo delegato dell'app didFinishLaunchingWithOptions :

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

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

Se si dispone di un'applicazione Catalyst, è possibile passare i segreti dell'app per iOS e macOS contemporaneamente:

[MSACAppCenter start:@"ios={Your iOS App Secret};macos={Your macOS App Secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];

AppCenter.start(withAppSecret:"ios={Your iOS App Secret};macos={Your macOS App Secret}", services: [Analytics.self, Crashes.self])

Avviso

Non è consigliabile incorporare il segreto dell'app nel codice sorgente.

Se è necessario avviare separatamente i servizi di App Center, è necessario:

1. Configurarlo o avviarlo con il segreto dell'app.
2. Se il codice può essere chiamato più volte, controllare se App Center è già configurato.
3. Avviare i servizi necessari senza il segreto dell'app.

[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 Sostituire il segnaposto con il segreto dell'app

Assicurarsi di sostituire {Your App Secret} il testo con il valore effettivo per l'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, è possibile copiare l'intero esempio.

L'esempio precedente mostra come usare il start:withServices metodo (start(withAppSecret:services:) per Swift) e includere sia App Center Analytics che App Center Crashes.

Se non si vuole usare uno dei due servizi, rimuovere il parametro corrispondente dalla chiamata al metodo precedente.

A meno che non si specifichi in modo esplicito ogni modulo come parametri nel metodo start, non è possibile usare tale servizio App Center. Inoltre, l'API start:withServices (start(withAppSecret:services:) per Swift) può essere usata una sola volta nel ciclo di vita dell'app. Tutte le altre chiamate segnaleranno un avviso alla console e saranno disponibili solo i moduli inclusi nella prima chiamata.

Ad esempio, se si vuole eseguire l'onboarding in App Center Analytics, è necessario modificare la start:withServices chiamata API (start(withAppSecret:services:) per Swift) come indicato di seguito:

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

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

4.4 Aggiungere funzionalità Internet per le app in modalità sandbox

Se l'app usa la sandbox dell'app, è necessario impostare la funzionalità per consentire le connessioni in uscita (client) per consentire all'app di avere accesso a Internet. Xcode 9 abilita la sandbox dell'app per impostazione predefinita, ma le funzionalità per le connessioni in uscita devono essere impostate in modo esplicito.

Selezionare il progetto nello strumento di spostamento del progetto, selezionare la scheda Funzionalità e, se l'app usa la sandbox, abilitare le connessioni in uscita.

---

Si è tutti impostati per visualizzare i dati di Analisi e arresti anomali nel portale raccolti automaticamente dall'SDK.

Per informazioni su come personalizzare e usare funzionalità avanzate di ogni servizio, vedere la documentazione app Center Analytics e App Center Crashes (Arresti anomali di App Center ).