Share via

Migrer du Kit de développement logiciel (SDK) HockeySDK vers le Kit de développement logiciel (SDK) App Center pour tvOS

  • Article

Important

La mise hors service de Visual Studio App Center est prévue pour le 31 mars 2025. Bien que vous puissiez continuer à utiliser Visual Studio App Center jusqu’à sa mise hors service complète, il existe plusieurs alternatives recommandées vers lesquelles vous pouvez envisager la migration.

En savoir plus sur les chronologies et les alternatives de support.

Suivez cette documentation si vous souhaitez mettre à jour votre application pour utiliser le Kit de développement logiciel (SDK) App Center au lieu de HockeySDK.

1. Mettre à jour les bibliothèques

1.1 Supprimer l’ancien HockeySDK

Manuel

Si vous avez ajouté le Kit de développement logiciel (SDK) manuellement, procédez comme suit :

  1. Supprimez HockeySDK.framework la référence du projet XCode. Cliquez sur le bouton Supprimer la référence , ne cliquez pas sur le bouton Déplacer dans la Corbeille .

  2. Ouvrez les paramètres de votre projet et sous l’onglet Paramètres de build dans les sectionsChemins / d’accès de recherche de l’infrastructure de recherche d’en-tête, supprimez les emplacements des fichiers d’en-tête liés à HockeySDK.

  3. Ouvrez les paramètres de votre projet et, sous l’onglet Phases de génération dans la section Lier un fichier binaire à des bibliothèques , supprimez les entrées de dépendance liées à HockeySDK.

  4. Supprimer HockeySDK.framework du système de fichiers.

Podfile

Si vous avez ajouté le Kit de développement logiciel (SDK) à l’aide de CocoaPods, supprimez la pod "HockeySDK-tvOS" ligne du podfile, puis exécutez pod install.

Carthage

  1. Supprimez les références HockeySDK du Cartfile. Supprimer Cartfile.Resolved du système de fichiers.

  2. Supprimez HockeySDK.framework et HockeySDK.framework.dSYM du projet XCode, puis cliquez sur le bouton Déplacer vers la Corbeille .

  3. Ouvrez l’onglet Phases de génération et recherchez la section Exécuter le script. Supprimez HockeyApp de et input.xcfilelistoutput.xcfilelist.

1.2 Ajouter le nouveau Kit de développement logiciel (SDK) App Center

Le Kit de développement logiciel (SDK) App Center prend en charge l’intégration via Cocoapods, Carthage, Swift Package Manager et à l’aide des frameworks dans votre projet Xcode. Lisez des instructions détaillées sur l’intégration du Kit de développement logiciel (SDK) App Center dans la documentation du Kit de développement logiciel (SDK) App Center.

Notes

Le Kit de développement logiciel (SDK) App Center est conçu avec une approche modulaire afin que vous puissiez utiliser tous les services ou n’importe quel service. Consultez les équivalences dans le tableau suivant :

Classe HockeyApp Module App Center
MetricsManager Analytics
CrashManager Crashes

2. Mettre à jour le code d’installation du SDK

2.1 Convertir l’identificateur d’application

Le Kit de développement logiciel (SDK) App Center utilise des identificateurs d’application au format GUID (Identificateur global unique). Votre ID d’application HockeyApp peut être utilisé par App Center, mais vous devez le convertir dans un autre format. Pour convertir l’identificateur, vous devez ajouter quatre traits d’union pour obtenir une représentation 8-4-4-4-12.

Avant (HockeyApp) : 00112233445566778899aabbccddeeff

Après (App Center) : 00112233-4455-6677-8899-aabbccddeeff

2.2 Remplacer l’initialisation du Kit de développement logiciel (SDK) dans le code de l’application

  1. Remplacez les importations suivantes dans votre classe AppDelegate .

    Avant :

    @import HockeySDK;

    import HockeySDK

    Après :

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

    import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

  2. Remplacer le code d’inscription

    Recherchez la didFinishLaunchingWithOptions méthode et remplacez les occurrences de code HockeyApp.

    Avant :

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

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

    Après :

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

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

  3. Remplacez les appels d’API HockeyApp dans l’ensemble de l’application. Les tables de mappage d’API détaillées sont fournies ci-dessous.

3. Comparaison des services et des fonctionnalités

Core

Fonctionnalité HockeyApp App Center
Ajuster le niveau de journalisation [BITHockeyManager sharedHockeyManager].logLevel = BITLogLevelVerbose [MSACAppCenter setLogLevel :MSACLogLevelVerbose]

Analytics

HockeySDK collecte les métriques par défaut. Le Kit de développement logiciel (SDK) App Center ne collecte aucune métrique (analytique) par défaut. Pour collecter des métriques à l’aide du Kit de développement logiciel (SDK) App Center, passez MSACAnalytics à la start: méthode .

Fonctionnalité HockeyApp App Center
Suivre automatiquement les sessions Activée par défaut Documentation (activée par défaut)
Événements personnalisés avec des propriétés Yes [MSACAnalytics trackEvent :withProperties :]
Désactiver le service au moment de l’exécution [BITHockeyManager sharedHockeyManager].disableMetricsManager = YES [MSACAnalytics setEnabled :NO]

Crashes

Les rapports HockeySDK se bloquent par défaut. Les incidents sont immédiatement envoyés au serveur lors du prochain lancement de l’application. Le Kit de développement logiciel (SDK) App Center ne signale aucun incident par défaut. Pour collecter les incidents MSACCrashes à l’aide du Kit de développement logiciel (SDK) App Center, passez à la start: méthode .

Fonctionnalité HockeyApp App Center
L’envoi automatique se bloque Activée par défaut Documentation (activée par défaut)
Générer un incident de test [[BITHockeyManager sharedHockeyManager].crashManager generateTestCrash] [MSACCrashes generateTestCrash]
Informations sur le blocage précédent [[BITHockeyManager sharedHockeyManager].crashManager lastSessionCrashDetails] [MSACCrashes lastSessionCrashReport]
Joindre des métadonnées supplémentaires Yes Documentation (peut être jointe à partir d’un délégué)
Boîte de dialogue Personnaliser l’utilisateur setCrashReportUIHandler Documentation (non fournie par défaut)
Désactiver le service au moment de l’exécution [[BITHockeyManager sharedHockeyManager] setDisableCrashManager: YES] [MSACCrashes setEnabled :NO]