Migrar do HockeySDK para o WPF/Winforms do App Center

  • Artigo

Importante

O Visual Studio App Center está programado para ser desativado em 31 de março de 2025. Embora você possa continuar a usar o Visual Studio App Center até que ele seja totalmente desativado, há várias alternativas recomendadas para as quais você pode considerar migrar.

Saiba mais sobre linhas do tempo e alternativas de suporte.

Siga esta documentação se você quiser atualizar seu aplicativo para usar o SDK do App Center em vez do HockeySDK.

1. Atualizar as bibliotecas

Substitua o pacote NuGet HockeySDK.WPF pelos do App Center em todos os projetos em sua solução.

Visual Studio para Windows

  • Abra o Visual Studio para Windows.
  • Clique em Abrir Arquivo>e escolha sua solução.
  • No navegador da solução, clique com o botão direito do mouse em Referências e escolha Gerenciar Pacotes NuGet.
  • Remova o pacote HockeySDK.WPF .
  • Pesquise o App Center e instale os pacotes Microsoft.AppCenter.Analytics e Microsoft.AppCenter.Crashes .

Console do Gerenciador de Pacotes

  • Abra o console no Visual Studio. Para fazer isso, escolha FerramentasConsole do Gerenciador dePacotes>>NuGet.
  • Se você estiver trabalhando em Visual Studio para Mac, verifique se você tem extensões de gerenciamento de pacotes NuGet instaladas. Para isso, escolhaExtensões do Visual Studio>, pesquise NuGet e instale, se necessário.
  • Digite os seguintes comandos no console:
Uninstall-Package HockeySDK.WPF
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

O SDK do App Center usa uma abordagem modular– você pode escolher quais serviços deseja integrar. Você deve adicionar cada módulo do SDK como uma dependência separada nesta seção.

2. Atualizar o código de instalação do SDK

2.1 Converter o identificador do aplicativo

O SDK do App Center usa identificadores de aplicativo no formato GUID (identificador global exclusivo). A ID do aplicativo HockeyApp pode ser usada pelo App Center, mas você precisa convertê-la em um formato diferente. Para converter o identificador, você deve adicionar quatro hifens para obter 8-4-4-4-12 a representação.

Antes (HockeyApp): 00112233445566778899aabbccddeeff

Depois (App Center): 00112233-4455-6677-8899-aabbccddeeff

2.2 Substituir a inicialização do SDK no código do aplicativo

  1. Remova o código de registro antigo do HockeyApp. Na declaração de using instrução, remova a seguinte linha:

    using Microsoft.HockeyApp;

    No início do construtor da classe App, remova a seguinte linha:

    HockeyClient.Current.Configure("Your_App_ID");

  2. Inicie o SDK do App Center. Adicione os namespaces apropriados antes de usar nossas APIs.

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

    Adicione a seguinte chamada ao construtor do aplicativo:

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

3. Comparação de serviços e recursos

Núcleo

Recurso HockeyApp App Center
Ajustar o nível de log Yes AppCenter.LogLevel

Análise

Recurso HockeyApp App Center
Acompanhar sessões automaticamente Yes Informações de sessão e dispositivo
Eventos personalizados com propriedades HockeyClient.TrackEvent Analytics.TrackEvent

Falhas

Recurso HockeyApp App Center
Enviar falhas automaticamente Habilitado por padrão Relatórios de Falhas
Anexar metadados adicionais Yes Adicionando anexos
Acompanhar exceções tratadas HockeyClient.Current.TrackException Erros tratados

Distribuição

O SDK do App Center ainda não dá suporte à distribuição para aplicativos WPF/Winforms.

Serviço de Comentários

O serviço de comentários não terá suporte no App Center. Consulte Os comentários do HockeyApp.