重要
Visual Studio App Center は、2026 年 6 月 30 日まで引き続きサポートされる分析機能と診断機能を除き、2025 年 3 月 31 日に廃止されました。 詳細を参照してください。
App Center SDK ではモジュールアーキテクチャが使用されるため、サービスの一部またはすべてを使用できます。
App Center Analytics と App Center Crashes を使用するために、アプリで App Center SDK の設定を始めましょう。
1.前提条件
開始する前に、次の前提条件が満たされていることを確認します。
UWP プロジェクトの場合:
- プロジェクトは Visual Studio 2017 Update 15.9 以降で設定されています。
- Windows 10 ビルド 16299 以降を実行しているデバイスを対象としています。
- プロジェクトがユニバーサル Windows プラットフォーム 6.2.8 以降を参照しています (通常、このパッケージは暗黙的に参照されます)。
- NuGet 4.3 以降。
WinUI プロジェクトの場合:
- プロジェクトは Visual Studio 2019 Update 16.9 以降で設定されています。
- Windows 10 ビルド 17763 以降を実行しているデバイスを対象としています。
- プロジェクトが WinUI 3 0.8.0 以降を 参照している。
注
UWP に Xamarin.Forms を使用する場合は、このドキュメントではなく、Xamarin の概要 に関するドキュメントに従ってください。
2. App Center ポータルでアプリを作成してアプリ シークレットを取得する
App Center ポータルでアプリを既に作成している場合は、この手順をスキップできます。
- サインアップまたはログインし、ポータルの右上隅にある [ 新規 追加] という青いボタンをクリックし、ドロップダウン メニューから [ 新しいアプリの追加 ] を選択します。
- アプリの名前と説明 (省略可能) を入力します。
- 上記の説明に従って、プロジェクトに応じて適切な OS とプラットフォームを選択します。
- 右下にある [ 新しいアプリの追加] ボタンをクリックします。
アプリを作成したら、App Center ポータルの [設定] ページでそのアプリ シークレットを取得できます。
[設定] ページの右上隅にある 3 つの垂直ドットをクリックし、Copy app secretを選択してアプリ シークレットを取得します。
3. App Center SDK モジュールを追加する
App Center SDK は、Visual Studio またはパッケージ マネージャー コンソールを使用して統合できます。
Visual Studio
- Visual Studio を開きます。
- [ ファイル]>[開く] をクリックし、ソリューションを選択します。
- ソリューション ナビゲーターで、[ 参照 ] を右クリックし、[ NuGet パッケージの管理] を選択します。
- [ 参照] タブで、 App Center を検索し、 Microsoft.AppCenter.Analytics パッケージと Microsoft.AppCenter.Crashes パッケージを インストールします。
パッケージ マネージャー コンソール
- Visual Studio でコンソールを開きます。 これを行うには、 ツール>NuGet パッケージ マネージャー>パッケージ マネージャー コンソールを選択します。
- 次のコマンドを入力します。
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes
アプリケーションに SDK を統合したので、次は SDK を起動し、App Center サービスを利用します。
注
ポータブル プロジェクト ( Xamarin.Forms など) で App Center SDK を使用する場合は、ポータブル、Android、iOS の各プロジェクトにパッケージをインストールする必要があります。 これを行うには、各サブプロジェクトを開き、 Visual Studio セクションで説明されている対応する手順に従う必要があります。
4. Internet (Client) 機能を追加する
Visual Studio ソリューション エクスプローラーで、アプリケーションの Package.appxmanifest ファイルをダブルクリックします。 [ 機能 ] タブをクリックし、 インターネット (クライアント) 機能を確認します。
5. SDK を起動する
App Center を使用するには、使用するモジュールにオプトインする必要があります。 既定では、モジュールは起動されません。SDK を起動するときに、各モジュールを明示的に呼び出す必要があります。
5.1 「using」ディレクティブを追加する
API を使用する前に、適切な名前空間を追加します。
using Microsoft.AppCenter;
using Microsoft.AppCenter.Analytics;
using Microsoft.AppCenter.Crashes;
5.2 Start() メソッドを追加する
アプリケーションのコンストラクターに次の呼び出しを追加 します。
AppCenter.Start("{Your App Secret}", typeof(Analytics), typeof(Crashes));
警告
ソース コードにアプリ シークレットを埋め込むことは推奨されません。
App Center サービスを個別に開始する必要がある場合は、次の手順を実行する必要があります。
- アプリシークレットを使用してサービスを構成または開始します。
- コードを複数回呼び出すことができる場合は、App Center が既に構成されているかどうかを確認します。
- アプリ シークレットなしで必要なサービスを開始します。
AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
AppCenter.Start(typeof(Analytics));
AppCenter.Start(typeof(Crashes));
}
5.3 プレースホルダーをアプリ シークレットに置き換える
{Your App Secret}テキストは、アプリケーションの実際の値に置き換えてください。 アプリ シークレットは、App Center ポータルの [はじめ に] ページまたは [設定] ページにあります。
[作業の開始] ページには、上記のコード サンプルとアプリ シークレットが含まれており、サンプル全体をコピーして貼り付けることができます。
上記の例は、 Start() メソッドを使用する方法を示しており、App Center Analytics が含まれています。
start メソッドで各サービスをパラメーターとして明示的に指定しない限り、その App Center サービスを使用することはできません。 さらに、 Start() API は、アプリのライフサイクルで 1 回だけ使用できます。他のすべての呼び出しでは、コンソールに警告が記録され、最初の呼び出しに含まれるサービスのみが使用できるようになります。
これで、SDK が自動的に収集するポータルで Analytics を視覚化するように設定されています。
両方のサービスのより高度な機能をカスタマイズして使用する方法については、 App Center Analytics と App Center のクラッシュ に関するドキュメントを参照してください。