Compartir a través de

Migración de HockeySDK a WPF/Winforms de App Center

  • 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

Reemplace el paquete NuGet HockeySDK.WPF 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.
  • Quite el paquete HockeySDK.WPF .
  • 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 depaquetes.
  • Si está trabajando en Visual Studio para Mac, asegúrese de que tiene instaladas extensiones de administración de paquetes NuGet. Para ello, elijaExtensiones de Visual Studio>, busque NuGet e instale, si es necesario.
  • Escriba los siguientes comandos en la consola:
Uninstall-Package HockeySDK.WPF
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

El SDK de App Center usa un enfoque modular: puede elegir qué servicios desea integrar. 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 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 antiguo. En la declaración de instrucción using , quite la siguiente línea:

    using Microsoft.HockeyApp;

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

    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
Seguimiento automático de 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 Sí Agregar datos adjuntos
Seguimiento de excepciones controladas HockeyClient.Current.TrackException Errores controlados

Distribución

El SDK de App Center aún no admite la distribución de aplicaciones WPF/Winforms.

Servicio de comentarios

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