Bagikan melalui


Bermigrasi ke App Center SDK 4.0.0 dan yang lebih tinggi

Penting

Visual Studio App Center dijadwalkan untuk dihentikan pada 31 Maret 2025. Meskipun Anda dapat terus menggunakan Visual Studio App Center hingga sepenuhnya dihentikan, ada beberapa alternatif yang direkomendasikan yang dapat Anda pertimbangkan untuk bermigrasi.

Pelajari selengkapnya tentang garis waktu dukungan dan alternatif.

Untuk menghindari konflik penamaan dengan kelas dalam kerangka kerja privat Apple, SDK sekarang menggunakan MSAC awalan alih-alih MS mengubah SDK API.

Swift API sekarang memiliki gaya yang lebih cepat , dan semua kelas harus digunakan tanpa awalan, misalnya AppCenter. Ada juga perubahan dalam penamaan fungsi dan properti berdasarkan praktik terbaik Apple Swift.

Memperbarui SDK App Center

Pertama, perbarui App Center SDK dengan menggunakan salah satu manajer dependensi.

Penggunaan API

Cara tercepat dan paling nyaman untuk memperbarui APP Center SDK API adalah dengan menggunakan koreksi otomatis. Setelah penggantian, Anda harus mendapatkan hasilnya seperti yang ditunjukkan di bawah ini.

Sebelum memperbarui App Center SDK ke 4.0.0 dan yang lebih tinggi.

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

Setelah memperbarui App Center SDK ke 4.0.0 dan yang lebih tinggi.

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

Selain itu, getter [MSACWrapperCrashesHelper getCrashHandlerSetupDelegate] sekarang tidak digunakan lagi, silakan gunakan [MSACWrapperCrashesHelper crashHandlerSetupDelegate] sebagai gantinya.

Tabel berikut ini memperlihatkan API yang telah diganti namanya.

App Center Core lebih rendah 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 .Peringatan
MSLogLevelInfo MSACLogLevelInfo .Info
MSLogLevelAssert MSACLogLevelAssert .Menegaskan
MSLogHandler MSACLogHandler LogHandler
MSLogMessageProvider MSACLogMessageProvider LogMessageProvider
Analitik App Center lebih rendah 4.0.0 Analitik 4.0.0App Center + (ObjC) App Center Alanlytics 4.0.0+ (Swift)
MSAnalytics MSACAnalytics Analitik
MSFlags MSACFlags Bendera
MSFlagsNormal MSACFlagsNormal Flags.normal
MSFlagsCritical MSACFlagsCritical .Kritis
MSFlagsDefault MSACFlagsDefault .Default
MSEventProperties MSACEventProperties EventProperties
App Center Crash lebih rendah 4.0.0 App Center Crashes 4.0.0+ (ObjC) App Center Crash + 4.0.0(Swift)
MSCrash MSACCrashes Crash
MSCrashesDelegate MSACCrashesDelegate CrashesDelegate
MSErrorReport MSACErrorReport ErrorReport
MSErrorAttachmentLog MSACErrorAttachmentLog ErrorAttachmentLog
MSUserConfirmationDontSend MSACUserConfirmationDontSend UserConfirmation.dontSend
MSUserConfirmationSend MSACUserConfirmationSend .Mengirim
MSUserConfirmationAlways MSACUserConfirmationAlways .Selalu
MSUserConfirmationHandler MSACUserConfirmationHandler UserConfirmationHandler
Pendistribusian App Center lebih rendah 4.0.0 Distribusi 4.0.0App Center + (ObjC) Distribusi 4.0.0App Center + (Swift)
MSDistribute MSACDistribute Distribusikan
MSDistributeDelegate MSACDistributeDelegate DistributeDelegate
MSCrashHandlerSetupDelegate MSACCrashHandlerSetupDelegate CrashHandlerSetupDelegate
MSReleaseDetails MSACReleaseDetails ReleaseDetails
MSUpdateAction MSACUpdateAction UpdateAction
MSUpdateActionUpdate MSACUpdateActionUpdate UpdateAction.update
MSUpdateActionPostpone MSACUpdateActionPostpone .Menunda
MSUpdateTrack MSACUpdateTrack UpdateTrack
MSUpdateTrackPublic MSACUpdateTrackPublic UpdateTrack.public
MSUpdateTrackPrivate MSACUpdateTrackPrivate .Pribadi

Perubahan Swift API

Inti App Center lebih rendah 4.0.0 Inti Pusat Aplikasi 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", untuk: "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}", layanan: [Analytics.self])
MSAppCenter.startWithServices([MSAnalytics.self, MSCrashes.self]) AppCenter.start(services: [Analytics.self, Crashes.self])
MSAppCenter.startFromLibraryWithServices([MSAnalytics.self]) AppCenter.startFromLibrary(services: [Analytics.self]) ")
Analitik App Center lebih rendah 4.0.0 Analitik App Center 4.0.0+
MSAnalytics.isEnabled() Analytics.enabled
MSAnalytics.setEnabled(true) Analytics.enabled = true
MSAnalytics.setTransmissionInterval(600) Analytics.transmissionInterval = 600
App Center Crash lebih rendah 4.0.0 App Center Mengalami Crash 4.0.0+
MSCrashes.isEnabled() Crashes.enabled
MSCrashes.setEnabled(true) Crashes.enabled = true
MSCrashes.setDelegate(delegasi) Crashes.delegasi = delegasi
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(delegasi) WrapperCrashesHelper.crashHandlerSetupDelegate = delegasi
MSCrashes.setUserConfirmationHandler(handler) Crashes.userConfirmationHandler = handler
Pendistribusian App Center lebih rendah 4.0.0 Distribusi App Center 4.0.0+
MSDistribute.isEnabled() Distribute.enabled
MSDistribute.setEnabled(true) Distribute.enabled = true
MSDistribute.setDelegate(delegasi) Distribute.delegasi = delegasi
MSDistribute.setApiUrl("{API URL}") Distribute.apiUrl = "{API URL}"
MSDistribute.setInstallUrl("{Install URL}") Distribute.installUrl = "{Instal URL}"
MSDistribute.isMandatoryUpdate Distribute.mandatoryUpdate

CrashDelegate perubahan

Sebelum memperbarui App Center SDK ke 4.0.0 dan yang lebih tinggi.

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]

Setelah memperbarui App Center SDK ke 4.0.0 dan yang lebih tinggi.

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]

Perubahan DistributeDelegate

Sebelum memperbarui App Center SDK ke 4.0.0 dan yang lebih tinggi.

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

Setelah memperbarui App Center SDK ke 4.0.0 dan yang lebih tinggi.

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