Migrowanie do zestawu SDK usługi App Center w wersji 4.0.0 lub nowszej

Artykuł
03/17/2024

Ważne

Program Visual Studio App Center ma zostać wycofany 31 marca 2025 r. Mimo że możesz nadal używać programu Visual Studio App Center do momentu jej pełnego wycofania, istnieje kilka zalecanych alternatyw, do których można rozważyć migrację.

Dowiedz się więcej o osiach czasu pomocy technicznej i alternatywach.

Aby uniknąć konfliktu nazewnictwa z klasami w prywatnych strukturach firmy Apple, zestaw SDK używa MSAC teraz prefiksu zamiast MS tego, który zmienia interfejs API zestawu SDK.

Interfejs API swift ma teraz bardziej szybki styl, a wszystkie klasy powinny być używane bez prefiksu, np. AppCenter. Wprowadzono również zmiany w funkcjach i nazewnictwie właściwości opartych na najlepszych rozwiązaniach firmy Apple Swift.

Aktualizowanie zestawu SDK centrum aplikacji

Najpierw zaktualizuj zestaw SDK centrum aplikacji przy użyciu jednego z menedżerów zależności.

Użycie interfejsów API

Najszybszym i najwygodniejszym sposobem aktualizowania interfejsu API zestawu SDK usługi App Center jest użycie autokorekty. Po zastąpieniu należy uzyskać wynik, jak pokazano poniżej.

Przed zaktualizowaniem zestawu SDK centrum aplikacji do 4.0.0 i nowszych.

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

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

Po zaktualizowaniu zestawu SDK centrum aplikacji do 4.0.0 i nowszych.

[MSACAppCenter start:@"{Your App Secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];

AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self, Crashes.self])

Ponadto element getter [MSACWrapperCrashesHelper getCrashHandlerSetupDelegate] jest teraz przestarzały, użyj [MSACWrapperCrashesHelper crashHandlerSetupDelegate] zamiast tego.

W poniższych tabelach przedstawiono interfejsy API, których nazwa została zmieniona.

Niższe rdzenie centrum aplikacji `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	.Ostrzeżenie
MSLogLevelInfo	MSACLogLevelInfo	.Informacji
MSLogLevelAssert	MSACLogLevelAssert	.Assert
MSLogHandler	MSACLogHandler	Program LogHandler
MSLogMessageProvider	MSACLogMessageProvider	LogMessageProvider

Usługa App Center Analytics jest niższa `4.0.0`	App Center Analytics `4.0.0`+ (ObjC)	App Center Alanlytics `4.0.0`+ (Swift)
MsAnalytics	MSACAnalytics	Analiza
MsFlags	Opóźnienia MSACFlags	Flagi
MSFlagsNormal	MSACFlagsNormal	Flagi.normal
MSFlagsCritical	MSACFlagsCritical	.Krytyczne
MSFlagsDefault	MSACFlagsDefault	.Domyślny
WŁAŚCIWOŚCI MSEventProperties	MSACEventProperties	EventProperties

Centrum aplikacji ulega awarii niższej `4.0.0`	Awarie `4.0.0`usługi App Center + (ObjC)	Awarie `4.0.0`centrum aplikacji + (Swift)
MsCrashes	MSACCrashes	Ulega awarii
MSCrashesDelegate	MSACCrashesDelegate	CrashDelegate
MSErrorReport	MSACErrorReport	ErrorReport (Raport o błędach)
MSErrorAttachmentLog	MSACErrorAttachmentLog	ErrorAttachmentLog
MSUserConfirmationDontSend	MSACUserConfirmationDontSend	UserConfirmation.dontSend
MSUserConfirmationSend	MSACUserConfirmationSend	.Wyślij
MSUserConfirmationAlways	MSACUserConfirmationAlways	.Zawsze
MSUserConfirmationHandler	MSACUserConfirmationHandler	UserConfirmationHandler

Usługa App Center Dystrybuuj niższą `4.0.0`	Usługa App Center Distribute `4.0.0`+ (ObjC)	Usługa App Center Distribute `4.0.0`+ (Swift)
MSDistribute	MSACDistribute	Rozłóż
MSDistributeDelegate	MSACDistributeDelegate	DistributeDelegate
MSCrashHandlerSetupDelegate	MSACCrashHandlerSetupDelegate	CrashHandlerSetupDelegate
MSReleaseDetails	MSACReleaseDetails	ReleaseDetails
MSUpdateAction	MSACUpdateAction	UpdateAction
MSUpdateActionUpdate	MSACUpdateActionUpdate	UpdateAction.update
MSUpdateActionPostpone	MSACUpdateActionPostpone	.Odroczyć
MSUpdateTrack	MSACUpdateTrack	UpdateTrack
MSUpdateTrackPublic	MSACUpdateTrackPublic	UpdateTrack.public
MSUpdateTrackPrivate	MSACUpdateTrackPrivate	.Prywatny

Zmiany interfejsu API usługi Swift

Dolna rdzeń usługi App Center `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("{adres URL dziennika}")	AppCenter.logUrl = "{Adres URL dziennika}"
MSAppCenter.setLogLevel(.verbose)	AppCenter.logLevel = .verbose
MSAppCenter.setLogHandler(logHandler)	AppCenter.logHandler = logHandler
MSAppCenter.SetUserId("{Identyfikator użytkownika}")	AppCenter.userId = "{Identyfikator użytkownika}"
MSAppCenter.setCountryCode("{Kod kraju}")	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(konfiguracja)	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}", usługi: [Analytics.self])
MSAppCenter.startWithServices([MSAnalytics.self, MSCrashes.self])	AppCenter.start(usługi: [Analytics.self, Crash.self])
MSAppCenter.startFromLibraryWithServices([MSAnalytics.self])	AppCenter.startFromLibrary(usługi: [Analytics.self]) ")

