Partager via


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

Important

Visual Studio App Center doit être mis hors service le 31 mars 2025. Bien que vous puissiez continuer à utiliser Visual Studio App Center jusqu’à ce qu’il soit entièrement mis hors service, il existe plusieurs alternatives recommandées vers lesquelles vous pouvez envisager de migrer.

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 / 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 avec des bibliothèques , supprimez les entrées de dépendance liées à HockeySDK.

  4. Supprimez 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-Mac" ligne du Podfile, puis exécutez pod install.

Carthage

Si vous avez ajouté le Kit de développement logiciel (SDK) à l’aide de Carthage, procédez comme suit :

  1. Supprimez les références HockeySDK de .Cartfile Supprimez 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 .

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’utilisation 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 qui vous permet d’utiliser tout ou partie des services. Consultez les équivalences dans le tableau suivant :

Classe HockeyApp Module App Center
MetricsManager Analytics
CrashManager Crashes

2. Mettre à jour le code d’installation du KIT de développement logiciel (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 (Global Unique Identifier). 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 journal [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
Envoyer automatiquement des incidents [[BITHockeyManager sharedHockeyManager].crashManager setAutoSubmitCrashReport: YES] Documentation (activée par défaut)
Générer un incident de test [[BITHockeyManager sharedHockeyManager].crashManager generateTestCrash] [MSACCrashes generateTestCrash]
Informations sur l’incident précédent [[BITHockeyManager sharedHockeyManager].crashManager lastSessionCrashDetails] [MSACCrashes lastSessionCrashReport]
Gestion des exceptions Mach [[BITHockeyManager sharedHockeyManager].disableMachExceptionHandler = YES] Documentation (activée par défaut)
Attacher 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]