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