HockeySDK から App Center UWP への移行

重要

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. ライブラリを更新する

注意

WinRT、Windows Phone 8.0、8.1、WPF、PCL などのプラットフォームは、App Center SDK ではサポートされていません。 HockeySDK は引き続き使用できます。

HockeySDK.UWP NuGet パッケージを、ソリューション内のすべてのプロジェクトの App Center パッケージに置き換えます。

Windows 用 Visual Studio

• Windows 用 Visual Studio を開きます。
• [ ファイルを>開く ] をクリックし、ソリューションを選択します。
• ソリューション ナビゲーターで、[ 参照 ] を右クリックし、[ NuGet パッケージの管理] を選択します。
• HockeySDK.UWP パッケージを削除します。
• App Center を検索し、Microsoft.AppCenter.Analytics パッケージと Microsoft.AppCenter.Crashes パッケージをインストールします。

パッケージ マネージャー コンソール

• Visual Studio でコンソールを開きます。 これを行うには、[ツール]> [NuGet パッケージ マネージャー パッケージ マネージャー> コンソール] の順に選択します。
• Visual Studio for Macで作業している場合は、NuGet パッケージ管理拡張機能がインストールされていることを確認します。 このためには、[ Visual Studio>拡張機能] を選択し、必要に応じて NuGet を検索してインストールします。
• コンソールで次のコマンドを入力します。

Uninstall-Package HockeySDK.UWP
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

App Center SDK では、モジュール型のアプローチを使用します。関心のあるサービスのみを統合できます。 このセクションでは、各 SDK モジュールを個別の依存関係として追加する必要があります。

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 登録コードを削除します。

   ステートメント宣言で using 、次の行を削除します。

   using Microsoft.HockeyApp;
   

   App クラス コンストラクターの先頭で、次の行を削除します。

   HockeyClient.Current.Configure("Your_App_ID");
   

2. App Center SDK を起動します。

   API を使用する前に、適切な名前空間を追加します。

   using Microsoft.AppCenter;
   using Microsoft.AppCenter.Analytics;
   using Microsoft.AppCenter.Crashes;
   

   アプリケーションのコンストラクターに次の呼び出しを追加します。

   AppCenter.Start("{Your App Secret}",  typeof(Analytics), typeof(Crashes));
   

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

コア

機能	HockeyApp	App Center
ログ レベルを調整する	Yes	AppCenter.LogLevel

分析

機能	HockeyApp	App Center
セッションを自動的に追跡する	Yes	セッションとデバイスの情報
プロパティを含むカスタム イベント	HockeyClient.TrackEvent	Analytics.TrackEvent

Crashes

機能	HockeyApp	App Center
クラッシュを自動的に送信する	既定で有効	クラッシュ レポート
追加のメタデータをアタッチする	はい	サポートなし
処理された例外を追跡する	HockeyClient.Current.TrackException	サポートされていません

Distribution

App Center SDK では、UWP アプリの配布はまだサポートされていません。

フィードバック サービス

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