Compartir a través de

Migración de HockeySDK al SDK de App Center para macOS

  • Artículo

Importante

Visual Studio App Center está programado para la retirada 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 de soporte técnico y las alternativas.

Siga esta documentación si desea actualizar la aplicación para usar el SDK de App Center en lugar de HockeySDK.

1. Actualización de las bibliotecas

1.1 Quitar hockeySDK antiguo

Manual

Si ha agregado manualmente el SDK, siga estos pasos:

  1. Quite HockeySDK.framework la referencia del proyecto XCode. Haga clic en el botón Quitar referencia y no haga clic en el botón Mover a la papelera .

  2. Abra la configuración del proyecto y, en la pestaña Configuración de compilación, en las secciones Rutas de búsqueda del marco de búsqueda de encabezados / , quite las ubicaciones de los archivos de encabezado relacionados con HockeySDK.

  3. Abra la configuración del proyecto y, en la pestaña Fases de compilación, en la sección Vincular binario con bibliotecas , quite las entradas de dependencia relacionadas con HockeySDK.

  4. Elimine HockeySDK.framework del sistema de archivos.

Podfile

Si ha agregado el SDK mediante CocoaPods, quite la pod "HockeySDK-Mac" línea del podfile y, a continuación, ejecute pod install.

Carthage

Si ha agregado el SDK mediante Carthage, siga estos pasos:

  1. Quite las referencias de HockeySDK de Cartfile. Elimine Cartfile.Resolved del sistema de archivos.

  2. Elimine HockeySDK.framework y HockeySDK.framework.dSYM del proyecto XCode y haga clic en el botón Mover a la papelera .

1.2 Incorporación del nuevo SDK de App Center

El SDK de App Center admite la integración a través de Cocoapods, Carthage, Swift Package Manager y uso de los marcos del proyecto de Xcode. Lea instrucciones detalladas sobre cómo integrar el SDK de App Center en la documentación del SDK de App Center.

Nota

El SDK de App Center está diseñado con un enfoque modular para que pueda usar cualquiera o todos los servicios. Vea las equivalencias en la tabla siguiente:

HockeyApp (clase) Módulo de App Center
MetricsManager Analytics
CrashManager Crashes

2. Actualización del código de instalación del SDK

2.1 Convertir el identificador de aplicación

El SDK de App Center usa identificadores de aplicación en el formato de identificador único global (GUID). App Id. de HockeyApp se puede usar en App Center, pero debe convertirlo a un formato diferente. Para convertir el identificador, debe agregar cuatro guiones para obtener una representación 8-4-4-4-12.

Antes (HockeyApp): 00112233445566778899aabbccddeeff

Después (App Center): 00112233-4455-6677-8899-aabbccddeeff

2.2 Reemplazar la inicialización del SDK en el código de la aplicación

  1. Reemplace las siguientes importaciones en la clase AppDelegate .

    Antes:

    @import HockeySDK;

    import HockeySDK

    Después:

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

    import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

  2. Reemplazar el código de registro

    Busque el didFinishLaunchingWithOptions método y reemplace las repeticiones de código de HockeyApp.

    Antes:

    [[BITHockeyManager sharedHockeyManager] configureWithIdentifier:@"APP_IDENTIFIER"];
[[BITHockeyManager sharedHockeyManager] startManager];

    BITHockeyManager.shared().configure(withIdentifier: "APP_IDENTIFIER")
BITHockeyManager.shared().start()

    Después:

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

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

  3. Reemplace las llamadas API de HockeyApp en toda la aplicación. A continuación se indican las tablas detalladas de asignación de API.

3. Comparación de servicios y características

Core

Característica HockeyApp App Center
Ajuste del nivel de registro [BITHockeyManager sharedHockeyManager].logLevel = BITLogLevelVerbose [MSACAppCenter setLogLevel:MSACLogLevelVerbose]

Análisis

HockeySDK recopila métricas por valor predeterminado. El SDK de App Center no recopila ninguna métrica (análisis) por valor predeterminado. Para recopilar métricas mediante el SDK de App Center, pase MSACAnalytics al start: método .

Característica HockeyApp App Center
Seguimiento automático de sesiones Habilitado de forma predeterminada Documentación (habilitada de forma predeterminada)
Eventos personalizados con propiedades Sí [MSACAnalytics trackEvent:withProperties:]
Deshabilitación del servicio en tiempo de ejecución [BITHockeyManager sharedHockeyManager].disableMetricsManager = YES [MSACAnalytics setEnabled:NO]

Bloqueos

Los informes de HockeySDK se bloquean por defecto. Los bloqueos se enviarán inmediatamente al servidor la próxima vez que se inicie la aplicación. El SDK de App Center no notifica ningún bloqueo por valor predeterminado. Para recopilar bloqueos mediante el SDK de App Center, pase MSACCrashes al start: método .

Característica HockeyApp App Center
Envío automático de bloqueos [[BITHockeyManager sharedHockeyManager].crashManager setAutoSubmitCrashReport: YES] Documentación (habilitada de forma predeterminada)
Generación de un bloqueo de prueba [[BITHockeyManager sharedHockeyManager].crashManager generateTestCrash] [MSACCrashes generateTestCrash]
Información sobre el bloqueo anterior [[BITHockeyManager sharedHockeyManager].crashManager lastSessionCrashDetails] [MSACCrashes lastSessionCrashReport]
Control de excepciones mach [[BITHockeyManager sharedHockeyManager].disableMachExceptionHandler = YES] Documentación (habilitada de forma predeterminada)
Adjuntar metadatos adicionales Sí Documentación (se puede adjuntar desde el delegado)
Cuadro de diálogo Personalizar usuario setCrashReportUIHandler Documentación (no proporcionada de forma predeterminada)
Deshabilitación del servicio en tiempo de ejecución [[BITHockeyManager sharedHockeyManager] setDisableCrashManager: YES] [MSACCrashes setEnabled:NO]