這很重要
Visual Studio App Center 於 2025 年 3 月 31 日淘汰，但分析和診斷功能除外，這些功能將持續支援到 2026 年 6 月 30 日。 瞭解更多資訊。
為了避免命名與 Apple 私有架構中的類別發生衝突，SDK 現在會使用 MSAC 前綴，而不是 MS，這改變了 SDK 的 API。
Swift API 現在具有更符合 Swift風格的設計，且所有類別都應在不使用前綴的情況下使用，例如AppCenter。 根據 Apple Swift 最佳做法，函式和屬性命名也有變更。
更新 App Center SDK
首先，使用其中一個相依性管理員來更新App Center SDK。
API 的使用方式
更新 App Center SDK API 最快的最方便方式是使用自動更正。 進行取代後，您應該會得到如下所示的結果。
在將 App Center SDK 更新至 4.0.0 或更高版本之前。
[MSAppCenter start:@"{Your App Secret}" withServices:@[[MSAnalytics class], [MSCrashes class]]];
MSAppCenter.start("{Your App Secret}", withServices: [MSAnalytics.self, MSCrashes.self])
將 App Center SDK 更新為 4.0.0 以上版本之後。
[MSACAppCenter start:@"{Your App Secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];
AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self, Crashes.self])
此外，getter [MSACWrapperCrashesHelper getCrashHandlerSetupDelegate] 現在已被取代，請改用 [MSACWrapperCrashesHelper crashHandlerSetupDelegate] 。
下表顯示已重新命名的 API。
App Center Core 較低 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 | 警告 |
| MSLogLevelInfo | MSACLogLevelInfo | .info |
| MSLogLevelAssert | MSACLogLevelAssert | 斷言 |
| MSLogHandler | MSACLogHandler | LogHandler |
| MS日誌訊息提供者 | MSACLogMessageProvider | LogMessageProvider |
App Center Analytics 降低 4.0.0 |
App Center Analytics 4.0.0+ （ObjC） |
App Center Analytics 4.0.0+ （Swift） |
|---|---|---|
| MSAnalytics | MSACAnalytics | Analytics |
| MSFlags | MSACFlags | 標誌 |
| MSFlagsNormal | MSACFlagsNormal | 旗幟.正常 |
| MSFlagsCritical | MSACFlagsCritical | 。危急 |
| MSFlagsDefault | MSACFlagsDefault | .default |
| MSEventProperties | MSACEventProperties | EventProperties |
App Center 減少崩潰事件 4.0.0 |
App Center 崩潰 4.0.0+ （ObjC） |
App Center 崩潰 4.0.0+ （Swift） |
|---|---|---|
| MSCrashes | MSAC 崩潰 | 崩潰 |
| MSCrashesDelegate | MSACCrashesDelegate | CrashesDelegate |
| MSErrorReport | MSACErrorReport | 錯誤報告 |
| MSErrorAttachmentLog | MSACErrorAttachmentLog | 錯誤附件日誌 |
| 微軟用戶確認不發送 | 用戶確認不發送 | 用戶確認.不發送 |
| 使用者確認發送 | MSAC使用者確認送出 | 。發送 |
| MSUserConfirmationAlways | MSACUserConfirmationAlways | 。總是 |
| MS使用者確認處理程式 (MSUserConfirmationHandler) | MSACUserConfirmationHandler | UserConfirmationHandler |
App Center 低版本分發 4.0.0 |
App Center 分發 4.0.0+ （ObjC） |
App Center 發佈 4.0.0+ （Swift） |
|---|---|---|
| MSDistribute | MSACDistribute | 分發 |
| MSDistributeDelegate | MSACDistributeDelegate | DistributeDelegate |
| MSCrashHandlerSetupDelegate | MSACCrashHandlerSetupDelegate | CrashHandlerSetupDelegate |
| Microsoft 版本詳細資訊 | MSAC 發行詳情 | ReleaseDetails |
| MSUpdateAction | MSACUpdateAction | UpdateAction |
| MS更新動作更新 | MSACUpdateActionUpdate | UpdateAction.update |
| 微軟更新動作延後 | MSACUpdateActionPostpone | 。推遲 |
| MSUpdateTrack | MSACUpdateTrack | UpdateTrack |
| MSUpdateTrackPublic | MSACUpdateTrackPublic | UpdateTrack.public |
| MSUpdateTrackPrivate | MSACUpdateTrackPrivate | 私人 |
Swift API 變更
App Center Core 較低 4.0.0 |
App Center 核心 4.0.0+ |
|---|---|
| MSAppCenter.isEnabled（） | AppCenter.enabled |
| MSAppCenter.setEnabled（true） | AppCenter.enabled = true |
| MSAppCenter.isConfigured（） | AppCenter.isConfigured |
| MSAppCenter.isRunningInAppCenterTestCloud（） | AppCenter.isRunningInAppCenterTestCloud（確認是否在AppCenter測試雲端運行的程序） |
| 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(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（服務：[Analytics.self， Crashes.self]） |
| MSAppCenter.startFromLibraryWithServices（[MSAnalytics.self]） | AppCenter.startFromLibrary（services： [Analytics.self]） “） |
App Center Analytics 降低 4.0.0 |
App Center 分析工具 4.0.0+ |
|---|---|
| MSAnalytics.isEnabled（） | 分析啟用 |
| MSAnalytics.setEnabled（true） | Analytics.enabled = true |
| MSAnalytics.setTransmissionInterval（600） | Analytics.transmissionInterval = 600 |
App Center 減少崩潰事件 4.0.0 |
App Center 當機 4.0.0+ |
|---|---|
| MSCrashes.isEnabled（） | 崩潰.啟用 |
| MSCrashes.setEnabled（true） | Crashes.enabled = true（崩潰功能已啟用） |
| MSCrashes.setDelegate（delegate） | Crashes.delegate = 委派 |
| MSCrashes.hasCrashedInLastSession（） | 崩潰.hasCrashedInLastSession |
| MSCrashes.hasReceivedMemoryWarningInLastSession（） | 崩潰.hasReceivedMemoryWarningInLastSession |
| MSErrorReport.isAppKill（） | ErrorReport.isAppKill |
| MSCrashes.lastSessionCrashReport（） | Crashes.lastSessionCrashReport |
| MSCrashes.setAutomaticProcessing（true） | Crashes.automaticProcessing = true |
| MSWrapperCrashesHelper.getCrashHandlerSetupDelegate | Wrapper CrashHelper.crashHandlerSetupDelegate |
| MSWrapperCrashesHelper.setCrashHandlerSetupDelegate（delegate） | WrapperCrashesHelper.crashHandlerSetupDelegate = 委託 |
| MSCrashes.setUserConfirmationHandler（handler） | Crashes.userConfirmationHandler = 處理程序 |
App Center 低版本分發 4.0.0 |
App Center 發布 4.0.0+ |
|---|---|
| MSDistribute.isEnabled（） | 分發.啟用 |
| MSDistribute.setEnabled（true） | 分發.enabled = true |
| MSDistribute.setDelegate（delegate） | Distribute.delegate = 委派 |
| MSDistribute.setApiUrl（“{API URL}”） | Distribute.apiUrl = “{API URL}” |
| MSDistribute.setInstallUrl（“{Install URL}”） | Distribute.installUrl = “{Instal URL}” |
| MSDistribute.isMandatoryUpdate | Distribute.mandatoryUpdate |
CrashesDelegate 變更
在將 App Center SDK 更新至 4.0.0 或更高版本之前。
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]
將 App Center SDK 更新為 4.0.0 以上版本之後。
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」變更
在將 App Center SDK 更新至 4.0.0 或更高版本之前。
func distribute(_ distribute: MSDistribute!, releaseAvailableWith details: MSReleaseDetails!) -> Bool
將 App Center SDK 更新為 4.0.0 以上版本之後。
func distribute(_ distribute: Distribute, releaseAvailableWith details: ReleaseDetails) -> Bool