Migrace na sadu App Center SDK 4.0.0 nebo novější
Důležité
Visual Studio App Center je naplánované k vyřazení na 31. března 2025. I když můžete Visual Studio App Center dál používat, dokud ho úplně nevyřadíte, existuje několik doporučených alternativ, na které můžete migraci zvážit.
Přečtěte si další informace o časových osách a alternativách podpory.
Aby se zabránilo konfliktu názvů s třídami v privátních architekturách společnosti Apple, sada SDK teď místo MS toho mění rozhraní API sady SDK, používá MSAC předponu.
Rozhraní Swift API teď nabízí rychlejší styl a všechny třídy by se měly používat bez předpony, například AppCenter. Na základě osvědčených postupů Apple Swiftu došlo také ke změnám v pojmenování funkcí a vlastností.
Aktualizace sady App Center SDK
Nejprve aktualizujte sadu App Center SDK pomocí jednoho ze správců závislostí.
Použití rozhraní API
Nejrychlejším a nejpohodlnějším způsobem, jak aktualizovat rozhraní API sady App Center SDK, je použít automatické opravy. Po nahrazení byste měli získat výsledek, jak je znázorněno níže.
Před aktualizací sady App Center SDK na 4.0.0 vyšší a vyšší.
[MSAppCenter start:@"{Your App Secret}" withServices:@[[MSAnalytics class], [MSCrashes class]]];
MSAppCenter.start("{Your App Secret}", withServices: [MSAnalytics.self, MSCrashes.self])
Po aktualizaci sady App Center SDK na 4.0.0 vyšší úroveň
[MSACAppCenter start:@"{Your App Secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];
AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self, Crashes.self])
Kromě toho je getter [MSACWrapperCrashesHelper getCrashHandlerSetupDelegate] nyní zastaralý. Použijte [MSACWrapperCrashesHelper crashHandlerSetupDelegate] prosím místo toho.
Následující tabulky ukazují přejmenovaná rozhraní API.
App Center Core nižší 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 | .Upozornění |
| MSLogLevelInfo | MSACLogLevelInfo | .Info |
| MSLogLevelAssert | MSACLogLevelAssert | .Assert |
| Obslužná rutina MSLog | Obslužná rutina MSACLogHandler | LogHandler |
| MSLogMessageProvider | MSACLogMessageProvider | LogMessageProvider |
App Center Analytics nižší 4.0.0 |
App Center Analytics 4.0.0+ (ObjC) |
App Center Alanlytics 4.0.0+ (Swift) |
|---|---|---|
| MSAnalytics | MSACAnalytics | Analýzy |
| MsFlags | MSACFlags | Příznaky |
| MSFlagsNormal | MSACFlagsNormal | Flags.normal |
| MSFlagsCritical | MSACFlagsCritical | .Kritické |
| MSFlagsDefault | MSACFlagsDefault | .Výchozí |
| MSEventProperties | MSACEventProperties | Vlastnosti události |
Dole dochází k chybovému ukončení App Center 4.0.0 |
App Center Crashes 4.0.0+ (ObjC) |
Chybové ukončení 4.0.0App Center + (Swift) |
|---|---|---|
| MSCrashes | MsACCrashes | Pády |
| MSCrashesDelegate | MSACCrashesDelegate | CrashesDelegate |
| MSErrorReport | MSACErrorReport | Sestava chyb |
| MSErrorAttachmentLog | MSACErrorAttachmentLog | ErrorAttachmentLog |
| MSUserConfirmationDontSend | MSACUserConfirmationDontSend | UserConfirmation.dontSend |
| MSUserConfirmationSend | MSACUserConfirmationSend | .Odeslat |
| MSUserConfirmationAlways | MSACUserConfirmationAlways | .Vždy |
| MSUserConfirmationHandler | MSACUserConfirmationHandler | Obslužná rutina potvrzení uživatele |
App Center Rozmístit dolů 4.0.0 |
App Center Distribute 4.0.0+ (ObjC) |
App Center Distribute 4.0.0+ (Swift) |
|---|---|---|
| MSDistribute | MSACDistribute | Rozmístit |
| MSDistributeDelegate | MSACDistributeDelegate | DistributeDelegate |
| MSCrashHandlerSetupDelegate | MSACCrashHandlerSetupDelegate | CrashHandlerSetupDelegate |
| MSReleaseDetails | MSACReleaseDetails | ReleaseDetails |
| MSUpdateAction | MSACUpdateAction | UpdateAction |
| MSUpdateActionUpdate | MSACUpdateActionUpdate | UpdateAction.update |
| MSUpdateActionPostpone | MSACUpdateActionPostpone | .Odložit |
| MSUpdateTrack | MSACUpdateTrack | UpdateTrack |
| MSUpdateTrackPublic | MSACUpdateTrackPublic | UpdateTrack.public |
| MSUpdateTrackPrivate | MSACUpdateTrackPrivate | .Soukromé |
Změny rozhraní Swift API
App Center Core nižší 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("{Id uživatele}") | AppCenter.userId = {Id uživatele} |
| MSAppCenter.setCountryCode("{Kód země}") | AppCenter.countryCode = "{Kód země}" |
| MSAppCenter.setAppSecret("{App Secret}") | AppCenter.appSecret = "{Tajný klíč aplikace}" |
| MSAppCenter.setString("value", forKey: "key") | AppCenter.setString("value", for: "key") |
| MSServiceAbstract.isAppSecretRequired() | ServiceAbstract.isAppSecretRequired |
| MSAppCenter.addChannelUnitWithConfiguration(konfigurace) | 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}", služby: [Analytics.self]) |
| MSAppCenter.startWithServices([MSAnalytics.self, MSCrashes.self]) | AppCenter.start(služby: [Analytics.self, Crashes.self]) |
| MSAppCenter.startFromLibraryWithServices([MSAnalytics.self]) | AppCenter.startFromLibrary(služby: [Analytics.self]) ") |
App Center Analytics nižší 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 |
Dole dochází k chybovému ukončení App Centeru 4.0.0 |
Chybové ukončení App Center 4.0.0+ |
|---|---|
| MSCrashes.isEnabled() | Crashes.enabled |
| MSCrashes.setEnabled(true) | Crashes.enabled = true |
| MSCrashes.setDelegate(delegate) | Crashes.delegate = delegát |
| 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(obslužná rutina) | Crashes.userConfirmationHandler = obslužná rutina |
App Center Distribuovat nižší 4.0.0 |
App Center – Distribuce 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 = "{API URL}" |
| MSDistribute.setInstallUrl("{Install URL}") | Distribute.installUrl = "{Instal URL}" |
| MSDistribute.isMandatoryUpdate | Distribute.mandatoryUpdate |
CrashesOdstranit změny
Před aktualizací sady App Center SDK na 4.0.0 a vyšší.
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]
Po aktualizaci sady App Center SDK na 4.0.0 vyšší úroveň.
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 changes
Před aktualizací sady App Center SDK na 4.0.0 a vyšší.
func distribute(_ distribute: MSDistribute!, releaseAvailableWith details: MSReleaseDetails!) -> Bool
Po aktualizaci sady App Center SDK na 4.0.0 vyšší úroveň.
func distribute(_ distribute: Distribute, releaseAvailableWith details: ReleaseDetails) -> Bool