Share via

Migrar do HockeySDK para o SDK do Android 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

Abra o arquivo build.gradle no nível do aplicativo do projeto (app/build.gradle) e substitua a linha a dependencies { ... } seguir na configuração.

Antes:

implementation 'net.hockeyapp.android:HockeySDK:...'

Após:

def appCenterSdkVersion = '5.0.4'
implementation "com.microsoft.appcenter:appcenter-analytics:${appCenterSdkVersion}"
implementation "com.microsoft.appcenter:appcenter-crashes:${appCenterSdkVersion}"
implementation "com.microsoft.appcenter:appcenter-distribute:${appCenterSdkVersion}"

O SDK do App Center foi projetado com uma abordagem modular. Você pode integrar apenas os serviços nos quais está interessado. Cada módulo do SDK precisa ser adicionado como uma dependência separada nesta seção. Confira as equivalências na próxima tabela:

Classe HockeyApp Módulo do App Center
MetricsManager Analytics
CrashManager Crashes
UpdateManager Distribute

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 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. Substitua as importações a seguir em sua classe de atividade.

    Antes:

    import net.hockeyapp.android.CrashManager;
import net.hockeyapp.android.metrics.MetricsManager;
import net.hockeyapp.android.UpdateManager;

    Após:

    import com.microsoft.appcenter.AppCenter;
import com.microsoft.appcenter.analytics.Analytics;
import com.microsoft.appcenter.crashes.Crashes;
import com.microsoft.appcenter.distribute.Distribute;

  2. Substitua o código de registro dentro do retorno de chamada da classe onCreatede atividade main do aplicativo.

    Antes:

    CrashManager.register(this);
MetricsManager.register(getApplication());
UpdateManager.register(this);

    Após:

    AppCenter.start(getApplication(), "{Your App Secret}", Analytics.class, Crashes.class, Distribute.class);

    Se você usou metadados para fornecer o identificador de aplicativo, você deve copiá-lo de lá para o código de inicialização e remover

    <meta-data android:name="net.hockeyapp.android.appIdentifier" android:value="..." />

    do arquivo AndroidManifest.xml .

  3. Substitua 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
Ajustar o nível de log HockeyLog.setLogLevel AppCenter.setLogLevel
Identificar instalações Somente interno AppCenter.getInstallId
Identificar usuários Somente falhas AppCenter.setUserId

Análise

Recurso HockeyApp App Center
Acompanhar sessões automaticamente Sim, pode ser desabilitado por MetricsManager.setSessionTrackingDisabled Documentação (não pode ser desabilitada)
Eventos personalizados com propriedades MetricsManager.trackEvent Analytics.trackEvent
Desabilitar o serviço em runtime MetricsManager.disableUserMetrics e MetricsManager.enableUserMetrics Analytics.setEnabled

Falhas

Recurso HockeyApp App Center
Enviar falhas automaticamente Desabilitadas por padrão Documentação (habilitada por padrão)
Anexar metadados adicionais Yes Documentação (pode ser anexada do ouvinte)
Personalizar caixa de diálogo do usuário Yes Documentação (não fornecida por padrão)
Obter informações sobre a status de envio Yes Documentação
Informações sobre uma falha anterior CrashManager.getLastCrashDetails Crashes.getLastSessionCrashReport

Distribuir

Observação

Ao contrário do HockeyApp, o recurso de atualizações no aplicativo do App Center só funciona com builds release (por padrão) que são distribuídos usando o serviço Distribuição do App Center . Se o aplicativo estiver usando um grupo de distribuição privado, depois que o aplicativo for instalado e aberto pela primeira vez depois que o SDK de Distribuição do App Center for adicionado, um navegador será aberto para autenticar o usuário e habilitar atualizações no aplicativo. Esse navegador também será aberto se você definir a faixa de atualização privada no aplicativo em runtime. Esta é uma etapa única que não ocorrerá para versões subsequentes do seu aplicativo. Consulte a Documentação de Distribuição do App Center para obter mais detalhes.

Recurso HockeyApp App Center
Atualizações restritas no aplicativo LoginManager.verifyLogin Distribute.setUpdateTrack
Desabilitar o serviço em runtime UpdateManager.unregister Distribute.setEnabled
Personalizar a caixa de diálogo de atualização Yes Documentação

Serviço de Comentários

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