Introducción a iOS

El SDK de App Center usa una arquitectura modular para que pueda usar cualquiera o todos los servicios.

Puede encontrar información sobre los datos recopilados por App Center sobre los datos recopilados por los SDK de App Center, el Reglamento general de protección de datos y las páginas de preguntas más frecuentes . Además, las preguntas más frecuentes contienen las respuestas, que debe proporcionar para la configuración de privacidad de App Store.

Empecemos a configurar el SDK de iOS de App Center en tu aplicación para usar el App Center Analytics y App Center Crashes. Para agregar App Center Distribute a la aplicación, consulte la documentación de App Center Distribute.

1. Prerrequisitos

Se deben cumplir los siguientes requisitos para usar el SDK de App Center:

• El proyecto de iOS está configurado en Xcode 13 o posterior en macOS versión 10.14.4 o posterior.
• Tiene como destino dispositivos que se ejecutan en ios 11.0 o posterior.
• No está utilizando ninguna otra biblioteca que ofrezca funcionalidad de reportes sobre fallos, solo para fallos de App Center.
• Si usa CocoaPods para integrar App Center, necesita CocoaPods versión 1.10 o posterior.

El análisis y los errores del SDK del App Center son compatibles con Mac Catalyst a través de XCFramework o SwiftPM.

2. Creación de la aplicación en el Portal de App Center para obtener el secreto de aplicación

Si ya ha creado la aplicación en el portal de App Center, puede omitir este paso.

1. Diríjase a appcenter.ms.
2. Regístrese o inicie sesión y presione el botón azul en la esquina superior derecha del portal que dice Agregar nuevo y seleccione Agregar nueva aplicación en el menú desplegable.
3. Escriba un nombre y una descripción opcional para la aplicación.
4. Seleccione iOS como sistema operativo y Objective-C/Swift como plataforma.
5. Presione el botón situado en la parte inferior derecha que indica Agregar nueva aplicación.

Una vez que haya creado una aplicación, puede obtener su secreto de aplicación en la página Configuración del portal de App Center. En la esquina superior derecha de la página Configuración , haga clic en los puntos verticales triples y seleccione Copy app secret para obtener el secreto de la aplicación.

3. Agregar los módulos del SDK de App Center

El SDK de App Center para iOS se puede agregar a la aplicación a través de Cocoapods, Carthage, Swift Package Manager o agregando manualmente los archivos binarios al proyecto.

3.1 Integración a través de Cocoapods

1. Agregue las siguientes dependencias a podfile para incluir App Center Analytics y App Center Crashes en la aplicación. Esta acción incorpora los siguientes frameworks: AppCenter, AppCenterAnalytics y AppCenterCrashes. En su lugar, puede especificar los servicios que desee en la aplicación. Cada servicio tiene su propia subespecificación y todos dependen de AppCenter. Se incorporará automáticamente.

    # 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. Ejecute pod install para instalar el pod recién definido y abra el proyecto .xcworkspace.

Ahora que ha integrado los marcos de trabajo en la aplicación, es el momento de iniciar el SDK y usar los servicios de App Center.

3.2 Integración a través de Carthage

A continuación se muestran los pasos para integrar el SDK de App Center en el proyecto de Xcode mediante Carthage versión 0.30 o posterior, un administrador de dependencias descentralizado que compila las dependencias y proporciona marcos binarios.

1. Agregue las siguientes dependencias a Cartfile para incluir App Center. Estas dependencias incorporan todos los frameworks. A continuación, solo puedes vincular esos marcos que quieras usar en tu aplicación.

   # 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. Ejecute carthage update para obtener dependencias en una carpeta Carthage/Checkouts. A continuación, compile cada marco.

3. Abra la pestaña Configuración general del destino de la aplicación. Arrastre y coloque los archivos AppCenter.framework, AppCenterAnalytics.framework y AppCenterCrashes.framework desde la carpeta Carthage/Build/iOS en Project Navigator de Xcode. AppCenter.framework es necesario para iniciar el SDK. Si no se agrega al proyecto, los demás módulos no funcionarán y la aplicación no se compilará.

4. Aparecerá un cuadro de diálogo, asegúrese de que el destino de la aplicación esté seleccionado. A continuación, haga clic en Finalizar.

   Nota:

   Si usa carthage copy-frameworks en la fase de compilación , no debe agregar los SDK de App Center allí, ya que se envían como marcos estáticos.

Ahora que ha integrado los marcos de trabajo en la aplicación, es el momento de iniciar el SDK y usar los servicios de App Center.

3.3 Integración a través del Administrador de paquetes Swift

1. En el menú Xcode, haga clic en Archivo > Swift Packages > Añadir dependencia de paquete.
2. En el cuadro de diálogo que aparece, escriba la dirección URL del repositorio: https://github.com/microsoft/appcenter-sdk-apple.git.
3. En Versión, seleccione Hasta la próxima versión principal y elija la opción predeterminada.
4. Elija los módulos que necesita en la columna Paquete producto .

Ahora que ha integrado los marcos de trabajo en la aplicación, es el momento de iniciar el SDK y usar los servicios de App Center.

3.4 Integración copiando los archivos binarios en el proyecto

A continuación se muestran los pasos para integrar los archivos binarios compilados en el proyecto de Xcode para configurar App Center Analytics y App Center Crashes para la aplicación iOS.

1. Descargue los marcos del SDK de App Center proporcionados como un archivo ZIP.

