HockeySDK から App Center UWP への移行
重要
Visual Studio App Center は、2025 年 3 月 31 日に廃止される予定です。 完全に廃止されるまで Visual Studio App Center を引き続き使用できますが、移行を検討できる推奨される代替手段がいくつかあります。
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 の初期化を置き換える
古い 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 |
|---|---|---|
| クラッシュを自動的に送信する | 既定で有効 | クラッシュ レポート |
| 追加のメタデータをアタッチする | はい | サポートなし |
| 処理された例外を追跡する | HockeyClient.Current.TrackException |
サポートされていません |
Distribution
App Center SDK では、UWP アプリの配布はまだサポートされていません。
フィードバック サービス
フィードバック サービスは App Center ではサポートされません。 HockeyApp のフィードバックに関するページを参照してください。