Migrar do HockeySDK para o WPF/Winforms do App Center

Artigo
03/15/2024

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

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");
```

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.

Compartilhar via