Condividi tramite

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

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

È possibile trovare informazioni sui dati raccolti da App Center sui dati raccolti dagli SDK di App Center, regolamento generale sulla protezione dei dati e pagine delle domande frequenti . Le domande frequenti contengono anche le risposte, che è necessario fornire per la configurazione della privacy dell'App Store.

Iniziamo a configurare l'SDK di App Center iOS nella tua app per utilizzare App Center Analytics e App Center Crashes. Per aggiungere App Center Distribute all'app, vedere la documentazione per App Center Distribute.

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 (solo per arresti anomali di App Center).
  • Se usi CocoaPods per integrare App Center, hai bisogno di CocoaPods versione 1.10 o successiva.

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

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.

3. Aggiungere i moduli di App Center SDK

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

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

Annotazioni

I simulatori ARM64 (quando vengono avviati da Xcode in esecuzione su Apple Silicon Mac) non sono supportati tramite CocoaPods, è consigliabile usare altri metodi di integrazione per il funzionamento.

  1. Aggiungere le dipendenze seguenti nel codice podfile per includere App Center Analytics e App Center Crash nella tua app. Questa azione importa i framework seguenti: AppCenter, AppCenterAnalytics e AppCenterCrashes. È invece possibile specificare i servizi desiderati nell'app. Ogni servizio ha un proprio subspec e tutti si basano su AppCenter. Verrà integrato automaticamente.

     # 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'

  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.

Annotazioni

L'integrazione di Carthage non funziona come predefinita in Xcode 12. Per renderlo funzionante, fare riferimento a questa istruzione carthage

  1. Aggiungere le dipendenze seguenti a Cartfile per includere App Center. Queste dipendenze estraggono tutti i framework. È quindi possibile collegare solo i 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 per recuperare le dipendenze in una cartella Carthage/Checkouts. Compilare quindi ogni framework.

  3. Aprire la scheda Impostazioni generali della destinazione dell'applicazione. Trascinare e rilasciare i file AppCenter.framework, AppCenterAnalytics.framework e AppCenterCrashes.framework dalla cartella Carthage/Build/iOS 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

Ecco i passaggi per integrare i file binari compilati nel tuo progetto Xcode per configurare App Center Analytics e Crashes di App Center per la tua app iOS.

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, pertanto 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, AppCenterAnalytics.framework e AppCenterCrashes.framework dal Finder (nel percorso del passaggio precedente) nel navigatore progetto 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.
    • Verrà visualizzata una finestra di dialogo, assicurarsi che la destinazione dell'app sia selezionata. Fare quindi clic su Fine.

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, scegliere i moduli che si desidera utilizzare. Per impostazione predefinita, non vengono avviati moduli ed è necessario chiamare ognuno di essi all'avvio dell'SDK.

Le istruzioni seguenti sono leggermente diverse a seconda del ciclo di vita in uso. A partire da Xcode 12 è possibile selezionare uno dei due cicli di vita: "Swift UI App" (selezionato per impostazione predefinita in Xcode 12) e "UI Kit AppDelegate". Se si sta sviluppando per un'estensione, fare riferimento alla pagina Introduzione all'estensione.

4.1 Aggiungere le dichiarazioni di importazione

Aprire il file AppDelegate del progetto (per il ciclo di vita appDelegate per UI Kit) o <il file ProjectName>App.swift (per il ciclo di vita dell'app per l'interfaccia utente Swift) 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

AppDelegate del kit dell'interfaccia utente

Aggiungere il codice di inizializzazione al didFinishLaunchingWithOptions metodo delegato:

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

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

Ciclo di vita dell'app per l'interfaccia utente Swift

Per assicurarsi che App Center SDK funzioni correttamente con l'interfaccia utente Swift, inizializzarlo dopo il caricamento dell'interfaccia utente. Il modo più semplice per ottenere questo risultato consiste nell'usare UIApplicationDelegate:

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

UIApplicationDelegateAdaptor Usare quindi in struct:

@main
struct YourAppName: App {

  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

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

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

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

Avvertimento

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

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

  1. Configuralo o avvialo con il codice segreto dell'applicazione.
  2. Se il codice può essere chiamato più volte, verificare 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 il testo {Your App Secret} con il valore effettivo per l'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.

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 parametro nel metodo start, non è possibile usare il 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 includono un avviso nella 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])

Ora sei pronto per visualizzare i dati di analisi e crash nel portale che l'SDK raccoglie automaticamente.

Per informazioni su come personalizzare e usare funzionalità più avanzate di entrambi i servizi, vedere la documentazione analisi di App Center e App Center Crashes .

Per informazioni su come iniziare a usare gli aggiornamenti in-app, leggere la documentazione di App Center Distribute.