Migrar do HockeySDK para o SDK do App Center para Cordova

Artigo
03/17/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 a migração.

Saiba mais sobre linhas do tempo e alternativas de suporte.

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

1. Atualizar as bibliotecas

1.1 Remover HockeySDK antigo

Abra uma janela do terminal, navegue até a pasta do projeto Cordova e execute o seguinte comando:
```
cordova plugin add cordova-plugin-appcenter-analytics
```
Navegue até a pasta Plug-ins do Android > platform_www > plataformas > de aplicativo > e exclua cordova-plugin-hockeyapp dele.

1.2 Adicionar novo SDK do App Center

O SDK do App Center foi projetado com uma abordagem modular. Você pode integrar apenas os serviços nos quais está interessado. Confira as equivalências na próxima tabela:

Módulo HockeyApp	Módulo do App Center	Comando Instalar
`Crashes and Exceptions`	`Crashes`	`cordova plugin add cordova-plugin-appcenter-crashes`
`Metrics`	`Analytics`	`cordova plugin add cordova-plugin-appcenter-analytics`

Execute um dos comandos para instalar o módulo necessário (ou ambos).

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). Sua 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 uma representação 8-4-4-4-12.

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 a inicialização do HockeyApp dentro do deviceready manipulador:
```
hockeyapp.start(null, null, "APP_ID");
```
Configurar o SDK do App Center

Abra o arquivo deconfig.xml do projeto Apache Cordova; para cada um dos elementos de destino platform do projeto Apache Cordova (somente Android e iOS atualmente), adicione um elemento filho preference no seguinte formato:
```
<preference name="APP_SECRET" value="{App Secret from the previous step}" />
```
Para obter mais informações, consulte a documentação do App Center Cordova.
Substitua todas as chamadas à API do HockeyApp em todo o aplicativo. As tabelas detalhadas de mapeamento de API são fornecidas abaixo.

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

Núcleo

Recurso	HockeyApp	App Center
Identificar usuários	hockeyapp.setUserName ou hockeyapp.setUserEmail	AppCenter.setUserId

Análise

Recurso	HockeyApp	App Center
Acompanhar sessões automaticamente	Documentação (não pode ser desabilitada)	Documentação (habilitada por padrão)
Acompanhar eventos	hockeyapp.trackEvent	Analytics.trackEvent

Falhas

Recurso	HockeyApp	App Center
Enviar falhas automaticamente	parâmetro autoSend (desabilitado por padrão)	APPCENTER_CRASHES_ALWAYS_SEND (habilitado por padrão)
Anexar metadados adicionais	hockeyapp.addMetaData	Documentação (pode ser anexada do ouvinte)
Gerar falha de teste	hockeyapp.forceCrash	AppCenter.Crashes.generateTestCrash
Exibir uma caixa de diálogo em falha	ignoreDefaultHandler (desabilitado por padrão, somente Android)	AppCenter.Crashes.process (retorno de chamada ao processar uma falha)

Atualizações de versão

O serviço Distribuição do App Center ainda não tem suporte no SDK do Cordova do App Center.

Serviço de Comentários

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

Compartilhar via