Freigeben über


Migrieren zu App Center SDK 4.0.0 und höher

Von Bedeutung

Visual Studio App Center wurde am 31. März 2025 eingestellt, mit Ausnahme der Analyse- und Diagnosefeatures, die bis zum 30. Juni 2026 weiterhin unterstützt werden. Weitere Informationen

Um einen Namenskonflikt mit Klassen in den privaten Frameworks von Apple zu vermeiden, verwendet das SDK jetzt das Präfix MSAC anstelle von MS, was die SDK-API ändert.

Die Swift-API verfügt jetzt über einen schnelleren Stil, und alle Klassen sollten ohne Präfix verwendet werden, z. B. AppCenter. Es gibt auch Änderungen in der Benennung von Funktionen und Eigenschaften, die den besten Praktiken von Apple Swift folgen.

Aktualisieren des App Center SDK

Aktualisieren Sie zunächst das App Center SDK mithilfe eines der Abhängigkeitsmanager.

Verwendung von APIs

Die schnellste und bequemste Methode zum Aktualisieren der App Center SDK-API ist die Verwendung der AutoKorrektur. Nach dem Ersatz sollten Sie das Ergebnis wie unten gezeigt erhalten.

Vor dem Aktualisieren des App Center SDK auf 4.0.0 und höher.

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

Nach dem Aktualisieren des App Center SDK auf 4.0.0 und höher.

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

Darüber hinaus ist der Getter [MSACWrapperCrashesHelper getCrashHandlerSetupDelegate] jetzt veraltet, verwenden Sie stattdessen [MSACWrapperCrashesHelper crashHandlerSetupDelegate] .

In den folgenden Tabellen sind die APIs aufgeführt, die umbenannt wurden.

App Center Core unten 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 .Warnung
MSLogLevelInfo MSACLogLevelInfo .Info
MSLogLevelAssert MSACLogLevelAssert .assert
MSLogHandler MSACLogHandler LogHandler
MSLogMessageProvider MSACLogMessageProvider Lognachrichtenanbieter
App Center Analytics senken 4.0.0 App Center Analytics 4.0.0+ (ObjC) App Center Alanlytics 4.0.0+ (Swift)
MSAnalytics MSACAnalytics Analysen
MSFlags MSACFlags Flaggen
MSFlagsNormal MSACFlagsNormal Flaggen.normal
MSFlagsCritical MSACFlagsCritical .Kritisch
MSFlagsDefault MSACFlagsDefault .Vorgabe
MSEventProperties MSACEventProperties Ereigniseigenschaften
App Center stürzt niedriger ab 4.0.0 App Center stürzt ab 4.0.0( ObjC) App Center stürzt 4.0.0ab ( Swift)
MSCrashes MSAC Abstürze Abstürze
MSCrashesDelegate MSACCrashesDelegate CrashesDelegate
MSErrorReport MSACErrorReport Fehlermeldung
MSErrorAttachmentLog MSACErrorAttachmentLog Fehleranhangsprotokoll
MSBenutzerbestätigungNichtSenden MSACBenutzerbestätigungNichtSenden UserConfirmation.dontSend
MSUserConfirmationSend Benutzerbestätigung senden durch MSAC .Senden
MSUserConfirmationAlways MSACUserConfirmationAlways .immer
MSUserConfirmationHandler MSACUserConfirmationHandler Benutzerbestätigungsbehandler
App Center weiter unten verteilen 4.0.0 App Center Verteilen 4.0.0+ (ObjC) App Center Verteilen 4.0.0+ (Swift)
MSDistribute MSACDistribute Verteilen
MSDistributeDelegate MSACDistributeDelegate VerteileDelegiere
MSCrashHandlerSetupDelegate MSACCrashHandlerSetupDelegate CrashHandlerSetupDelegate
MS-Veröffentlichungsdetails MSACReleaseDetails Veröffentlichungsdetails
MSUpdateAction MSACUpdateAction Aktualisierungsaktion
MSUpdateAktionsAktualisierung MSACUpdateActionUpdate UpdateAktion.aktualisieren
MicrosoftAktualisierungsaktionVerschieben MSACAktualisierungsaktionVerschieben .verschieben
MSUpdateTrack AktualisierungspfadMSAC UpdateTrack
MSUpdateTrackPublic MSACUpdateTrackPublic UpdateTrack.public
MSUpdateTrackPrivate MSACUpdateTrackPrivate .privat