2. Descomprima el archivo y verá una carpeta denominada AppCenter-SDK-Apple que contiene marcos diferentes para cada servicio de App Center en cada carpeta de la plataforma. El marco al que se llama AppCenter es necesario en el proyecto, ya que contiene código que se comparte entre los distintos módulos.

3. [Opcional] Cree un subdirectorio para bibliotecas de terceros.

   • Como procedimiento recomendado, las bibliotecas de terceros suelen estar en un subdirectorio, a menudo denominada Proveedor. Si el proyecto no está organizado con un subdirectorio para bibliotecas, cree un subdirectorio Vendor ahora.
   • Cree un grupo denominado Vendor dentro del proyecto de Xcode para imitar la estructura de archivos en el disco.

4. Abra la carpeta AppCenter-SDK-Apple descomprimida en Finder y copie la carpeta en la carpeta del proyecto en la ubicación donde quiera. La carpeta contiene marcos de subcarpetas para otras plataformas compatibles con el SDK de App Center, por lo que es posible que tenga que eliminar subcarpetas que no necesite.

5. Agregue los marcos del SDK al proyecto en Xcode:

   • Asegúrese de que project Navigator esté visible (⌘+1).
   • Ahora arrastre y coloque AppCenter.framework, AppCenterAnalytics.framework y AppCenterCrashes.framework desde el Finder (en la ubicación del paso anterior) en Project Navigator de Xcode. AppCenter.framework es necesario para iniciar el SDK. Si no se agrega al proyecto, los demás módulos no funcionarán y la aplicación no se compilará.
   • Aparecerá un cuadro de diálogo, asegúrese de que el destino de la aplicación esté seleccionado. A continuación, haga clic en Finalizar.

Ahora que ha integrado los marcos de trabajo en la aplicación, es el momento de iniciar el SDK y usar los servicios de App Center.

4. Iniciar el SDK

Para usar App Center, opte por los módulos que desea usar. De forma predeterminada, no se inicia ningún módulo y debe llamar a cada uno al iniciar el SDK.

Las instrucciones siguientes son ligeramente diferentes en función del ciclo de vida que use. A partir de Xcode 12, puede seleccionar uno de los dos ciclos de vida: "Aplicación de interfaz de usuario de Swift" (seleccionado de forma predeterminada en Xcode 12) y "Ui Kit AppDelegate". Si está desarrollando para una extensión, consulte la página Introducción a la extensión.

4.1 Agregar las declaraciones import

Abra el archivo AppDelegate del proyecto (para el ciclo de vida de AppDelegate del kit de interfaz de usuario) o <el archivo ProjectName>App.swift (para el ciclo de vida de la aplicación de interfaz de usuario de Swift) y agregue las siguientes instrucciones de importación:

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

import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

4.2 Agregar el start:withServices: método

Kit de interfaz de usuario AppDelegate

Agregue código de inicialización al didFinishLaunchingWithOptions método delegado:

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

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

Ciclo de vida de la aplicación de interfaz de usuario de Swift

Para asegurarse de que el SDK de App Center funciona correctamente con la interfaz de usuario de Swift, inicialícelo después de que la interfaz de usuario se haya cargado. La manera más sencilla de lograr esto es mediante 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
    }
}

A continuación, use UIApplicationDelegateAdaptor en struct:

@main
struct YourAppName: App {

  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

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

Si tiene una aplicación Catalyst, puede compartir secretos de la aplicación para iOS y macOS al mismo tiempo.

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

Si necesita iniciar los servicios de App Center por separado, debe hacer lo siguiente:

1. Configúrelo o inícielo con la Clave Secreta de la Aplicación.
2. Si el código se puede llamar varias veces, comprueba si App Center ya está configurado.
3. Inicie los servicios necesarios sin el secreto de la aplicación.

[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 Reemplace el marcador de posición por la clave secreta de la aplicación

Asegúrese de reemplazar el texto {Your App Secret} por el valor real para su aplicación. El secreto de la aplicación se puede encontrar en la página Introducción o en la página Configuración del portal de App Center.

La página Introducción contiene el ejemplo de código anterior con el secreto de aplicación en ella, puede copiar y pegar todo el ejemplo.

En el ejemplo anterior se muestra cómo usar el método start:withServices (start(withAppSecret:services:) en Swift) e incluir tanto App Center Analytics como App Center Crashes.

Si no desea usar uno de los dos servicios, quite el parámetro correspondiente de la llamada al método anterior.

A menos que especifique explícitamente cada módulo como parámetro en el método start, no puede usar ese servicio de App Center. Además, la start:withServices API (start(withAppSecret:services:) para Swift) solo se puede usar una vez en el ciclo de vida de la aplicación: todas las demás llamadas registrarán una advertencia en la consola y solo estarán disponibles los módulos incluidos en la primera llamada.

Por ejemplo: si desea incorporar a App Center Analytics, debe modificar la start:withServices llamada API (start(withAppSecret:services:) para Swift) como se indica a continuación:

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

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

Genial, ya estás listo para visualizar los datos de Analíticas y Bloqueos en el portal que el SDK recopila automáticamente.

Vea la documentación de Análisis de App Center y la documentación de Fallos de App Center para obtener información sobre cómo personalizar y utilizar funcionalidades más avanzadas de ambos servicios.

Para obtener información sobre cómo empezar a trabajar con las actualizaciones desde la aplicación, lea la documentación de App Center Distribute.