Introducción a iOS

El SDK 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 datos recopiladospor los SDK de App Center, Reglamento general de protección de datos ylas páginas de preguntas más frecuentes. Además, las preguntas más frecuentes contienen las respuestas que debe proporcionar para App Store configuración de privacidad.

Vamos a empezar a configurar App Center SDK de iOS en la aplicación para usar App Center Analytics y App Center bloqueos. 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 App Center SDK:

• El proyecto de iOS se configura en Xcode 11 o versiones posteriores en macOS versión 10.14.4 o posterior.
• Tiene como destino dispositivos que se ejecutan en iOS 9.0 o posterior.
• No usa ninguna otra biblioteca que proporciona la funcionalidad de informes de bloqueos (solo para App Center bloqueos).
• Si usa CocoaPods para integrar App Center, necesita CocoaPods versión 1.10 o posterior.

App Center SDK Analytics y Crashes son compatibles con Mac Catalyst a través de XCFramework o SwiftPM.

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

Si ya ha creado la aplicación en el portal 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 de 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 Add new app (Agregar nueva aplicación).

Una vez que haya creado una aplicación, puede obtener su secreto de aplicación en la Configuración del portal App Center aplicación. 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 App Center SDK

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

3.1 Integración mediante Cocoapods

1. Agregue las siguientes dependencias a para podfile incluir App Center Analytics y App Center bloqueos en la aplicación. Esta acción extrae los siguientes marcos: AppCenter, AppCenterAnalytics y AppCenterCrashes. En su lugar, puede especificar los servicios que desee en la aplicación. Cada servicio tiene su propio subspectivo y todos dependen de AppCenter. Se extrairá 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 objeto del .xcworkspace proyecto.

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

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 con 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 para Cartfile incluir App Center. Estas dependencias se extrae en todos los marcos. A continuación, solo puede vincular los marcos que desea usar en la 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 capturar 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 de la carpeta Carthage/Build/iOS en el navegador de Project 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 y asegúrese de que el destino de la aplicación está activado. Haga clic en Finalizar.

   Nota

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

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

3.3 Integración mediante Swift Administrador de paquetes

1. En el menú Xcode, haga clic en File > Swift Packages > Add Package Dependency (Agregar 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 Version (Versión), seleccione Up to Next Major (Hasta siguiente principal) y elija la opción predeterminada.
4. Elija los módulos que necesita en la columna Package Product (Producto del paquete).

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

3.4 Integración mediante la copia de 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 de iOS.

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

2. Descomprima el archivo y verá una carpeta denominada AppCenter-SDK-Apple que contiene marcos diferentes para cada App Center servicio en cada carpeta de la plataforma. El marco llamado 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 denominado Vendor. 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 descomprimido en Finder y copie la carpeta en la carpeta del proyecto en la ubicación donde quiera. La carpeta contiene marcos en subcarpetas para otras plataformas que App Center SDK admite, 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 navegador esté visible (⌘+1).
   • Ahora, arrastre & appcenter.framework, AppCenterAnalytics.framework y AppCenterCrashes.framework desde finder (en la ubicación del paso anterior) al navegador de Project 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 y asegúrese de que el destino de la aplicación está activado. Haga clic en Finalizar.

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

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" (seleccionada de forma predeterminada en Xcode 12) y "Ui Kit AppDelegate". Si usa Xcode 11 o una versión inferior, usa el ciclo de vida de AppDelegate del kit de interfaz de usuario. Si va a desarrollar para una extensión, consulte la página de introducción a la extensión.

4.1 Adición de las instrucciones import

Abra el archivo AppDelegate del proyecto (para el ciclo de vida de AppDelegate del kit de interfaz de usuario) o <ProjectName> el archivo 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

UI Kit AppDelegate

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

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

Cree init() un método en y agregue código de struct inicialización en él.

Use este código en los métodos descritos anteriormente para iniciar el SDK:

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

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

Si tiene una aplicación de Salesforce, puede pasar secretos de aplicación para iOS y macOS al mismo tiempo:

[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])

Si necesita iniciar los servicios App Center por separado, debe:

1. Configúrelo o inéntelo con el secreto de aplicación.
2. Si se puede llamar al código varias veces, compruebe si el App Center ya está configurado.
3. Inicie los servicios necesarios sin el secreto de 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 Reemplazar el marcador de posición por el secreto de aplicación

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

La Tareas iniciales contiene el ejemplo de código anterior con el secreto de aplicación en él, puede copiar y pegar el ejemplo completo.

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

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 App Center servicio. Además, la API ( 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 start:withServices start(withAppSecret:services:) llamada.

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

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

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

Excelente, está todo listo para visualizar los datos de Análisis y Bloqueos en el portal que el SDK recopila automáticamente.

Consulte los documentos App Center Analytics y App Center Crashes para aprender a personalizar y usar funcionalidades más avanzadas de ambos servicios.

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