從 HockeySDK 移轉至 App Center SDK for Cordova

重要

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

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

1.更新連結庫

開啟終端機視窗，瀏覽至 Cordova 專案資料夾，然後執行下列命令：
```
cordova plugin add cordova-plugin-appcenter-analytics
```
流覽至 您的應用程式 > 平臺 > android > platform_www > plugins 資料夾，並從中刪除 cordova-plugin-hockeyapp 。

App Center SDK 是使用模組化方法所設計–您只能整合您感興趣的服務。請參閱下表中的等價：

HockeyApp 模組	App Center 模組	安裝命令
`Crashes and Exceptions`	`Crashes`	`cordova plugin add cordova-plugin-appcenter-crashes`
`Metrics`	`Analytics`	`cordova plugin add cordova-plugin-appcenter-analytics`

執行其中一個命令來安裝您需要 (或兩者) 的模組。

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

(HockeyApp) 之前： 00112233445566778899aabbccddeeff

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

移除處理程式內的 deviceready HockeyApp 初始化：
```
hockeyapp.start(null, null, "APP_ID");
```
設定 App Center SDK

開啟 Apache Cordova 項目的 config.xml 檔案;針對每個 Apache Cordova 項目的目標 platform 元素， (目前只有 Android 和 iOS) ，請以下列格式新增子 preference 元素：
```
<preference name="APP_SECRET" value="{App Secret from the previous step}" />
```
如需詳細資訊，請參閱 App Center Cordova 檔。
取代整個應用程式的所有 HockeyApp API 呼叫。以下提供詳細的 API 對應數據表。

功能	HockeyApp	App Center
找出使用者	hockeyapp.setUserName 或 hockeyapp.setUserEmail	AppCenter.setUserId

功能	HockeyApp	App Center
自動追蹤會話	無法停用檔 ()	預設會啟用檔 ()
追蹤事件	hockeyapp.trackEvent	Analytics.trackEvent

功能	HockeyApp	App Center
自動傳送當機	autoSend 參數 (預設為停用)	默認會啟用 APPCENTER_CRASHES_ALWAYS_SEND ()
附加其他元數據	hockeyapp.addMetaData	您可以從接聽程式) 附加檔 (
產生測試損毀	hockeyapp.forceCrash	AppCenter.Crashes.generateTestCrash
在當機時顯示對話框	ignoreDefaultHandler (預設為停用，Android 僅)	AppCenter.Crash.process (回呼處理當機)

App Center Cordova SDK 尚不支援 App Center 散發服務。

App Center 不支援意見反應服務。請參閱 HockeyApp 意見反應。