Migración de HockeySDK al SDK de App Center para Cordova
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
Abra una ventana de terminal, vaya a la carpeta del proyecto Cordova y ejecute el siguiente comando:
cordova plugin add cordova-plugin-appcenter-analyticsVaya 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
Quite la inicialización de HockeyApp dentro del
devicereadycontrolador:hockeyapp.start(null, null, "APP_ID");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
platformdel proyecto de Apache Cordova (solo Android e iOS actualmente), agregue un elemento secundariopreferencecon 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.
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.