UWP/WinUI の概要

重要

Visual Studio App Center は、2025 年 3 月 31 日に廃止される予定です。 完全に廃止されるまで Visual Studio App Center を引き続き使用できますが、移行を検討できる推奨される代替手段がいくつかあります。

詳細については、サポートタイムラインと代替手段に関するページを参照してください。

• Android
• iOS
• iOS の拡張機能
• React Native
• MAUI/Xamarin
• UWP
• WPF/WinForms
• Unity
• macOS
• macOS 拡張機能
• tvOS
• Cordova

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

App Center Analytics と App Center のクラッシュを使用するようにアプリで App Center SDK を設定し始めましょう。

1.前提条件

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

UWP プロジェクトの場合:

• プロジェクトは Visual Studio 2017 Update 15.9 以降で設定されています。
• ビルド 16299 以降Windows 10実行されているデバイスを対象としています。
• プロジェクトは 6.2.8 以降ユニバーサル Windows プラットフォーム参照します (このパッケージは通常、暗黙的に参照されます)。
• NuGet 4.3 以降。

WinUI プロジェクトの場合:

• プロジェクトは Visual Studio 2019 Update 16.9 以降で設定されています。
• ビルド 17763 以降Windows 10実行されているデバイスを対象としています。
• プロジェクトが WinUI 3 0.8.0 以降を 参照している。

注意

UWP に Xamarin.Forms を使用する場合は、このドキュメントではなく、Xamarin の概要 に関するドキュメントに従ってください。

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 またはパッケージ マネージャー コンソールを使用して統合できます。

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 サービスを個別に開始する必要がある場合は、次の手順を実行する必要があります。

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

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 サービスを使用することはできません。 さらに、API は Start() アプリのライフサイクルで 1 回だけ使用できます。他のすべての呼び出しでは、コンソールに警告が記録され、最初の呼び出しに含まれるサービスのみが使用可能になります。

これで、SDK によって自動的に収集されるポータルで Analytics を視覚化するように設定されています。

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