Condividi tramite


Eseguire la migrazione ad App Center SDK 4.0.0 e versioni successive

Importante

Visual Studio App Center è pianificato per il ritiro il 31 marzo 2025. Anche se è possibile continuare a usare Visual Studio App Center fino a quando non viene completamente ritirato, esistono diverse alternative consigliate a cui è possibile prendere in considerazione la migrazione.

Altre informazioni sulle sequenze temporali di supporto e sulle alternative.

Per evitare un conflitto di denominazione con le classi nei framework privati di Apple, l'SDK ora usa MSAC il prefisso invece di MS modificare l'API SDK.

L'API Swift ha ora uno stile più rapido e tutte le classi devono essere usate senza un prefisso, ad esempio AppCenter. Esistono anche modifiche alla denominazione delle funzioni e delle proprietà in base alle procedure consigliate di Apple Swift.

Aggiornare App Center SDK

Prima di tutto, aggiornare App Center SDK usando uno dei gestori delle dipendenze.

Utilizzo delle API

Il modo più rapido e pratico per aggiornare l'API di App Center SDK consiste nell'usare la correzione automatica. Dopo la sostituzione, si dovrebbe ottenere il risultato, come illustrato di seguito.

Prima di aggiornare App Center SDK a 4.0.0 e versioni successive.

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

Dopo aver aggiornato App Center SDK a 4.0.0 e versioni successive.

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

Inoltre, il getter [MSACWrapperCrashesHelper getCrashHandlerSetupDelegate] è ora deprecato, usare [MSACWrapperCrashesHelper crashHandlerSetupDelegate] invece .

Le tabelle seguenti illustrano le API rinominate.

App Center Core inferiore 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 .Avviso
MSLogLevelInfo MSACLogLevelInfo .Informazioni
MSLogLevelAssert MSACLogLevelAssert .Affermare
MSLogHandler MSACLogHandler LogHandler
MSLogMessageProvider MSACLogMessageProvider LogMessageProvider
Analisi di App Center inferiore 4.0.0 App Center Analytics 4.0.0+ (ObjC) App Center Alanlytics 4.0.0+ (Swift)
MSAnalytics MSACAnalytics Analisi
MSFlags MSACFlags Flags
MSFlagsNormal MSACFlagsNormal Flags.normal
MSFlagsCritical MSACFlagsCritical .Critico
MSFlagsDefault MSACFlagsDefault .Predefinito
MSEventProperties MSACEventProperties EventProperties
Arresto anomalo di App Center inferiore 4.0.0 Arresti 4.0.0anomali di App Center + (ObjC) Arresti 4.0.0anomali di App Center + (Swift)
MSCrashes MSACCrashes Crashes
MSCrashesDelegate MSACCrashesDelegate CrashesDelegate
MSErrorReport MSACErrorReport ErrorReport
MSErrorAttachmentLog MSACErrorAttachmentLog ErrorAttachmentLog
MSUserConfirmationDontSend MSACUserConfirmationDontSend UserConfirmation.dontSend
MSUserConfirmationSend MSACUserConfirmationSend .Invia
MSUserConfirmationAlways MSACUserConfirmationAlways .Sempre
MSUserConfirmationHandler MSACUserConfirmationHandler UserConfirmationHandler
App Center Distribuisci in basso 4.0.0 App Center Distribute 4.0.0+ (ObjC) App Center Distribute 4.0.0+ (Swift)
MSDistribute MSACDistribute Distribuzione
MSDistributeDelegate MSACDistributeDelegate DistributeDelegate
MSCrashHandlerSetupDelegate MSACCrashHandlerSetupDelegate CrashHandlerSetupDelegate
MSReleaseDetails MSACReleaseDetails ReleaseDetails
MSUpdateAction MSACUpdateAction UpdateAction
MSUpdateActionUpdate MSACUpdateActionUpdate UpdateAction.update
MSUpdateActionPostpone MSACUpdateActionPostpone .Rimandare
MSUpdateTrack MSACUpdateTrack UpdateTrack
MSUpdateTrackPublic MSACUpdateTrackPublic UpdateTrack.public
MSUpdateTrackPrivate MSACUpdateTrackPrivate .Privato

