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

  • 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

  1. Abra una ventana de terminal, vaya a la carpeta del proyecto Cordova y ejecute el siguiente comando:

    cordova plugin add cordova-plugin-appcenter-analytics

  2. Vaya a la carpeta Su aplicación > plataformas > android > platform_www > plugins y elimine cordova-plugin-hockeyapp de ella.

1.2 Agregar nuevo SDK de App Center

El SDK de App Center está diseñado con un enfoque modular: solo puede integrar los servicios que le interesen. Vea las equivalencias en la tabla siguiente:

Módulo HockeyApp Módulo de App Center Comando de instalación
Crashes and Exceptions Crashes cordova plugin add cordova-plugin-appcenter-crashes
Metrics Analytics cordova plugin add cordova-plugin-appcenter-analytics

Ejecute uno de los comandos para instalar el módulo que necesita (o ambos).

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 de 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. Quite la inicialización de HockeyApp dentro del deviceready controlador:

    hockeyapp.start(null, null, "APP_ID");

  2. Configuración del SDK de App Center

    Abra el archivo config.xml del proyecto de Apache Cordova; para cada uno de los elementos de destino platform del proyecto de Apache Cordova (solo Android e iOS actualmente), agregue un elemento secundario preference con el siguiente formato:

    <preference name="APP_SECRET" value="{App Secret from the previous step}" />

    Para obtener más información, consulte la documentación de App Center Cordova.

  3. Reemplace todas 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
Identificación de usuarios hockeyapp.setUserName o hockeyapp.setUserEmail AppCenter.setUserId

Análisis

Característica HockeyApp App Center
Seguimiento automático de sesiones Documentación (no se puede deshabilitar) Documentación (habilitada de forma predeterminada)
Seguimiento de eventos hockeyapp.trackEvent Analytics.trackEvent

Bloqueos

Característica HockeyApp App Center
Envío automático de bloqueos Parámetro autoSend (deshabilitado de forma predeterminada) APPCENTER_CRASHES_ALWAYS_SEND (habilitado de forma predeterminada)
Adjuntar metadatos adicionales hockeyapp.addMetaData Documentación (se puede adjuntar desde el agente de escucha)
Generación de bloqueos de prueba hockeyapp.forceCrash AppCenter.Crashes.generateTestCrash
Mostrar un cuadro de diálogo en bloqueo ignoreDefaultHandler (deshabilitado de forma predeterminada, solo Android) AppCenter.Crashes.process (devolución de llamada al procesar un bloqueo)

Actualizaciones de versiones

App Center Distribute service todavía no se admite en el SDK de Cordova de App Center.

Servicio de comentarios

El servicio de comentarios no se admitirá en App Center. Consulta los comentarios de HockeyApp.