HockeySDK から App Center WPF/Winforms に移行する
重要
Visual Studio App Center は、2025 年 3 月 31 日に廃止される予定です。 完全に廃止されるまで Visual Studio App Center を引き続き使用できますが、移行を検討できる推奨される代替手段がいくつかあります。
HockeySDK ではなく App Center SDK を使用するようにアプリケーションを更新する場合は、このドキュメントに従ってください。
1. ライブラリを更新する
HockeySDK.WPF NuGet パッケージを、ソリューション内のすべてのプロジェクトの App Center パッケージに置き換えます。
Windows 用 Visual Studio
- Windows 用 Visual Studio を開きます。
- [ファイルを開く] を>クリックし、ソリューションを選択します。
- ソリューション ナビゲーターで、[ 参照 ] を右クリックし、[ NuGet パッケージの管理] を選択します。
- HockeySDK.WPF パッケージを削除します。
- App Center を検索し、Microsoft.AppCenter.Analytics パッケージと Microsoft.AppCenter.Crashes パッケージをインストールします。
パッケージ マネージャー コンソール
- Visual Studio でコンソールを開きます。 これを行うには、[ツール]>[NuGet パッケージ マネージャー パッケージ マネージャー> コンソール] の順に選択します。
- Visual Studio for Macで作業している場合は、NuGet パッケージ管理拡張機能がインストールされていることを確認します。 このためには、[ Visual Studio>拡張機能] を選択し、 NuGet を検索し、必要に応じてインストールします。
- コンソールに次のコマンドを入力します。
Uninstall-Package HockeySDK.WPF
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes
App Center SDK では、モジュール方式のアプローチを使用します。統合するサービスを選択できます。 このセクションでは、各 SDK モジュールを個別の依存関係として追加する必要があります。
2. SDK セットアップ コードを更新する
2.1 アプリケーション識別子を変換する
App Center SDK では、グローバル一意識別子 (GUID) 形式のアプリケーション識別子が使用されます。 HockeyApp App ID は App Center で使用できますが、別の形式に変換する必要があります。 識別子を変換するには、表現を取得 8-4-4-4-12 するために 4 つのハイフンを追加する必要があります。
Before (HockeyApp): 00112233445566778899aabbccddeeff
After (App Center): 00112233-4455-6677-8899-aabbccddeeff
2.2 アプリケーション コードで SDK の初期化を置き換える
古い HockeyApp 登録コードを削除します。 ステートメント宣言で
using、次の行を削除します。using Microsoft.HockeyApp;App クラス コンストラクターの先頭で、次の行を削除します。
HockeyClient.Current.Configure("Your_App_ID");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 |
|---|---|---|
| クラッシュを自動的に送信する | 既定で有効 | クラッシュ レポート |
| 追加のメタデータをアタッチする | Yes | 添付ファイルの追加 |
| 処理された例外を追跡する | HockeyClient.Current.TrackException |
処理されたエラー |
Distribution
App Center SDK では、WPF/Winforms アプリの配布はまだサポートされていません。
フィードバック サービス
フィードバック サービスは App Center ではサポートされません。 HockeyApp のフィードバックに関するページを参照してください。