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

重要

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. SDK 用に作成したゲーム オブジェクトを選択し、[設定] アイコン > [コンポーネントの削除HockeyAppiOSHockeyAppAndroid / ] をクリックしてコンポーネントを削除します。

2. Unity プロジェクト内の Assets フォルダーから HockeyAppUnityAndroid / HockeyAppUnityiOS フォルダーを削除します。

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

App Center SDK は、Unity Packages をプロジェクトにインポートすることによって統合されます。 これを行うには、まず App Center Unity エディター Extensions プラグインをインストールします。 Unity メニューの [Window>App Center>エディター Extensions] を使用してエディター拡張機能を開き、[App Center SDK のインストール] を選択します。

App Center SDK はモジュール式のアプローチで設計されており、関心のあるサービスのみを統合できます。 次の表の等価性を参照してください。

HockeyApp モジュール	App Center モジュール
Crashes and Exceptions	Crashes
Metrics	Analytics
Version Updates	Distribute

サービスを個別にインストールするには、各タブで [ SDK のインストール ] を選択します。

注意

App Center Unity SDK は、Android、iOS、UWP の 3 つのプラットフォームすべてに対応しています。 各 SDK を個別にインストールする必要はありません。

App Center Unity SDK を統合するには、App Center エディター 拡張機能を使用することをお勧めしますが、他のシナリオもサポートしています。 詳細については、 App Center Unity のドキュメントを参照してください。

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 を構成する

App Center スクリプトをアタッチする

[プロジェクト] ウィンドウで、プロジェクトに追加された AppCenter フォルダーに移動します。 App Center ロゴがアイコンのスクリプトを見つけ、 という名前 AppCenterBehaviorで、前に HockeySDK に使用したゲーム オブジェクトにドラッグします。

App Center の設定を構成する

このゲーム オブジェクトをクリックすると、[ インスペクター ] ウィンドウに App Center の構成が表示されます。

次に示す詳細な構成マッピング テーブルを使用して、追加情報を入力します。

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

HockeyApp の設定	App Center の設定	メモ
アプリ ID	Android/iOS アプリ シークレット	前の手順で変換したアプリ ID を使用する
サーバー URL	カスタム ログ URL、 その他のセットアップ セクション	カスタム ログ URL の使用を確認する
制限付きアプリ内更新プログラム	NA	Distribute.UpdateTrack
クラッシュと例外 (既定で有効)	クラッシュを使用する	モジュールがクラッシュする
自動アップロードのクラッシュ	NA (既定で有効)	ドキュメント (既定で有効になっており、構成可能)
例外ログ	[初期ログ レベル] の [その他のセットアップ] セクション	より詳細なログ記録が必要な場合は、 Verbose
ユーザー メトリック	分析を使用する	分析モジュール
バージョン 更新 (既定で有効)	配布を使用する	モジュールの配布
アラートを更新する	NA	ドキュメント (構成する必要があります)

注意

プロジェクトで設定に記載されている 3 つのプラットフォームのいずれかがサポートされていない場合は、アプリ シークレット フィールドはそのままにします。効果はありません。 App Center でサポートされていないプラットフォームがプロジェクトでサポートされている場合、API と構成はそれらのプラットフォームには影響しません。

プロジェクトにアプリケーション全体で HockeySDK API 呼び出しがある場合は、以下に示す詳細な API マッピング テーブルを使用して置き換えます。

機能	HockeyApp	App Center
プロパティを含むカスタム イベント	HockeyAppIOS.TrackEvent または HockeyAppAndroid.TrackEvent	Analytics.TrackEvent
更新プログラムの明示的なチェック	HockeyAppIOS.CheckForUpdate または HockeyAppAndroid.CheckForUpdate	Distribute.CheckforUpdate
フィードバック フォームを表示する	HockeyAppIOS.ShowFeedbackForm または HockeyAppAndroid.ShowFeedbackForm	NA (以下のセクションを参照)

フィードバック サービス

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