Swift-API-Änderungen

App Center Core unten 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("{Log Url}") AppCenter.logUrl = "{Log Url}"
MSAppCenter.setLogLevel(.verbose) AppCenter.logLevel = .verbose
MSAppCenter.setLogHandler(logHandler) AppCenter.logHandler = logHandler
MSAppCenter.SetUserId("{User Id}") AppCenter.userId = "{User Id}"
MSAppCenter.setCountryCode("{Country Code}") AppCenter.countryCode = "{Country Code}"
MSAppCenter.setAppSecret("{App Secret}") AppCenter.appSecret = "{App Secret}"
MSAppCenter.setString("value", forKey: "key") AppCenter.setString("value", for: "key")
MSServiceAbstract.isAppSecretRequired() ServiceAbstract.isAppSecretRequired
MSAppCenter.addChannelUnitWithConfiguration(configuration) AppCenter.addChannelUnit(mitKonfiguration:konfiguration)
MSAppCenter.configureWithAppSecret("{App Secret}") AppCenter.configure(withAppSecret:"{App Secret}")
MSAppCenter.start("{App Secret}", withServices: [MSAnalytics.self]) AppCenter.start(withAppSecret: "{App Secret}", Dienste: [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 senken 4.0.0 App Center Analytics 4.0.0+
MSAnalytics.isEnabled() Analyse.aktiviert
MSAnalytics.setEnabled(true) Analytics.enabled = true
MSAnalytics.setTransmissionInterval(600) Analytics.transmissionInterval = 600
App Center stürzt niedriger ab 4.0.0 App Center stürzt ab 4.0.0+
MSCrashes.isEnabled() Abstürze aktiviert
MSCrashes.setEnabled(true) Crashes.enabled = true
MSCrashes.setDelegate(delegate) Crashes.delegate = Delegate
MSCrashes.hasCrashedInLastSession() Abstürze.istInDerLetztenSitzungAbgestürzt
MSCrashes.hasReceivedMemoryWarningInLastSession() Crashes.hatSpeicherwarnungInLetzterSitzungErhalten
MSErrorReport.isAppKill() ErrorReport.isAppKill
MSCrashes.lastSessionCrashReport() Crashes.LetzterSitzungsabsturzbericht
MSCrashes.setAutomaticProcessing(true) Abstürze.automatischeVerarbeitung = wahr
MSWrapperCrashesHelper.getCrashHandlerSetupDelegate WrapperAbstürzeHelfer.AbsturzbehandlungsEinrichtungsBevollmächtigter
MSWrapperCrashesHelper.setCrashHandlerSetupDelegate(delegate) WrapperCrashesHelper.crashHandlerSetupDelegate = delegate
MSCrashes.setUserConfirmationHandler(handler) Crashes.userConfirmationHandler = handler
App Center weiter unten verteilen 4.0.0 App Center verteilen 4.0.0+
MSDistribute.isEnabled() Verteilung.aktiviert
MSDistribute.setEnabled(true) Distribute.enabled = true
MSDistribute.setDelegate(delegate) Distribute.delegate = delegate
MSDistribute.setApiUrl("{API URL}") Distribute.apiUrl = "{API URL}"
MSDistribute.setInstallUrl("{Install URL}") Distribute.installUrl = "{Install URL}"
MSDistribute.istPflichtaktualisierung Distribute.Pflichtupdate

CrashesDelegate-Änderungen

Vor dem Aktualisieren des App Center SDK auf 4.0.0 und höher.

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]

Nach dem Aktualisieren des App Center SDK auf 4.0.0 und höher.

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]

DistributeDelegate-Änderungen

Vor dem Aktualisieren des App Center SDK auf 4.0.0 und höher.

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

Nach dem Aktualisieren des App Center SDK auf 4.0.0 und höher.

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