Migrar do HockeySDK para o SDK do App Center para Cordova

  • 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 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

  1. Abra uma janela do terminal, navegue até a pasta do projeto Cordova e execute o seguinte comando:

    cordova plugin add cordova-plugin-appcenter-analytics

  2. 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

  1. Remova a inicialização do HockeyApp dentro do deviceready manipulador:

    hockeyapp.start(null, null, "APP_ID");

  2. 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.

  3. 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.