Migrar do HockeySDK para o SDK do App Center para tvOS

  • 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

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 , 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ções Caminhos de Pesquisa de Cabeçalho Caminhos / de PesquisaDa Estrutura Caminhos de Pesquisa, 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-tvOS" linha do Podfile e execute pod install.

Carthage

  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 a Lixeira .

  3. Abra a guia Fases de Build e localize a seção Executar Script . Remova HockeyApp do input.xcfilelist e output.xcfilelistdo .

1.2 Adicionar o novo SDK do App Center

O SDK do App Center dá suporte à integração por meio do 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). 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 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. As falhas serão enviadas imediatamente 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 Habilitado por padrão 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]
Anexar metadados adicionais Yes Documentação (pode ser anexada do delegado)
Personalizar 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]