Introducción a macOS

  • Artículo

Importante

Visual Studio App Center está programado para retirarse el 31 de marzo de 2025. Aunque puede seguir usando Visual Studio App Center hasta que se retire por completo, hay varias alternativas recomendadas a las que puede considerar la posibilidad de migrar.

Obtenga más información sobre las escalas de tiempo y las alternativas de soporte técnico.

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

Vamos a empezar a configurar el SDK de MacOS de App Center en la aplicación para usar App Center Analytics y App Center Crashes.

1. Prerrequisitos

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

  • El proyecto de macOS está configurado en Xcode 13 o posterior en macOS versión 10.14.4 o posterior.
  • Tiene como destino dispositivos que se ejecutan en macOS 10.13 o posterior.
  • No usa ninguna otra biblioteca que proporcione la funcionalidad de informes de bloqueos.

Nota

El SDK de App Center quitará la compatibilidad con Xcode 10 con la versión del SDK de junio.

Análisis y bloqueos del SDK de App Center son compatibles con Mac Catalyst a través de XCFramework o SwiftPM.

El SDK de App Center es compatible con Apple Silicon.

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

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

  1. Ve 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 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 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. Adición de los módulos del SDK de App Center

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

Nota

En la 4.0.0 versión de App Center se introdujeron cambios importantes. Siga la sección Migrar a App Center SDK 4.0.0 y versiones posteriores para migrar App Center desde versiones anteriores.

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. Esto extrae los siguientes marcos: AppCenter, AppCenterAnalytics y AppCenterCrashes. En su lugar, puede especificar qué servicios quiere usar en la aplicación. Cada servicio tiene su propia subspección y todas dependen de AppCenter. Se extraerá 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 ..xcworkspace

Ahora que ha integrado los marcos 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 en la aplicación. Esto extrae todos los marcos. Después, solo puedes vincular los marcos que quieras 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 desde la carpeta Carthage/Build/macOS 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 y asegúrese de que el destino de la aplicación esté activado. 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 en la aplicación, es el momento de iniciar el SDK y usar los servicios de App Center.

3.3 Integración mediante swift Package Manager

  1. En el menú Xcode, haga clic en File Swift Packages > Add Package Dependency (Agregar dependencia de paquetes swift de archivo>).
  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 siguiente principal y tome la opción predeterminada.
  4. Elija los módulos que necesita en la columna Package Product (Producto de paquete ).

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

Nota

Si va a integrar App Center a través de SwiftPM y quiere usarlo también en el destino de extensión de la aplicación, asegúrese de proporcionar DISABLE_DIAMOND_PROBLEM_DIAGNOSTIC=YES en la configuración. Esto es necesario para evitar las limitaciones de SwiftPM en la vinculación de un módulo a varios destinos.

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

Nota

El SDK de App Center admite el uso de XCframework. Si desea integrar XCframeworks en el proyecto, descargue la AppCenter-SDK-Apple-XCFramework.zip de la página de versiones y descomprimala . El contenido de la carpeta resultante no es específico de la plataforma, sino que contiene XCframeworks para cada módulo. Se pueden integrar de la misma manera que los marcos habituales, como se describe a continuación.

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

    • 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 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 en subcarpetas para otras plataformas que admite el SDK de App Center, por lo que es posible que tenga que eliminar subcarpetas innecesarias.

  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 (los que están dentro de la carpeta Vendor ) en project Navigator de Xcode. Se requiere AppCenter.framework para iniciar el SDK. Si faltan 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.

Nota

El binario del SDK no se empaqueta siguiendo la convención del marco de macOS. El motivo es que el SDK de App Center para Mac no es un marco convencional, sino uno estático. Debe vincularlo como marco estático: asegúrese de que no va a insertar los archivos binarios y no los incluya en la fase de compilación "copiar recursos de agrupación".

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, 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 está desarrollando para una extensión, consulte la página Introducción de la extensión.

4.1 Adición de las instrucciones import

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 Agregar el start:withServices: método

Inserte la línea siguiente 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 Catalyst, 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])

Advertencia

No se recomienda insertar el secreto de aplicación en el código fuente.

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

  1. Configure o inícielo con el secreto de aplicación.
  2. Si el código se puede llamar varias veces, compruebe si 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 Reemplace el marcador de posición por el secreto de la aplicación

Asegúrese de reemplazar {Your App Secret} el texto por el valor real de la aplicación. El secreto de la aplicación se puede encontrar en la página de 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 start:withServices método (start(withAppSecret:services:) para Swift) e incluir tanto App Center Analytics como Bloqueos de App Center.

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

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

Si la aplicación usa el espacio aislado de aplicaciones, tiene que establecer la capacidad de permitir conexiones salientes (cliente) para permitir que la aplicación tenga acceso a Internet. Xcode 9 habilita el espacio aislado de la aplicación 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.

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

Consulte los documentos de App Center Analytics y los documentos de Bloqueos de App Center para aprender a personalizar y usar características avanzadas de cada servicio.