WPF/WinForms を始める

重要

Visual Studio App Center は、2026 年 6 月 30 日まで引き続きサポートされる分析機能と診断機能を除き、2025 年 3 月 31 日に廃止されました。 詳細を参照してください。

• アンドロイド
• iOS
• iOS 拡張機能
• React Native
• MAUI/Xamarin
• UWP
• WPF/WinForms
• ユニティ
• macOS
• macOS 拡張機能
• tvOS

App Center SDK ではモジュールアーキテクチャが使用されるため、サービスの一部またはすべてを使用できます。

App Center Analytics と App Center Crashes を使用するために、アプリで App Center SDK の設定を始めましょう。

1.前提条件

開始する前に、次の前提条件が満たされていることを確認します。

• プロジェクトのターゲットは、.NET Framework 4.6.2 (以上) または .NET Core 3.1 (またはそれ以降) です。
• .NET Core は、WPF/WinForms アプリケーションが Windows 上で実行されている場合にのみサポートされます。
• ポータブル ライブラリから SDK を使用する場合は、.NET Standard 2.0 以降をターゲットにする必要があります (PCL はサポートされていません)。
• PackageReference プロジェクトの種類。 この要件は、 SQLitePCL.raw ライブラリに由来します。 詳細については、 https://github.com/ericsink/SQLitePCL.raw/issues/537を参照してください。
• SDK を VSTO プロジェクトに統合するときの既知の問題があります。 詳細については、 https://github.com/microsoft/appcenter-sdk-dotnet/issues/1583/を参照してください。

2. App Center ポータルでアプリを作成してアプリ シークレットを取得する

App Center ポータルでアプリを既に作成している場合は、この手順をスキップできます。

1. サインアップまたはログインし、ポータルの右上隅にある [ 新規 追加] という青いボタンをクリックし、ドロップダウン メニューから [ 新しいアプリの追加 ] を選択します。
2. アプリの名前と説明 (省略可能) を入力します。
3. 上記の説明に従って、プロジェクトに応じて適切な OS とプラットフォームを選択します。
4. 右下にある [ 新しいアプリの追加] ボタンをクリックします。

アプリを作成したら、App Center ポータルの [設定] ページでそのアプリ シークレットを取得できます。 [設定] ページの右上隅にある 3 つの垂直ドットをクリックし、Copy app secretを選択してアプリ シークレットを取得します。

3. App Center SDK モジュールを追加する

App Center SDK は、Visual Studio またはパッケージ マネージャー コンソールを使用して統合できます。

注

App Center SDK では、 厳密な名前付き 記号を使用するアプリケーションとの互換性のために、厳密な名前付きアセンブリが使用されます。

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

注

ポータブル プロジェクトで App Center SDK を使用する場合は、各プロジェクト (ポータブル プロジェクト)、WPF/WinForms アプリを実行しているプロジェクトにパッケージをインストールする必要があります。 これを行うには、各サブプロジェクトを開き、 Visual Studio セクションで説明されている対応する手順に従う必要があります。

4. SDK を起動する

App Center を使用するには、使用するモジュールにオプトインします。 既定では、モジュールは起動されません。SDK を起動するときに、各モジュールを明示的に呼び出す必要があります。

4.1 Start() メソッドを追加する

WPF（Windows Presentation Foundation）

WPF アプリケーションの場合は、 App.xaml.cs を変更し、次の using ステートメントを追加します。

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

次に、同じファイルで、 OnStartup メソッドに次のコードを追加します。

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

App.xaml.cs ファイルに OnStartup メソッドがない場合は、Application.OnStartup(StartupEventArgs) メソッドを追加できます。 App.xaml.cs ファイルは次のようになります。

public partial class App : Application
{
    protected override void OnStartup(StartupEventArgs e)
    {
      base.OnStartup(e);
      AppCenter.Start("{Your App Secret}", typeof(Analytics), typeof(Crashes));
    }
  }
}

警告

ソース コードにアプリ シークレットを埋め込むことは推奨されません。

App Center サービスを個別に開始する必要がある場合は、次の手順を実行する必要があります。

1. アプリシークレットを使用してサービスを構成または開始します。
2. コードを複数回呼び出すことができる場合は、App Center が既に構成されているかどうかを確認します。
3. アプリ シークレットなしで必要なサービスを開始します。

AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

WinForms

WinForms アプリケーションの場合は、 Program.cs ファイルを変更し、次の using ステートメントを追加します。

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

次に、同じファイルで、Main ステートメントの前に、Application.Run メソッドに次のコードを追加します。

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

App Center サービスを個別に開始する必要がある場合は、次の手順を実行する必要があります。

1. アプリシークレットを使用してサービスを構成または開始します。
2. コードを複数回呼び出すことができる場合は、App Center が既に構成されているかどうかを確認します。
3. アプリ シークレットなしで必要なサービスを開始します。

AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

警告

ソース コードにアプリ シークレットを埋め込むことは推奨されません。

4.2 プレースホルダーをアプリ シークレットに置き換える

{Your App Secret}テキストは、アプリケーションの実際の値に置き換えてください。 アプリ シークレットは、App Center ポータルの [はじめ に] ページまたは [設定] ページにあります。

[作業の開始] ページには、上記のコード サンプルとアプリ シークレットが含まれており、サンプル全体をコピーして貼り付けることができます。

上記の例は、 Start() メソッドを使用する方法を示しており、App Center Analytics が含まれています。

start メソッドで各サービスをパラメーターとして明示的に指定しない限り、その App Center サービスを使用することはできません。 さらに、 Start() API は、アプリのライフサイクルで 1 回だけ使用できます。他のすべての呼び出しでは、コンソールに警告が記録され、最初の呼び出しに含まれるサービスのみが使用できるようになります。

優れた点として、SDK によって自動的に収集されるポータルでクラッシュを視覚化するように設定されています。

両方のサービスのより高度な機能をカスタマイズして使用する方法については、 App Center Analytics と App Center のクラッシュ に関するドキュメントを参照してください。