Partager via


Migrer vers app Center SDK 4.0.0 et versions ultérieures

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.

Pour éviter un conflit d’affectation de noms avec des classes dans les frameworks privés d’Apple, le KIT de développement logiciel (SDK) utilise MSAC désormais le préfixe au lieu de modifier l’API sdk MS .

L’API Swift a maintenant un style plus rapide , et toutes les classes doivent être utilisées sans préfixe, par exemple AppCenter. Des modifications ont également été apportées à l’attribution de noms aux fonctions et aux propriétés en fonction des meilleures pratiques d’Apple Swift.

Mettre à jour le Kit de développement logiciel (SDK) App Center

Tout d’abord, mettez à jour le Kit de développement logiciel (SDK) App Center à l’aide de l’un des gestionnaires de dépendances.

Utilisation des API

Le moyen le plus rapide et le plus pratique de mettre à jour l’API du KIT de développement logiciel (SDK) App Center consiste à utiliser la correction automatique. Après le remplacement, vous devez obtenir le résultat comme indiqué ci-dessous.

Avant de mettre à jour le Kit de développement logiciel (SDK) App Center vers et versions 4.0.0 ultérieures.

[MSAppCenter start:@"{Your App Secret}" withServices:@[[MSAnalytics class], [MSCrashes class]]];
MSAppCenter.start("{Your App Secret}", withServices: [MSAnalytics.self, MSCrashes.self])

Après la mise à jour du Kit de développement logiciel (SDK) App Center vers et versions 4.0.0 ultérieures.

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

En outre, le getter [MSACWrapperCrashesHelper getCrashHandlerSetupDelegate] est maintenant déconseillé, veuillez utiliser [MSACWrapperCrashesHelper crashHandlerSetupDelegate] à la place.

Les tableaux suivants indiquent les API qui ont été renommées.

App Center Core inférieur 4.0.0 App Center Core 4.0.0+ (ObjC) App Center Core 4.0.0+ (Swift)
MSAppCenter MSACAppCenter AppCenter
MSLogLevel MSACLogLevel LogLevel
MSLogLevelVerbose MSACLogLevelVerbose LogLevel.verbose
MSLogLevelWarning MSACLogLevelWarning .Avertissement
MSLogLevelInfo MSACLogLevelInfo .Info
MSLogLevelAssert MSACLogLevelAssert .Affirmer
MSLogHandler MSACLogHandler Gestionnaire de journaux
MSLogMessageProvider MSACLogMessageProvider LogMessageProvider
App Center Analytics inférieur 4.0.0 App Center Analytics 4.0.0+ (ObjC) App Center Alanlytics 4.0.0+ (Swift)
MSAnalytics MSACAnalytics Analytics
MSFlags MSACFlags Indicateurs
MSFlagsNormal MSACFlagsNormal Flags.normal
MSFlagsCritical MSACFlagsCritical .Critique
MSFlagsDefault MSACFlagsDefault .Par défaut
MSEventProperties MSACEventProperties EventProperties
App Center se bloque plus bas 4.0.0 App Center se bloque 4.0.0+ (ObjC) App Center se bloque 4.0.0+ (Swift)
MSCrashes MSACCrashes Crashes
MSCrashesDelegate MSACCrashesDelegate IncidentsDelegate
MSErrorReport MSACErrorReport ErrorReport
MSErrorAttachmentLog MSACErrorAttachmentLog ErrorAttachmentLog
MSUserConfirmationDontSend MSACUserConfirmationDontSend UserConfirmation.dontSend
MSUserConfirmationSend MSACUserConfirmationSend .Envoyer
MSUserConfirmationAlways MSACUserConfirmationAlways .Toujours
MSUserConfirmationHandler MSACUserConfirmationHandler UserConfirmationHandler
App Center Distribuer plus bas 4.0.0 App Center Distribute 4.0.0+ (ObjC) App Center Distribuer 4.0.0+ (Swift)
MSDistribute MSACDistribute Distribuer
MSDistributeDelegate MSACDistributeDelegate DistributeDelegate
MSCrashHandlerSetupDelegate MSACCrashHandlerSetupDelegate CrashHandlerSetupDelegate
MSReleaseDetails MSACReleaseDetails ReleaseDetails
MSUpdateAction MSACUpdateAction UpdateAction
MSUpdateActionUpdate MSACUpdateActionUpdate UpdateAction.update
MSUpdateActionPostpone MSACUpdateActionPostpone .Reporter
MSUpdateTrack MSACUpdateTrack UpdateTrack
MSUpdateTrackPublic MSACUpdateTrackPublic UpdateTrack.public
MSUpdateTrackPrivate MSACUpdateTrackPrivate .Privé

Modifications de l’API Swift

