Migración de HockeySDK a App Center para UWP

  • Artículo

Importante

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

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

1. Actualizar las bibliotecas

Nota

Las plataformas como WinRT, Windows Phone 8.0 y 8.1, WPF y PCL no se admiten en el SDK de App Center. Puede seguir usando hockeySDK con ellos.

Reemplace el paquete NuGet HockeySDK.UWP por los de App Center en todos los proyectos de la solución.

Visual Studio para Windows

  • Abra Visual Studio para Windows.
  • Haga clic en Abrir archivo>y elija la solución.
  • En el navegador de soluciones, haga clic con el botón derecho en Referencias y elija Administrar paquetes NuGet.
  • Quita el paquete HockeySDK.UWP .
  • Busque App Center e instale los paquetes Microsoft.AppCenter.Analytics y Microsoft.AppCenter.Crashes .

Consola del Administrador de paquetes

  • Abra la consola en Visual Studio. Para ello, elija Herramientas>Consola del Administrador> de paquetes NuGet Administrador de paquetes.
  • Si está trabajando en Visual Studio para Mac, asegúrese de que ha instalado extensiones de administración de paquetes NuGet. Para ello, elijaExtensionesde Visual Studio>, busque NuGet e instale, si es necesario.
  • Escriba el siguiente comando en la consola:
Uninstall-Package HockeySDK.UWP
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

El SDK de App Center usa un enfoque modular: solo puede integrar los servicios que le interesan. Debe agregar cada módulo del SDK como una dependencia independiente en esta sección.

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

2.1 Convertir el identificador de la 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 8-4-4-4-12 representación.

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 el código de registro de HockeyApp anterior.

    En la declaración de instrucción using , quite la siguiente línea:

    using Microsoft.HockeyApp;

    Al principio del constructor de clase App, quite la línea siguiente:

    HockeyClient.Current.Configure("Your_App_ID");

  2. Inicie el SDK de App Center.

    Agregue los espacios de nombres adecuados antes de usar nuestras API.

    using Microsoft.AppCenter;
using Microsoft.AppCenter.Analytics;
using Microsoft.AppCenter.Crashes;

    Agregue la siguiente llamada al constructor de la aplicación:

    AppCenter.Start("{Your App Secret}",  typeof(Analytics), typeof(Crashes));

3. Comparación de servicios y características

Core

Característica HockeyApp App Center
Ajuste del nivel de registro Sí AppCenter.LogLevel

Análisis

Característica HockeyApp App Center
Realizar un seguimiento automático de las sesiones Sí Información de sesión y dispositivo
Eventos personalizados con propiedades HockeyClient.TrackEvent Analytics.TrackEvent

Bloqueos

Característica HockeyApp App Center
Envío automático de bloqueos Habilitado de forma predeterminada Informe de bloqueos
Adjuntar metadatos adicionales Yes No compatible
Seguimiento de excepciones controladas HockeyClient.Current.TrackException No compatible

Distribución

El SDK de App Center aún no admite la distribución de aplicaciones para UWP.

Servicio de comentarios

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