Migrar do HockeySDK para o SDK do App Center para macOS

  • 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

Manual

Se você adicionou o SDK manualmente, siga estas etapas:

  1. Remova HockeySDK.framework a referência do projeto XCode. Clique no botão Remover referência e não clique no botão Mover para Lixeira .

  2. Abra as configurações do projeto e, na guia Configurações de Build, nas seçõesCaminhos de Pesquisa da Estrutura de Caminhos / de Pesquisa de Cabeçalho, remova os locais para arquivos de cabeçalho relacionados ao HockeySDK.

  3. Abra as configurações do projeto e, na guia Fases de Build , na seção Vincular Binário com Bibliotecas , remova as entradas de dependência relacionadas ao HockeySDK.

  4. Excluir HockeySDK.framework do sistema de arquivos.

Podfile

Se você adicionou o SDK usando CocoaPods, remova a pod "HockeySDK-Mac" linha do Podfile e execute pod install.

Carthage

Se você adicionou o SDK usando o Cartago, siga estas etapas:

  1. Remova as referências do HockeySDK do Cartfile. Excluir Cartfile.Resolved do sistema de arquivos.

  2. Exclua HockeySDK.framework e HockeySDK.framework.dSYM do projeto XCode e clique no botão Mover para Lixeira .

1.2 Adicionar o novo SDK do App Center

O SDK do App Center dá suporte para ser integrado por meio de Cocoapods, Carthage, Swift Package Manager e usando as Estruturas em seu projeto Xcode. Leia instruções detalhadas sobre como integrar o SDK do App Center na documentação do SDK do App Center.

Observação

O SDK do App Center foi projetado com uma abordagem modular para que você possa usar qualquer um ou todos os serviços. Confira as equivalências na próxima tabela:

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

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. Substitua as importações a seguir na classe AppDelegate .

    Antes:

    @import HockeySDK;

    import HockeySDK

    Após:

    @import AppCenter;
@import AppCenterAnalytics;
@import AppCenterCrashes;

    import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

  2. Substituir código de registro

    Localize o didFinishLaunchingWithOptions método e substitua as ocorrências de código do HockeyApp.

    Antes:

    [[BITHockeyManager sharedHockeyManager] configureWithIdentifier:@"APP_IDENTIFIER"];
[[BITHockeyManager sharedHockeyManager] startManager];

    BITHockeyManager.shared().configure(withIdentifier: "APP_IDENTIFIER")
BITHockeyManager.shared().start()

    Após:

    [MSACAppCenter start:@"{Your app secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];

    AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self, Crashes.self])

  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 [BITHockeyManager sharedHockeyManager].logLevel = BITLogLevelVerbose [MSACAppCenter setLogLevel:MSACLogLevelVerbose]

Análise

O HockeySDK coleta métricas por padrão. O SDK do App Center não coleta nenhuma métrica (análise) por padrão. Para coletar métricas usando o SDK do App Center, passe MSACAnalytics para o start: método .

Recurso HockeyApp App Center
Acompanhar sessões automaticamente Habilitado por padrão Documentação (habilitada por padrão)
Eventos personalizados com propriedades Yes [MSACAnalytics trackEvent:withProperties:]
Desabilitar o serviço em runtime [BITHockeyManager sharedHockeyManager].disableMetricsManager = YES [MSACAnalytics setEnabled:NO]

Falhas

O HockeySDK relata falhas por padrão. Falhas serão imediatamente enviadas ao servidor na próxima vez que o aplicativo for iniciado. O SDK do App Center não relata falhas por padrão. Para coletar falhas usando o SDK do App Center, passe MSACCrashes para o start: método .

Recurso HockeyApp App Center
Enviar falhas automaticamente [[BITHockeyManager sharedHockeyManager].crashManager setAutoSubmitCrashReport: YES] Documentação (habilitada por padrão)
Gerar uma falha de teste [[BITHockeyManager sharedHockeyManager].crashManager generateTestCrash] [MSACCrashes generateTestCrash]
Informações sobre a falha anterior [[BITHockeyManager sharedHockeyManager].crashManager lastSessionCrashDetails] [MSACCrashes lastSessionCrashReport]
Tratamento de exceção de mach [[BITHockeyManager sharedHockeyManager].disableMachExceptionHandler = YES] Documentação (habilitada por padrão)
Anexar metadados adicionais Yes Documentação (pode ser anexada do delegado)
Personalizar a caixa de diálogo do usuário setCrashReportUIHandler Documentação (não fornecida por padrão)
Desabilitar o serviço em runtime [[BITHockeyManager sharedHockeyManager] setDisableCrashManager: YES] [MSACCrashes setEnabled:NO]