MAUI と Xamarin の概要

[アーティクル]
03/15/2024

重要

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

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

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

App Center Analytics と App Center のクラッシュを使用するようにアプリで App Center .NET SDK を設定し始めましょう。 App Center Distribute をアプリに追加するには、 App Center の配布に関するドキュメントを参照してください。

1.前提条件

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

プロジェクトが Visual Studio またはVisual Studio for Macで設定されている。
iOS 11.0 以降または Android 5.0 (API レベル 21) 以降を実行しているデバイスを対象としています。
クラッシュレポート機能を提供する他の SDK を使用していません。

サポート対象のプラットフォーム:

MAUI iOS
MAUI Android
MAUI Windows
.NET 6.0 macOS
Xamarin.Android
Xamarin.iOS
Xamarin.Mac
Xamarin.Forms (iOS、macOS Android、UWP、Windows デスクトップアプリケーション)

1.1 MAUI

注意

現在、App Center ポータルには MAUI プラットフォームはありません。 iOS 用の Xamarin と Windows 用の Android および UWP を使用してください。

1.2 Xamarin.Android について

Android を OS として、Xamarin をプラットフォームとして使用して、App Center ポータルでアプリを作成します。

1.3 Xamarin.iOS について

iOS を OS として、Xamarin をプラットフォームとして使用して、App Center ポータルでアプリを作成します。

1.4 Xamarin.Mac について

macOS を OS として、Xamarin をプラットフォームとして使用して、App Center ポータルでアプリを作成します。

警告

アプリがApp Storeにアップロードされないという既知の問題があります。 github の進行状況に従います。

1.5 Xamarin.Forms について (iOS、macOS、Android、UWP、Windows Desktop)

App Center で 5 つのアプリを作成します。OS ごとに 1 つ作成します。

Android、iOS、macOS アプリケーションのプラットフォームとして Xamarin を選択する必要があります (UWP アプリケーションとデスクトップアプリケーションには Xamarin オプションはありません)。

Windows デスクトップおよび macOS アプリケーションの場合は、Xamarin.Forms プラットフォームとの互換性のためにプロジェクトを構成する必要があります。

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

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

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

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

3. App Center SDK をソリューションに追加する

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

注意

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

Visual Studio for Mac

Visual Studio を開きます。
[ファイルを開く] を>クリックし、ソリューションを選択します。
ソリューションナビゲーターで[ パッケージ ] セクションを右クリックし、[ NuGet パッケージの追加...] を選択します。
App Center を検索し、[App Center Analytics と App Centerのクラッシュ] を選択します。
[ パッケージの追加] をクリックします。

Windows 用 Visual Studio

Visual Studio を開きます。
[ファイルを開く] を>クリックし、ソリューションを選択します。
ソリューションナビゲーターで、[ 参照 ] を右クリックし、[ NuGet パッケージの管理] を選択します。
App Center を検索し、Microsoft.AppCenter.Analytics パッケージと Microsoft.AppCenter.Crashes パッケージをインストールします。

パッケージマネージャーコンソール

