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