Introducción a macOS

2025-05-05

Importante

Visual Studio App Center se retiró el 31 de marzo de 2025, excepto las características de análisis y diagnóstico, que seguirán siendo compatibles hasta el 30 de junio de 2026. Más información.

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 estás usando ninguna otra biblioteca que proporcione funcionalidad de informes de fallos.

Nota:

El SDK de App Center eliminará la compatibilidad con Xcode 10 en la versión del SDK que se lanzará en junio.

El análisis y los errores del SDK del 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 aplicación

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

Diríjase a appcenter.ms.
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.
Escriba un nombre y una descripción opcional para la aplicación.
Seleccione macOS como sistema operativo y Objective-C/Swift como plataforma.
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 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

Agregue las siguientes dependencias a podfile para incluir App Center Analytics y App Center Crashes en la aplicación. Esto incorpora los siguientes frameworks: AppCenter, AppCenterAnalytics y AppCenterCrashes. En su lugar, puede especificar qué servicios desea usar en la aplicación. Cada servicio tiene su propia subespecificación y todos ellos dependen de AppCenter. Se incorporará 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'
```
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.

Agregue las siguientes dependencias a Cartfile para incluir App Center en la aplicación. Esto extrae todos los marcos de trabajo. 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

Ejecute carthage update --platform macOS. Esto captura las dependencias en una carpeta Carthage/Checkouts y, a continuación, compila cada marco.
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á.
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

En el menú Xcode, haga clic en Archivo > Swift Packages > Añadir dependencia de paquete.
En el cuadro de diálogo que aparece, escriba la dirección URL del repositorio: https://github.com/microsoft/appcenter-sdk-apple.git.
En Versión, seleccione Hasta la próxima versión principal y elija la opción predeterminada.
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.

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 limitaciones de SwiftPM al vincular 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 su proyecto, descargue el AppCenter-SDK-Apple-XCFramework.zip de la página de lanzamientos y descomprímalo. 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.

Descargue los marcos del SDK de App Center proporcionados como un archivo ZIP.
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.
[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.
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 innecesarias.
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. AppCenter.framework es necesario 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, asegúrese de que el destino de la aplicación esté seleccionado. A continuación, haga clic en Finalizar.

Nota:

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

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 a la extensión.

4.1 Agregar las declaraciones 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 la aplicación didFinishLaunchingWithOptions.

[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 compartir secretos de la 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:

Configúrelo o inícielo con la Clave Secreta de la Aplicación.
Si el código se puede llamar varias veces, comprueba si App Center ya está configurado.
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á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 Agregar funcionalidades de Internet para aplicaciones de espacio aislado

Si la aplicación usa el Sandbox de la aplicación, debes configurar la capacidad para permitir conexiones salientes (cliente), de modo que la aplicación pueda acceder a Internet. Xcode 9 activa el sandbox de la aplicación de forma predeterminada, pero las funciones para 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, ya estás listo para visualizar los datos de Analíticas y Bloqueos en el portal que el SDK recopila automáticamente.

Consulte los documentos de Análisis de App Center y los documentos de Bloqueos de App Center para obtener información sobre cómo personalizar y usar características avanzadas de cada servicio.

Compartir a través de

Introducción a macOS

1. Prerrequisitos

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

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

3.1 Integración a través de Cocoapods

3.2 Integración a través de Carthage

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

3.4 Integración copiando los archivos binarios en el proyecto

4. Iniciar el SDK

4.1 Agregar las declaraciones import

4.2 Agregar el start:withServices: método

4.3 Reemplace el marcador de posición por la clave secreta de la aplicación

4.4 Agregar funcionalidades de Internet para aplicaciones de espacio aislado

Comentarios

Recursos adicionales

4.2 Agregar el `start:withServices:` método