Analiza usługi App Center jest niższa `4.0.0`	Analiza usługi App Center `4.0.0`+
MSAnalytics.isEnabled()	Analytics.enabled
MSAnalytics.setEnabled(true)	Analytics.enabled = true
MSAnalytics.setTransmissionInterval(600)	Analytics.transmissionInterval = 600

Usługa App Center ulega awarii niższej `4.0.0`	Awarie usługi App Center `4.0.0`+
MSCrashes.isEnabled()	Crash.enabled
MSCrashes.setEnabled(true)	Crash.enabled = true
MSCrashes.setDelegate(delegate)	Crash.delegate = delegate
MSCrashes.hasCrashedInLastSession()	Crash.hasCrashedInLastSession
MSCrashes.hasReceivedMemoryWarningInLastSession()	Crash.hasReceivedMemoryWarningInLastSession
MSErrorReport.isAppKill()	ErrorReport.isAppKill
MSCrashes.lastSessionCrashReport()	Crash.lastSessionCrashReport
MSCrashes.setAutomaticProcessing(true)	Crash.automaticProcessing = true
MSWrapperCrashesHelper.getCrashHandlerSetupDelegate	WrapperCrashesHelper.crashHandlerSetupDelegate
MSWrapperCrashesHelper.setCrashHandlerSetupDelegate(delegate)	WrapperCrashesHelper.crashHandlerSetupDelegate = delegate
MSCrashes.setUserConfirmationHandler(handler)	Crash.userConfirmationHandler = handler

Usługa App Center Dystrybuuj niższą `4.0.0`	Dystrybucja w usłudze App Center `4.0.0`+
MSDistribute.isEnabled()	Distribute.enabled
MSDistribute.setEnabled(true)	Distribute.enabled = true
MSDistribute.setDelegate(delegate)	Distribute.delegate = delegate
MSDistribute.setApiUrl("{ADRES URL interfejsu API}")	Distribute.apiUrl = "{API URL}"
MSDistribute.setInstallUrl("{Adres URL instalacji}")	Distribute.installUrl = "{Instal URL}"
MSDistribute.isMandatoryUpdate	Distribute.mandatoryUpdate

AwarieUsuń zmiany

Przed zaktualizowaniem zestawu SDK centrum aplikacji do 4.0.0 i nowszych wersji.

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 zaktualizowaniu zestawu SDK centrum aplikacji do 4.0.0 systemu i nowszych.

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]

Zmiany DistributeDelegate