Introducción con macOS

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

Vamos a empezar a configurar el SDK App Center macOS en la aplicación para usar App Center Analytics y App Center bloqueos.

1. Prerrequisitos

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

• El proyecto de macOS se configura en Xcode 11 o posterior en macOS versión 10.14.4 o posterior.
• Tiene como destino dispositivos que se ejecutan en macOS 10.9 o posterior.
• No usa ninguna otra biblioteca que proporciona la funcionalidad de informes de bloqueo.

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

App Center SDK es compatible con Apple Silicon.

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 App Center portal, puede omitir este paso.

1. Diríjase a appcenter.ms.
2. Regístrese o inicie sesión y pulse 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 macOS 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 Configuración de la página App Center Portal. 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 aplicación.

3. Agregar los módulos App Center SDK

El SDK de App Center para macOS se puede agregar a la aplicación a través de Cocoapods, Carthage, Swift Administrador de paquetes o 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. Esto extrae los siguientes marcos: AppCenter, AppCenterAnalytics y AppCenterCrashes. En su lugar, puede especificar qué servicios desea usar en la aplicación. Cada servicio tiene su propia subespec y todos se basan en AppCenter . Se extrairá automáticamente.

   # 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. 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 en la aplicación. Esto extrae 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 --platform macOS. Esto captura las dependencias en una carpeta Carthage/Checkouts y, a continuación, compila 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/macOS 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 macOS.

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 servicio de App Center en cada carpeta de la plataforma. El marco llamado es necesario en el proyecto, ya que AppCenter contiene código que se comparte entre los distintos módulos.

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

   • Las bibliotecas de terceros suelen estar en un subdirectorio (a menudo se denomina Proveedor), por lo que si el proyecto no usa un subdirectorio para las 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 desee. La carpeta contiene marcos en subcarpetas para otras plataformas que admite App Center SDK, por lo que es posible que tenga que eliminar subcarpetas innecesarios.

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 Finder (los que se encuentran dentro de la carpeta Vendor) en el navegador de Project Xcode. Se requiere AppCenter.framework para iniciar el SDK. Si falta, 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. Inicio del SDK

Para usar App Center, debe participar en 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. 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 de importación

Abra el archivo AppDelegate del proyecto y agregue las siguientes instrucciones de importación:

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

import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

4.2 Adición del start:withServices: método

Inserte la siguiente línea en el método delegado de didFinishLaunchingWithOptions la aplicación:

[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ámetros 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) de la siguiente manera:

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

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

4.4 Adición de funcionalidades de Internet para aplicaciones en espacio aislado

Si la aplicación usa app sandbox, debe establecer la funcionalidad para permitir conexiones salientes (cliente) para permitir que la aplicación tenga acceso a Internet. Xcode 9 habilita app sandbox de forma predeterminada, pero las funcionalidades de las conexiones salientes deben establecerse explícitamente.

Seleccione el proyecto en el navegador del proyecto, seleccione la pestaña Funcionalidades y, si la aplicación usa el espacio aislado, habilite las conexiones salientes.

Muy bien, 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 características avanzadas de cada servicio.