Migrieren zu App Center SDK 4.0.0 und höher
Wichtig
Visual Studio App Center wird am 31. März 2025 eingestellt. Sie können Visual Studio App Center zwar weiterhin verwenden, bis es vollständig eingestellt ist, es gibt jedoch mehrere empfohlene Alternativen, zu denen Sie möglicherweise eine Migration in Erwägung ziehen.
Um einen Benennungskonflikt mit Klassen in den privaten Frameworks von MS Apple zu vermeiden, verwendet MSAC das SDK jetzt das Präfix, das die SDK-API ändert.
Swift-API hat jetzt einen schnelleren Stil, und alle Klassen sollten ohne Präfix verwendet werden, z. B. AppCenter. Es gibt auch Änderungen bei der Benennung von Funktionen und Eigenschaften, die auf den bewährten Methoden von Apple Swift basieren.
Aktualisieren des App Center SDK
Aktualisieren Sie zunächst das App Center SDK mithilfe eines der Abhängigkeits-Manager.
Verwendung von APIs
Die schnellste und bequemste Möglichkeit zum Aktualisieren der App Center SDK-API ist die Verwendung der Autokorrektur. Nach der Ersetzung sollten Sie das Ergebnis wie unten gezeigt erhalten.
Bevor Sie das App Center SDK auf und höher 4.0.0 aktualisieren.
[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, bitte verwenden [MSACWrapperCrashesHelper crashHandlerSetupDelegate] Sie stattdessen.
In den folgenden Tabellen sind die umbenannten APIs aufgeführt.
App Center Core niedriger 4.0.0 |
App Center Core 4.0.0+ (ObjC) |
App Center Core 4.0.0+ (Swift) |
|---|---|---|
| MSAppCenter | MSACAppCenter | App Center |
| MSLogLevel | MSACLogLevel | LogLevel |
| MSLogLevelVerbose | MSACLogLevelVerbose | LogLevel.verbose |
| MSLogLevelWarning | MSACLogLevelWarning | .Warnung |
| MSLogLevelInfo | MSACLogLevelInfo | .Informationen |
| MSLogLevelAssert | MSACLogLevelAssert | .Assert |
| MSLogHandler | MSACLogHandler | LogHandler |
| MSLogMessageProvider | MSACLogMessageProvider | LogMessageProvider |
App Center Analytics niedriger 4.0.0 |
App Center Analytics 4.0.0+ (ObjC) |
App Center Alanlytics 4.0.0+ (Swift) |
|---|---|---|
| MSAnalytics | MSACAnalytics | Analyse |
| MSFlags | MSACFlags | Flags |
| MSFlagsNormal | MSACFlagsNormal | Flags.normal |
| MSFlagsCritical | MSACFlagsCritical | .Kritisch |
| MSFlagsDefault | MSACFlagsDefault | .Standard |
| MSEventProperties | MSACEventProperties | EventProperties |
App Center-Abstürze niedriger 4.0.0 |
App Center stürzt ab 4.0.0+ (ObjC) |
App Center stürzt ab 4.0.0+ (Swift) |
|---|---|---|
| MSCrashes | MSACCrashes | Crashes |
| MSCrashesDelegate | MSACCrashesDelegate | AbstürzeDelegate |
| MSErrorReport | MSACErrorReport | ErrorReport |
| MSErrorAttachmentLog | MSACErrorAttachmentLog | ErrorAttachmentLog |
| MSUserConfirmationDontSend | MSACUserConfirmationDontSend | UserConfirmation.dontSend |
| MSUserConfirmationSend | MSACUserConfirmationSend | .Senden |
| MSUserConfirmationAlways | MSACUserConfirmationAlways | .Immer |
| MSUserConfirmationHandler | MSACUserConfirmationHandler | UserConfirmationHandler |
App Center Verteilen niedriger 4.0.0 |
App Center Verteilen 4.0.0+ (ObjC) |
App Center Verteilen 4.0.0+ (Swift) |
|---|---|---|
| MSDistribute | MSACDistribute | Verteilen |
| MSDistributeDelegate | MSACDistributeDelegate | DistributeDelegate |
| MSCrashHandlerSetupDelegate | MSACCrashHandlerSetupDelegate | CrashHandlerSetupDelegate |
| MSReleaseDetails | MSACReleaseDetails | ReleaseDetails |
| MSUpdateAction | MSACUpdateAction | UpdateAction |
| MSUpdateActionUpdateUpdate | MSACUpdateActionUpdateUpdate | UpdateAction.update |
| MSUpdateActionPostpone | MSACUpdateActionPostpone | .Verschieben |
| MSUpdateTrack | MSACUpdateTrack | UpdateTrack |
| MSUpdateTrackPublic | MSACUpdateTrackPublic | UpdateTrack.public |
| MSUpdateTrackPrivate | MSACUpdateTrackPrivate | .privat |
Schnelle API-Änderungen
App Center Core niedriger 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("{Benutzer-ID}") | AppCenter.userId = "{User Id}" |
| MSAppCenter.setCountryCode("{Ländercode}") | 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(withConfiguration:configuration) |
| MSAppCenter.configureWithAppSecret("{App Secret}") | 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, Crashes.self]) |
| MSAppCenter.startFromLibraryWithServices([MSAnalytics.self]) | AppCenter.startFromLibrary(services: [Analytics.self]) ") |
App Center Analytics niedriger 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-Abstürze niedriger 4.0.0 |
App Center-Abstürze 4.0.0+ |
|---|---|
| MSCrashes.isEnabled() | Crashes.enabled |
| MSCrashes.setEnabled(true) | Crashes.enabled = true |
| MSCrashes.setDelegate(delegate) | Crashes.delegate = delegate |
| MSCrashes.hasCrashedInLastSession() | Crashes.hasCrashedInLastSession |
| MSCrashes.hasReceivedMemoryWarningInLastSession() | Crashes.hasReceivedMemoryWarningInLastSession |
| MSErrorReport.isAppKill() | ErrorReport.isAppKill |
| MSCrashes.lastSessionCrashReport() | Crashes.lastSessionCrashReport |
| MSCrashes.setAutomaticProcessing(true) | Crashes.automaticProcessing = true |
| MSWrapperCrashesHelper.getCrashHandlerSetupDelegate | WrapperCrashesHelper.crashHandlerSetupDelegate |
| MSWrapperCrashesHelper.setCrashHandlerSetupDelegate(delegate) | WrapperCrashesHelper.crashHandlerSetupDelegate = delegate |
| MSCrashes.setUserConfirmationHandler(handler) | Crashes.userConfirmationHandler = Handler |
App Center-Verteilung niedriger 4.0.0 |
App Center Verteilen 4.0.0+ |
|---|---|
| MSDistribute.isEnabled() | Distribute.enabled |
| MSDistribute.setEnabled(true) | Distribute.enabled = true |
| MSDistribute.setDelegate(delegate) | Distributed.delegate = delegate |
| MSDistribute.setApiUrl("{API URL}") | Distribute.apiUrl = "{API URL}" |
| MSDistribute.setInstallUrl("{Installations-URL}") | Distribute.installUrl = "{Instal URL}" |
| MSDistribute.isMandatoryUpdate | Distribute.mandatoryUpdate |
AbstürzeDeln von Änderungen
Bevor Sie das App Center SDK auf 4.0.0 und höher aktualisieren.
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]
DistributedDelegate-Änderungen
Bevor Sie das App Center SDK auf 4.0.0 und höher aktualisieren.
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