Partager via


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

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.embeddedframework 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.embeddedframework 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" 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
UpdateManager Distribute

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 AppCenterDistribute;
    
    import AppCenter
    import AppCenterAnalytics
    import AppCenterCrashes
    import AppCenterDistribute
    
  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 sharedHockeyManager].authenticator authenticateInstallation];
    
    BITHockeyManager.shared().configure(withIdentifier: "APP_IDENTIFIER")
    BITHockeyManager.shared().start()
    BITHockeyManager.shared().authenticator.authenticateInstallation()
    

    Après :

    [MSACAppCenter start:@"{Your app secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class], [MSACDistribute class]]];
    
    AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self, Crashes.self, Distribute.self])
    

    Notes

    Le Kit de développement logiciel (SDK) App Center n’a pas d’équivalents pour [[BITHockeyManager sharedHockeyManager] configureWithBetaIdentifier:liveIdentifier:delegate].

  3. [Facultatif] Modifier le fichier Info.plist du projet

    Si vous envisagez d’utiliser Distribute, suivez les étapes ci-dessus :

    • Ajoutez une nouvelle clé pour URL types ou CFBundleURLTypes dans votre fichier Info.plist (au cas où XCode affiche votre Info.plist en tant que code source).
    • Remplacez la clé du premier élément enfant par URL Schemes ou CFBundleURLSchemes.
    • Entrez comme schéma d’URL et remplacez appcenter-${APP_SECRET} par ${APP_SECRET} le secret de l’application de votre application.

    Pour plus d’informations à ce sujet, consultez la documentation App Center Distribute.

  4. 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]
Identifier les installations [BITHockeyManager sharedHockeyManager].installString [MSACAppCenter installId]
Identifier les utilisateurs [BITHockeyManager sharedHockeyManager].userID [MSACAppCenter setUserId:@"your-user-id"]

Analytics

HockeySDK active la collecte des métriques par défaut. Le Kit de développement logiciel (SDK) App Center inscrit le service Analytics uniquement si vous passez Analytics la classe à la start méthode .

Fonctionnalité HockeyApp App Center
Suivre automatiquement les sessions Impossible de désactiver Documentation (ne peut pas être désactivée)
É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

HockeySDK active les rapports d’incident par défaut. Les incidents sont immédiatement envoyés au serveur lors du prochain lancement de l’application. Le SDK App Center inscrit le service Incidents uniquement si vous passez Crashes la classe à la start méthode .

Fonctionnalité HockeyApp App Center
Envoyer automatiquement des incidents [[BITHockeyManager sharedHockeyManager].crashManager setCrashManagerStatus: BITCrashManagerStatusAutoSend] 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 Désactivée par défaut 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 setAlertViewHandler Documentation (non fournie par défaut)
Désactiver le service au moment de l’exécution [[BITHockeyManager sharedHockeyManager] setDisableCrashManager: YES] [MSACCrashes setEnabled :NO]

Distribuer

Notes

Contrairement à HockeyApp, la fonctionnalité de mises à jour dans l’application App Center fonctionne UNIQUEMENT avec les builds distribuées à l’aide du service App Center Distribute. La distribution ne fonctionne pas lorsque le débogueur est attaché. Si l’application utilise un groupe de distribution privé, une fois l’application installée et ouverte pour la première fois après l’ajout du Kit de développement logiciel (SDK) App Center Distribute, un navigateur s’ouvre pour authentifier l’utilisateur et activer les mises à jour dans l’application. Ce navigateur s’ouvre également si vous définissez la piste de mise à jour privée dans l’application au moment de l’exécution. Il s’agit d’une étape unique qui ne se produira pas pour les versions ultérieures de votre application. Pour plus d’informations, consultez la documentation de distribution d’App Center .

HockeySDK n’active pas les mises à jour dans l’application par défaut. Le SDK App Center inscrit le service des mises à jour dans l’application uniquement si vous passez Distribute la classe à la start méthode . Ce module est activé par défaut, contrairement à HockeySDK.

Fonctionnalité HockeyApp App Center
Mises à jour restreintes dans l’application [[BITHockeyManager sharedHockeyManager].authenticator authenticateInstallation] MSACDistribute.updateTrack
Désactiver le service au moment de l’exécution [[BITHockeyManager sharedHockeyManager] setDisableUpdateManager: YES] [MSACDistribute setEnabled :NO]
Personnaliser la boîte de dialogue de mise à jour shouldDisplayUpdateAlertForUpdateManager Documentation