從 HockeySDK 移轉至適用於 Unity 的 App Center SDK
重要
Visual Studio App Center 已排定於 2025 年 3 月 31 日淘汰。 雖然您可以繼續使用 Visual Studio App Center，直到完全淘汰為止，但有數個建議的替代方案可以考慮移轉至。
如果您想要更新應用程式以使用 App Center SDK，而不是 HockeySDK，請遵循此檔。
1.更新連結庫
1.1 移除舊的 HockeySDK
按兩下 [設定] 圖示> [移除元件]，選擇您為 SDK 建立的遊戲物件並移除
HockeyAppAndroid/HockeyAppiOS元件。從 Unity 專案內的 Assets 資料夾移除 HockeyAppUnityAndroid / HockeyAppUnityiOS 資料夾 (s) 。
1.2 新增 App Center SDK
App Center SDK 會藉由將 Unity 套件匯入您的專案來整合。 若要這樣做，請先安裝 App Center Unity 編輯器 Extensions 外掛程式。 透過 Unity 功能表開啟 [編輯器 擴充功能]：[視窗>App Center>編輯器 擴充功能]，然後選取 [安裝 App Center SDK]。
App Center SDK 是使用模組化方法所設計， 您只能整合您感興趣的服務。 請參閱下表中的等價：
| HockeyApp 模組 | App Center 模組 |
|---|---|
Crashes and Exceptions |
Crashes |
Metrics |
Analytics |
Version Updates |
Distribute |
若要個別安裝服務，您可以在每個索引標籤中選取 [ 安裝 SDK ]。
注意
App Center Unity SDK 適用於所有三個平臺：Android、iOS 和 UWP。 您不需要個別安裝每個 SDK。
整合 App Center Unity SDK 的建議方式是使用 App Center 編輯器 擴充功能，但我們支援其他案例。 如需詳細資訊，請參閱 App Center Unity 檔。
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
附加 App Center 腳本
在 [專案] 視窗中，流覽至已新增至專案的 AppCenter 資料夾。 找出具有 App Center 標誌的腳本作為其圖示，並 AppCenterBehavior拖曳至您先前用於 HockeySDK 的遊戲物件。
設定 App Center 設定
按兩下此遊戲物件，然後在 [ 偵測器 ] 視窗中，您會看到 App Center 設定。
使用詳細的組態對應數據表填入其他資訊，如下所述。
3.服務和功能比較
| HockeyApp 設定 | App Center 設定 | 備註 |
|---|---|---|
| 應用程式識別碼 | Android/iOS 應用程式秘密 | 使用您在上一個步驟中轉換的應用程式識別碼 |
| 伺服器 URL | [自定義記錄 URL]、 [其他設定] 區段 | 檢查 [使用自定義記錄 URL] |
| 受限制的應用程式內更新 | NA | Distribute.UpdateTrack |
| 默認) 啟用當機和例外狀況 ( | 使用當機 | 當機模組 |
| 自動上傳當機 | 默認會啟用 NA () | 默認會啟用檔 (，) |
| 例外狀況記錄 | 初始記錄層級、 其他安裝程式 區段 | 如果您想要更詳細的記錄，請使用 Verbose |
| 用戶計量 | 使用分析 | 分析模組 |
| 默認會啟用版本 匯報 () | 使用散發 | 散發模組 |
| 更新警示 | NA | 必須設定檔 () |
注意
如果您的項目不支援設定中列出的三個平臺之一，請依原樣保留應用程式秘密欄位;它不會有任何作用。 如果您的項目支援App Center不支援的平臺，這些平臺的API和設定將不會影響這些平臺。
如果您的專案在整個應用程式中都有 HockeySDK API 呼叫，請使用下面提供的詳細 API 對應表來取代它們。
| 功能 | HockeyApp | App Center |
|---|---|---|
| 具有屬性的自定義事件 | HockeyAppIOS.TrackEvent 或 HockeyAppAndroid.TrackEvent | Analytics.TrackEvent |
| 明確檢查更新 | HockeyAppIOS.CheckForUpdate 或 HockeyAppAndroid.CheckForUpdate | Distribute.CheckforUpdate |
| 顯示意見反應表單 | HockeyAppIOS.ShowFeedbackForm 或 HockeyAppAndroid.ShowFeedbackForm | NA (請參閱下一節) |
意見反應服務
App Center 不支援意見反應服務。 請參閱 HockeyApp 意見反應。