HockeySDK から App Center SDK for Cordova に移行する

重要

Visual Studio App Center は、2025 年 3 月 31 日に廃止される予定です。 完全に廃止されるまで Visual Studio App Center を引き続き使用できますが、移行を検討できる推奨される代替手段がいくつかあります。

サポートタイムラインと代替手段の詳細については、こちらを参照してください。

• Android
• iOS
• UWP
• macOS
• tvOS
• Xamarin
• Unity
• Cordova
• WPF/Winforms

HockeySDK ではなく App Center SDK を使用するようにアプリケーションを更新する場合は、このドキュメントに従ってください。

1. ライブラリを更新する

1.1 古い HockeySDK を削除する

1. ターミナル ウィンドウを開き、Cordova プロジェクト フォルダーに移動し、次のコマンドを実行します。

   cordova plugin add cordova-plugin-appcenter-analytics
   

2. [Your app > platforms > android > platform_www > plugins] フォルダーに移動し、cordova-plugin-hockeyapp を削除します。

1.2 新しい App Center SDK を追加する

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

いずれかのコマンドを実行して、必要なモジュール (またはその両方) をインストールします。

2. SDK セットアップ コードを更新する

2.1 アプリケーション識別子を変換する

App Center SDK では、グローバル一意識別子 (GUID) 形式のアプリケーション識別子が使用されます。 HockeyApp アプリ ID は App Center で使用できますが、別の形式に変換する必要があります。 識別子を変換するには、8-4-4-4-12 表現を取得するために 4 つのハイフンを追加する必要があります。

Before (HockeyApp): 00112233445566778899aabbccddeeff

After (App Center): 00112233-4455-6677-8899-aabbccddeeff

2.2 アプリケーション コードで SDK の初期化を置き換える

1. ハンドラー内の HockeyApp 初期化を deviceready 削除します。

   hockeyapp.start(null, null, "APP_ID");
   

2. 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 のドキュメントを参照してください。

3. アプリケーション全体のすべての HockeyApp API 呼び出しを置き換えます。 詳細な API マッピング テーブルを次に示します。

3. サービスと機能の比較

コア

機能	HockeyApp	App Center
ユーザーの識別	hockeyapp.setUserName または hockeyapp.setUserEmail	AppCenter.setUserId

分析

機能	HockeyApp	App Center
セッションを自動的に追跡する	ドキュメント (無効にすることはできません)	ドキュメント (既定で有効)
イベントの追跡	hockeyapp.trackEvent	Analytics.trackEvent

Crashes

機能	HockeyApp	App Center
クラッシュを自動的に送信する	autoSend パラメーター (既定では無効)	APPCENTER_CRASHES_ALWAYS_SEND (既定で有効)
追加のメタデータをアタッチする	hockeyapp.addMetaData	ドキュメント (リスナーから添付できます)
テスト クラッシュの生成	hockeyapp.forceCrash	AppCenter.Crashes.generateTestCrash
クラッシュ時にダイアログを表示する	ignoreDefaultHandler (既定では無効、Android のみ)	AppCenter.Crashs.process (クラッシュ処理時のコールバック)

バージョン アップデート

App Center Cordova SDK では、App Center Distribute サービスはまだサポートされていません。

フィードバック サービス

フィードバック サービスは App Center ではサポートされません。 HockeyApp のフィードバックに関するページを参照してください。