Visual Studio でコンソールを開きます。これを行うには、[ツール]>[NuGet パッケージマネージャーパッケージマネージャー> コンソール] の順に選択します。
Visual Studio for Macで作業している場合は、NuGet パッケージ管理拡張機能がインストールされていることを確認します。このためには、[ 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 for Mac」または「Visual Studio for Windows」セクションで説明されている対応する手順に従う必要があります。

4. SDK を起動する

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

4.1 using ステートメントを追加する

次のファイルに適切な名前空間を追加します。

MAUI と Xamarin.Forms - App.xaml.cs
Xamarin.iOS と Xamarin.Mac - AppDelegate.cs
Xamarin.Android - MainActivity.cs

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

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

4.2.1 MAUI と Xamarin.Forms

App Center ポータルで、プラットフォームごとに異なるアプリケーションを作成する必要があります。アプリごとに異なるアプリシークレットがあります。プロジェクトの App.xaml.cs ファイルを開き、コンストラクター (または Xamarin.Forms のメソッド) に次の OnStart() 行を追加します。

AppCenter.Start("ios={Your App Secret};macos={Your App Secret};android={Your App Secret};uwp={Your App Secret};windowsdesktop={Your App Secret}", typeof(Analytics), typeof(Crashes));

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

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

AppCenter.Configure("ios={Your App Secret};macos={Your App Secret};android={Your App Secret};uwp={Your App Secret};windowsdesktop={Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics));
    AppCenter.Start(typeof(Crashes));
}

4.2.2 Xamarin.Android

注意

Android 用 HockeyApp SDK を使用している場合は、必ず App Center SDK の後に HockeyApp SDK を初期化してください。

プロジェクトの MainActivity.cs ファイルを 開き、メソッド内に Start() 呼び出しを OnCreate() 追加します。

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

注意

アプリケーションにバックグラウンドサービスまたはブロードキャストレシーバー、エクスポートされたアクティビティ、コンテンツプロバイダーなどの複数のエントリポイントがある場合は、代わりにコールバックでApplication.OnCreate開始AppCenterすることをお勧めします。

4.2.3 Xamarin.iOS と Xamarin.Mac

注意

アプリに複数のアクティブなクラッシュレポート SDK を含めることはできません。他の SDK のクラッシュレポート機能を無効にして、App Center がクラッシュをキャッチできることを確認します。

プロジェクト AppDelegate.cs のファイルを開き、メソッド内に Start() 呼び出しを FinishedLaunching() 追加します。

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

注意

クラッシュを使用する場合は、UI/メインスレッドでこのメソッドを呼び出し、メソッドが戻るまでバックグラウンドタスクをStart開始しないようにする必要があります。その理由は、クラッシュの初期化中に別のスレッドからキャッチされた null 参照例外によって、ネイティブクラッシュがトリガーされ、catch 句が無視される可能性があるためです。メソッドが AppCenter.Start 戻ったら、null 参照例外をもう一度試すかキャッチしても安全です。このタイミングの問題の原因の詳細については、シグナルとサードパーティのクラッシュレポーターに関する記事を参照してください。

警告

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

重要

中かっこは、実際のアプリシークレットを配置する場所を示し、呼び出しに中かっこを Start 入れないでください。

注意

iOS アプリケーションの場合、アプリに複数のアクティブなクラッシュレポート SDK を含めることはできません。他の SDK のクラッシュレポート機能を無効にして、App Center がクラッシュをキャッチできることを確認します。

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

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

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

上記の例は、メソッドを Start() 使用し、App Center Analytics と App Center クラッシュの両方を含める方法を示しています。

2 つのサービスのいずれかを使用しない場合は、上記のメソッド呼び出しから対応するパラメーターを削除します。

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

たとえば、 - App Center Analytics にオンボードする場合は、次のように呼び出しを変更する Start() 必要があります。

4.3.1 MAUI と Xamarin.Forms

AppCenter.Start("ios={Your App Secret};macos={Your App Secret};android={Your App Secret};uwp={Your App Secret};windowsdesktop={Your App Secret}", typeof(Analytics));

4.3.2 Xamarin Native

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

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

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

アプリ内更新プログラムの使用を開始する方法については、 App Center の配布に関するドキュメントを参照してください。

注意

Xamarin Forms のポータブル API を使用すると、すべてのモジュールの API が表示されますが、これらの API のすべてが UWP および Windows Desktop プラットフォームでサポートされているわけではないので、 UWP および Windows デスクトップ アプリケーションで実行する場合は何も行いません。特に、UWP と Windows Desktop では、配布モジュールはサポートされていません。戻り値の型を持つメソッドは、UWP および Windows デスクトップアプリケーションで (オブジェクトの場合)、 0 (数値の場合)、または false (ブール値の場合) のいずれかをnull返します。

5. バックアップルール (Android のみ)

注意

Android 6.0 (API レベル 23) 以降を対象とするアプリでは、自動バックアップが自動的に有効になります。

注意

バックアップ規則を含むカスタムファイルが既にある場合は、3 番目の手順に切り替えます。

自動バックアップを使用してデバイスに関する正しくない情報を取得しないようにする場合は、次の手順に従います。

5.1. Android 11 (API レベル 30) 以降の場合。

Resources/xml フォルダー appcenter_backup_rule.xml ファイルを作成します。

プロジェクトの AndroidManifest.xmlファイルを 開きます。属性を android:fullBackupContent 要素に <application> 追加します。 appcenter_backup_rule.xml リソースファイルを指している必要があります。

android:fullBackupContent="@xml/appcenter_backup_rule"

appcenter_backup_rule.xml ファイルに次のバックアップ規則を追加します。

<full-backup-content xmlns:tools="http://schemas.android.com/tools">
      <exclude domain="sharedpref" path="AppCenter.xml"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
      <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
      <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
  </full-backup-content>

5.2. Android 12 (API レベル 31) 以降の場合。

Resources/xml フォルダー appcenter_backup_rule.xml ファイルを作成します。

プロジェクトの AndroidManifest.xmlファイルを 開きます。属性を android:dataExtractionRules 要素に <application> 追加します。 appcenter_backup_rule.xml リソースファイルを指している必要があります。

android:dataExtractionRules="@xml/appcenter_backup_rule"

appcenter_backup_rule.xml ファイルに次のバックアップ規則を追加します。

<data-extraction-rules xmlns:tools="http://schemas.android.com/tools">
    <cloud-backup>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </cloud-backup>
    <device-transfer>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </device-transfer>
</data-extraction-rules>

次の方法で共有

MAUI と Xamarin の概要

1.前提条件

1.1 MAUI

1.2 Xamarin.Android について

1.3 Xamarin.iOS について

1.4 Xamarin.Mac について

1.5 Xamarin.Forms について (iOS、macOS、Android、UWP、Windows Desktop)

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

3. App Center SDK をソリューションに追加する

Visual Studio for Mac

Windows 用 Visual Studio

パッケージマネージャーコンソール

4. SDK を起動する

4.1 using ステートメントを追加する

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

4.2.1 MAUI と Xamarin.Forms

4.2.2 Xamarin.Android

4.2.3 Xamarin.iOS と Xamarin.Mac

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

4.3.1 MAUI と Xamarin.Forms

4.3.2 Xamarin Native

5. バックアップルール (Android のみ)

5.1. Android 11 (API レベル 30) 以降の場合。

5.2. Android 12 (API レベル 31) 以降の場合。

その他のリソース

次の方法で共有

MAUI と Xamarin の概要

1.前提条件

1.1 MAUI

1.2 Xamarin.Android について

1.3 Xamarin.iOS について

1.4 Xamarin.Mac について

1.5 Xamarin.Forms について (iOS、macOS、Android、UWP、Windows Desktop)

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

3. App Center SDK をソリューションに追加する

Visual Studio for Mac

Windows 用 Visual Studio

パッケージ マネージャー コンソール

4. SDK を起動する

4.1 using ステートメントを追加する

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

4.2.1 MAUI と Xamarin.Forms

4.2.2 Xamarin.Android

4.2.3 Xamarin.iOS と Xamarin.Mac

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

4.3.1 MAUI と Xamarin.Forms

4.3.2 Xamarin Native

5. バックアップ ルール (Android のみ)

5.1. Android 11 (API レベル 30) 以降の場合。

5.2. Android 12 (API レベル 31) 以降の場合。

その他のリソース

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

パッケージマネージャーコンソール

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

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

5. バックアップルール (Android のみ)