App Center Core inférieur 4.0.0 App Center Core 4.0.0+
MSAppCenter.isEnabled() AppCenter.enabled
MSAppCenter.setEnabled(true) AppCenter.enabled = true
MSAppCenter.isConfigured() AppCenter.isConfigured
MSAppCenter.isRunningInAppCenterTestCloud() AppCenter.isRunningInAppCenterTestCloud
MSAppCenter.isAppDelegateForwarderEnabled() AppCenter.isAppDelegateForwarderEnabled
MSAppCenter.installId() AppCenter.installId
MSAppCenter.isDebuggerAttached() AppCenter.isDebuggerAttached
MSAppCenter.sdkVersion() AppCenter.sdkVersion
MSAppCenter.setLogUrl(« {Url du journal} ») AppCenter.logUrl = « {Url du journal} »
MSAppCenter.setLogLevel(.verbose) AppCenter.logLevel = .verbose
MSAppCenter.setLogHandler(logHandler) AppCenter.logHandler = logHandler
MSAppCenter.SetUserId(« {Id utilisateur} ») AppCenter.userId = « {Id utilisateur} »
MSAppCenter.setCountryCode(« {Country Code} ») AppCenter.countryCode = « {Country Code} »
MSAppCenter.setAppSecret(« {App Secret} ») AppCenter.appSecret = « {App Secret} »
MSAppCenter.setString(« value », forKey : « key ») AppCenter.setString(« value », pour : « key »)
MSServiceAbstract.isAppSecretRequired() ServiceAbstract.isAppSecretRequired
MSAppCenter.addChannelUnitWithConfiguration(configuration) AppCenter.addChannelUnit(withConfiguration :configuration)
MSAppCenter.configureWithAppSecret(« {Secret d’application} ») AppCenter.configure(withAppSecret :"{App Secret} »)
MSAppCenter.start(« {App Secret} », withServices : [MSAnalytics.self]) AppCenter.start(withAppSecret : « {App Secret} », services : [Analytics.self])
MSAppCenter.startWithServices([MSAnalytics.self, MSCrashes.self]) AppCenter.start(services : [Analytics.self, Crash.self])
MSAppCenter.startFromLibraryWithServices([MSAnalytics.self]) AppCenter.startFromLibrary(services : [Analytics.self]) »)
App Center Analytics inférieur 4.0.0 App Center Analytics 4.0.0+
MSAnalytics.isEnabled() Analytics.enabled
MSAnalytics.setEnabled(true) Analytics.enabled = true
MSAnalytics.setTransmissionInterval(600) Analytics.transmissionInterval = 600
App Center se bloque plus bas 4.0.0 App Center se bloque 4.0.0+
MSCrashes.isEnabled() Crashes.enabled
MSCrashes.setEnabled(true) Crashes.enabled = true
MSCrashes.setDelegate(delegate) Crashes.delegate = délégué
MSCrashes.hasCrashedInLastSession() Crash.hasCrashedInLastSession
MSCrashes.hasReceivedMemoryWarningInLastSession() Crash.hasReceivedMemoryWarningInLastSession
MSErrorReport.isAppKill() ErrorReport.isAppKill
MSCrashes.lastSessionCrashReport() Crash.lastSessionCrashReport
MSCrashes.setAutomaticProcessing(true) Crashes.automaticProcessing = true
MSWrapperCrashesHelper.getCrashHandlerSetupDelegate WrapperCrashesHelper.crashHandlerSetupDelegate
MSWrapperCrashesHelper.setCrashHandlerSetupDelegate(délégué) WrapperCrashesHelper.crashHandlerSetupDelegate = délégué
MSCrashes.setUserConfirmationHandler(handler) Crash.userConfirmationHandler = gestionnaire
App Center Distribuer plus bas 4.0.0 Distribution d’App Center 4.0.0+
MSDistribute.isEnabled() Distribute.enabled
MSDistribute.setEnabled(true) Distribute.enabled = true
MSDistribute.setDelegate(delegate) Distribute.delegate = délégué
MSDistribute.setApiUrl(« {API URL} ») Distribute.apiUrl = « {API URL} »
MSDistribute.setInstallUrl(« {URL d’installation} ») Distribute.installUrl = « {Instal URL} »
MSDistribute.isMandatoryUpdate Distribute.mandatoryUpdate

PlantageSUpprimer les modifications

Avant de mettre à jour le Kit de développement logiciel (SDK) App Center vers et versions 4.0.0 ultérieures.

func crashes(_ crashes: MSCrashes!, shouldProcessErrorReport errorReport: MSErrorReport!) -> Bool

func crashes(_ crashes: MSCrashes!, willSend errorReport: MSErrorReport!)

func crashes(_ crashes: MSCrashes!, didSucceedSending errorReport: MSErrorReport!)

func crashes(_ crashes: MSCrashes!, didFailSending errorReport: MSErrorReport!, withError error: Error!)

func attachments(with crashes: MSCrashes, for errorReport: MSErrorReport) -> [MSErrorAttachmentLog]

Après la mise à jour du Kit de développement logiciel (SDK) App Center vers et versions 4.0.0 ultérieures.

func crashes(_ crashes: Crashes, shouldProcess errorReport: ErrorReport) -> Bool

func crashes(_ crashes: Crashes, willSend errorReport: ErrorReport)

func crashes(_ crashes: Crashes, didSucceedSending errorReport: ErrorReport)

func crashes(_ crashes: Crashes, didFailSending errorReport: ErrorReport, withError error: Error)

func attachments(with crashes: Crashes, for errorReport: ErrorReport) -> [ErrorAttachmentLog]

DistributionDelegate modifications

Avant de mettre à jour le Kit de développement logiciel (SDK) App Center vers et versions 4.0.0 ultérieures.

func distribute(_ distribute: MSDistribute!, releaseAvailableWith details: MSReleaseDetails!) -> Bool

Après la mise à jour du Kit de développement logiciel (SDK) App Center vers et versions 4.0.0 ultérieures.

  func distribute(_ distribute: Distribute, releaseAvailableWith details: ReleaseDetails) -> Bool