Compartir a través de


Introducción a las extensiones de macOS

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.

Las extensiones solo admiten informes de fallos.

Para obtener información sobre cómo agregar el SDK de App Center a la aplicación contenedora, consulte la documentación de Introducción a MacOS de App Center.

Vamos a empezar a configurar el SDK de macOS de App Center en la extensión de tu aplicación para usar fallos de App Center.

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.

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

Nota:

El uso de un secreto de aplicación existente de otro proyecto de macOS tiene efectos secundarios. App Center no admite el filtrado por proyecto en la misma aplicación de App Center. Por ejemplo, enumerar los fallos de una versión específica enumerará todos los fallos de ambos proyectos para esta versión sin distinción de origen. Puede resultar confuso.

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. Agregar los módulos del SDK de App Center

El SDK de App Center se puede integrar en la aplicación a través de Cocoapods, Carthage 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 Crashes en tu aplicación. Esto incluye los siguientes frameworks: AppCenter y AppCenterCrashes.

     pod 'AppCenter/Crashes'
    
  2. Ejecute pod install para instalar el pod recién definido y abra el proyecto .xcworkspace.

Nota:

Si ve un error como [!] Unable to find a specification for `AppCenter` al ejecutar pod install, ejecute pod repo update para obtener los pods más recientes del repositorio Cocoapods y, a continuación, ejecute pod install.

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 en la aplicación. Esto extrae todos los marcos de trabajo. A continuación, solo puede vincular esos marcos para usarlos 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. 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 y AppCenterCrashes.framework desde la carpeta Carthage/Build/ 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.

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 binarios compilados en el proyecto de Xcode para configurar App Center Crashes en la extensión de la aplicación.

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.

  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 en 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 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 extensión de la aplicación no se compilará.
    • Aparecerá un cuadro de diálogo, asegúrese de que el destino de la extensión de la aplicación esté seleccionado. A continuación, haga clic en Finalizar.

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

4. Iniciar el SDK

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

4.1 Agregar las declaraciones import

Inserte las líneas siguientes en el archivo que contiene el punto de entrada de la extensión de la aplicación. Por ejemplo, dentro del archivo ViewController principal de una extensión Today.

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

4.2 Agregar el start:withServices: método

Inserte la siguiente línea en el punto de entrada de la extensión de la aplicación. Por ejemplo, dentro del viewDidLoad método del archivo ViewController principal de una extensión Today.

[MSACAppCenter start:@"{Your App Secret}" withServices:@[[MSACCrashes class]]];
AppCenter.start(withAppSecret: "{Your App Secret}", services: [Crashes.self])

Actualmente, solo se admiten informes de fallos para extensiones para aplicaciones.

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

Genial, estás listo para visualizar datos de fallos en el portal que el SDK recopila automáticamente.

Consulte la documentación de Errores de App Center para aprender a personalizar su extensión de aplicación y utilizar funcionalidades más avanzadas.