共用方式為

從 HockeySDK 移轉至適用於 macOS 的 App Center SDK

  • 發行項

重要

Visual Studio App Center 已排定於 2025 年 3 月 31 日淘汰。 雖然您可以繼續使用 Visual Studio App Center，直到完全淘汰為止，但有數個建議的替代方案可以考慮移轉至。

深入瞭解支持時程表和替代方案。

如果您想要更新應用程式以使用 App Center SDK，而不是 HockeySDK，請遵循此檔。

1.更新連結庫

1.1 移除舊的 HockeySDK

手動

如果您已手動新增 SDK，請遵循下列步驟：

  1. 從 XCode 專案移除 HockeySDK.framework 參考。 按兩下 [ 移除參考] 按鈕，不要按下 [ 移至垃圾桶 ] 按鈕。

  2. 開啟您的項目設定，然後在 [標頭搜尋路徑架構搜尋路徑 / ] 區段的 [建置設定] 索引標籤下，移除與 HockeySDK 相關的頭檔位置。

  3. 開啟您的項目設定，然後在 [鏈接二進位檔與連結庫] 區段的 [建置階段] 索引標籤下，移除與 HockeySDK 相關的相依性專案。

  4. 從檔案系統中刪除 HockeySDK.framework 。

Podfile

如果您已使用 CocoaPods 新增 SDK，請從 Podfile 移除該 pod "HockeySDK-Mac" 行，然後執行 pod install。

Carthage

如果您已使用 Carthage 新增 SDK，請遵循下列步驟：

  1. 從 Cartfile移除 HockeySDK 參考。 從檔案系統中刪除 Cartfile.Resolved 。

  2. 從 XCode 項目刪除 HockeySDK.framework 和 HockeySDK.framework.dSYM ，然後按兩下 [移至垃圾桶 ] 按鈕。

1.2 新增 App Center SDK

App Center SDK 支援透過 Cocoapods、Carthage、Swift 套件管理員，以及在您的 Xcode 專案中使用架構進行整合。 閱讀如何在 App Center SDK 檔中整合 App Center SDK 的詳細指示。

注意

App Center SDK 是使用模組化方法所設計，因此您可以使用任何或所有服務。 請參閱下表中的等價：

HockeyApp 類別 App Center 模組
MetricsManager Analytics
CrashManager Crashes

2.更新 SDK 安裝程式碼

2.1 轉換應用程式識別碼

App Center SDK 使用全域唯一標識碼 (GUID) 格式的應用程式識別碼。 您的 HockeyApp 應用程式識別碼可由 App Center 使用，但您需要將其轉換成不同的格式。 若要轉換標識碼，您必須新增四個連字元，以取得 8-4-4-4-12 表示法。

(HockeyApp) 之前： 00112233445566778899aabbccddeeff

(App Center) 之後： 00112233-4455-6677-8899-aabbccddeeff

2.2 取代應用程式程式代碼中的 SDK 初始化

  1. 取代 AppDelegate 類別中的下列匯入。

    之前：

    @import HockeySDK;

    import HockeySDK

    之後：

    @import AppCenter;
@import AppCenterAnalytics;
@import AppCenterCrashes;

    import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

  2. 取代註冊碼

    didFinishLaunchingWithOptions尋找方法並取代 HockeyApp 程式代碼出現次數。

    之前：

    [[BITHockeyManager sharedHockeyManager] configureWithIdentifier:@"APP_IDENTIFIER"];
[[BITHockeyManager sharedHockeyManager] startManager];

    BITHockeyManager.shared().configure(withIdentifier: "APP_IDENTIFIER")
BITHockeyManager.shared().start()

    之後：

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

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

  3. 取代整個應用程式的 HockeyApp API 呼叫。 以下提供詳細的 API 對應數據表。

3.服務和功能比較

核心

功能 HockeyApp App Center
調整記錄層級 [BITHockeyManager sharedHockeyManager].logLevel = BITLogLevelVerbose [MSACAppCenter setLogLevel：MSACLogLevelVerbose]

分析

HockeySDK 會收集每個預設值的計量。 App Center SDK 不會收集每個預設值) 計量的任何 (分析。 若要使用 App Center SDK 收集計量，請傳遞 MSACAnalytics 至 start: 方法。

功能 HockeyApp App Center
自動追蹤會話 預設啟用 預設會啟用檔 ()
具有屬性的自定義事件 Yes [MSACAnalytics trackEvent：withProperties：]
在運行時間停用服務 [BITHockeyManager sharedHockeyManager].disableMetricsManager = YES [MSACAnalytics setEnabled：NO]

損毀

HockeySDK 報告預設損毀。 下次啟動應用程式時，系統會立即將當機傳送至伺服器。 App Center SDK 不會報告每個預設值的任何損毀。 若要使用 App Center SDK 收集當機，請傳遞 MSACCrashes 至 start: 方法。

功能 HockeyApp App Center
自動傳送當機 [[BITHockeyManager sharedHockeyManager].crashManager setAutoSubmitCrashReport: YES] 預設會啟用檔 ()
產生測試當機 [[BITHockeyManager sharedHockeyManager].crashManager generateTestCrash] [MSACCrashes generateTestCrash]
上一個損毀的相關信息 [[BITHockeyManager sharedHockeyManager].crashManager lastSessionCrashDetails] [MSACCrashes lastSessionCrashReport]
Mach 例外狀況處理 [[BITHockeyManager sharedHockeyManager].disableMachExceptionHandler = YES] 預設會啟用檔 ()
附加其他元數據 Yes 您可以從委派) 附加檔 (
自定義使用者對話框 setCrashReportUIHandler 預設不會提供檔 ()
在運行時間停用服務 [[BITHockeyManager sharedHockeyManager] setDisableCrashManager: YES] [MSACCrashes setEnabled：NO]