Modifiche all'API Swift

App Center Core inferiore 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 log}") AppCenter.logUrl = "{Url log}"
MSAppCenter.setLogLevel(.verbose) AppCenter.logLevel = .verbose
MSAppCenter.setLogHandler(logHandler) AppCenter.logHandler = logHandler
MSAppCenter.SetUserId("{User Id}") AppCenter.userId = "{Id utente}"
MSAppCenter.setCountryCode("{Country Code}") AppCenter.countryCode = "{Country Code}"
MSAppCenter.setAppSecret("{Segreto app}") AppCenter.appSecret = "{Segreto app}"
MSAppCenter.setString("value", forKey: "key") AppCenter.setString("value", per: "key")
MSServiceAbstract.isAppSecretRequired() ServiceAbstract.isAppSecretRequired
MSAppCenter.addChannelUnitWithConfiguration(configuration) AppCenter.addChannelUnit(withConfiguration:configuration)
MSAppCenter.configureWithAppSecret("{Segreto app}") AppCenter.configure(withAppSecret:"{App Secret}")
MSAppCenter.start("{App Secret}", withServices: [MSAnalytics.self]) AppCenter.start(withAppSecret: "{App Secret}", servizi: [Analytics.self])
MSAppCenter.startWithServices([MSAnalytics.self, MSCrashes.self]) AppCenter.start(services: [Analytics.self, Crashes.self])
MSAppCenter.startFromLibraryWithServices([MSAnalytics.self]) AppCenter.startFromLibrary(services: [Analytics.self]) ")
App Center Analytics inferiore 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
Arresto anomalo di App Center inferiore 4.0.0 Arresti anomali di App Center 4.0.0+
MSCrashes.isEnabled() Arresti anomali.enabled
MSCrashes.setEnabled(true) Arresti anomali.enabled = true
MSCrashes.setDelegate(delegate) Crashes.delegate = delegato
MSCrashes.hasCrashedInLastSession() Crashes.hasCrashedInLastSession
MSCrashes.hasReceivedMemoryWarningInLastSession() Crashes.hasReceivedMemoryWarningInLastSession
MSErrorReport.isAppKill() ErrorReport.isAppKill
MSCrashes.lastSessionCrashReport() Arresti anomali.lastSessionCrashReport
MSCrashes.setAutomaticProcessing(true) Arresti anomali.automaticProcessing = true
MSWrapperCrashesHelper.getCrashHandlerSetupDelegate WrapperCrashesHelper.crashHandlerSetupDelegate
MSWrapperCrashesHelper.setCrashHandlerSetupDelegate(delegate) WrapperCrashesHelper.crashHandlerSetupDelegate = delegate
MSCrashes.setUserConfirmationHandler(handler) Crashes.userConfirmationHandler = gestore
App Center Distribuisci in basso 4.0.0 Distribuzione di App Center 4.0.0+
MSDistribute.isEnabled() Distribute.enabled
MSDistribute.setEnabled(true) Distribute.enabled = true
MSDistribute.setDelegate(delegate) Distribute.delegate = delegate
MSDistribute.setApiUrl("{API URL}") Distribute.apiUrl = "{URL API}"
MSDistribute.setInstallUrl("{URL di installazione}") Distribute.installUrl = "{Instal URL}"
MSDistribute.isMandatoryUpdate Distribute.mandatoryUpdate

Arresti anomaliDelegate modifiche

Prima di aggiornare App Center SDK a 4.0.0 e versioni successive.

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]

Dopo aver aggiornato App Center SDK a 4.0.0 e versioni successive.

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]

Modifiche di DistributeDelegate

Prima di aggiornare App Center SDK a 4.0.0 e versioni successive.

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

Dopo aver aggiornato App Center SDK a 4.0.0 e versioni successive.

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