重要
Visual Studio App Center は、2026 年 6 月 30 日まで引き続きサポートされる分析機能と診断機能を除き、2025 年 3 月 31 日に廃止されました。 詳細を参照してください。
App Center SDK ではモジュールアーキテクチャが使用されるため、サービスの一部またはすべてを使用できます。
App Center Analytics と App Center Crashes を使用するために、App Center macOS SDK をアプリに設定することを始めましょう。
1.前提条件
App Center SDK を使用するには、次の要件を満たす必要があります。
- macOS プロジェクトは、macOS バージョン 10.14.4 以降の Xcode 13 以降で設定されています。
- macOS 10.13 以降で実行されているデバイスを対象としています。
- クラッシュ レポート機能を提供する他のライブラリは使用していません。
注
App Center SDK では、6 月の SDK リリースで Xcode 10 のサポートが削除 されます。
App Center SDK の分析とクラッシュは、XCFramework または SwiftPM を介して Mac Catalyst と互換性があります。
App Center SDK は Apple Silicon と互換性があります。
2. App Center ポータルでアプリを作成してアプリ シークレットを取得する
App Center ポータルでアプリを既に作成している場合は、この手順をスキップできます。
- appcenter.ms に向かいます。
- サインアップまたはログインし、ポータルの右上隅にある [ 新規 追加] という青いボタンをクリックし、ドロップダウン メニューから [ 新しいアプリの追加 ] を選択します。
- アプリの名前と説明 (省略可能) を入力します。
- OS として macOS を選択し、プラットフォームとして Objective-C/Swift を選択します。
- 右下にある [ 新しいアプリの追加] ボタンをクリックします。
アプリを作成したら、App Center ポータルの [設定] ページでそのアプリ シークレットを取得できます。
[設定] ページの右上隅にある 3 つの垂直ドットをクリックし、Copy app secretを選択してアプリ シークレットを取得します。
3. App Center SDK モジュールを追加する
MacOS 用 App Center SDK は、 Cocoapods、 Carthage、 Swift パッケージ マネージャー を使用するか、バイナリをプロジェクトに手動で追加することで、アプリに追加できます。
注
4.0.0 バージョンの App Center では、破壊的変更が導入されました。
App Center SDK 4.0.0 以降に移行するセクションに従って、App Center を以前のバージョンから移行します。
3.1 Cocoapods による統合
次の依存関係を
podfileに追加して、App Center Analytics と App Center のクラッシュをアプリに含めます。 これにより、AppCenter、AppCenterAnalytics、および AppCenterCrashes というフレームワークが取り込まれます。 代わりに、アプリで使用するサービスを指定できます。 各サービスには独自のサブスペックがあり、それらはすべてAppCenterに依存しています。 自動的に取り込まれる。# Use the following line to use App Center Analytics and Crashes. pod 'AppCenter' # Use the following lines if you want to specify which service you want to use. pod 'AppCenter/Analytics' pod 'AppCenter/Crashes'pod installを実行して、新しく定義されたポッドをインストールし、プロジェクトの.xcworkspaceを開きます。
アプリケーションにフレームワークを統合したので、次は SDK を起動し、App Center サービスを利用します。
3.2 Carthage による統合
以下は、依存関係を構築し、バイナリ フレームワークを提供する分散型依存関係マネージャーである Carthage バージョン 0.30 以降を使用して、Xcode プロジェクトに App Center SDK を統合する手順です。
アプリに App Center を含めるには、次の依存関係を
Cartfileに追加します。 これにより、すべてのフレームワークが取り込まれます。 その後、アプリで使用するフレームワークのみをリンクできます。# Use the following line to get the latest version of App Center github "microsoft/appcenter-sdk-apple"# Use the following line to get the specific version of App Center github "microsoft/appcenter-sdk-apple" ~> X.X.Xcarthage update --platform macOSを実行します。 これにより、依存関係が Carthage/Checkouts フォルダーにフェッチされ、各フレームワークがビルドされます。アプリケーション ターゲットの [全般 設定] タブを開きます。 AppCenter.framework、 AppCenterAnalytics.framework、 AppCenterCrashes.framework ファイルを Carthage/Build/macOS フォルダーから Xcode のプロジェクト ナビゲーターにドラッグ アンド ドロップします。 SDK を起動するには 、AppCenter.framework が必要です。 プロジェクトに追加されていない場合、他のモジュールは機能せず、アプリはコンパイルされません。
ダイアログが表示され、アプリのターゲットがオンになっていることを確認します。 [完了] をクリックします。
注
carthage copy-frameworksでを使用する場合は、静的フレームワークとして出荷されるため、そこに App Center SDK を追加しないでください。
アプリケーションにフレームワークを統合したので、次は SDK を起動し、App Center サービスを利用します。
3.3 Swift Package Manager による統合
- Xcode メニューから、[ ファイル] > [Swift パッケージ] > [パッケージ依存関係の追加] をクリックします。
- 表示されたダイアログで、リポジトリ URL https://github.com/microsoft/appcenter-sdk-apple.gitを入力します。
- [ バージョン] で、[ 次のメジャーまで ] を選択し、既定のオプションを選択します。
- [ パッケージ製品 ] 列で必要なモジュールを選択します。
アプリケーションにフレームワークを統合したので、次は SDK を起動し、App Center サービスを利用します。
注
SwiftPM 経由で App Center を統合していて、それをアプリの拡張機能ターゲットでも使用する場合は、構成に DISABLE_DIAMOND_PROBLEM_DIAGNOSTIC=YES を指定してください。 これは、モジュールを複数のターゲットにリンクする場合の SwiftPM の制限を回避するために必要です。
3.4 バイナリをプロジェクトにコピーして統合する
コンパイル済みのバイナリを Xcode プロジェクトに統合して、macOS アプリの App Center Analytics と App Center Crashes を設定する手順を次に示します。
注
App Center SDK では、 XCframeworkの使用がサポートされています。 XCframeworks をプロジェクトに統合する場合は、リリース ページから AppCenter-SDK-Apple-XCFramework.zip をダウンロードして解凍します。 結果のフォルダーの内容はプラットフォーム固有ではなく、モジュールごとに XCframeworks が含まれます。 これらは、以下で説明するように、通常のフレームワークと同じ方法で統合できます。
zip ファイルとして提供されている App Center SDK フレームワークをダウンロードします。
ファイルを解凍すると、 AppCenter-SDK-Apple という名前のフォルダーが表示されます。このフォルダーには、各プラットフォーム フォルダーの App Center サービスごとに異なるフレームワークが含まれています。
AppCenterというフレームワークは、異なるモジュール間で共有されるコードを含むプロジェクトで必要です。[省略可能]サード パーティ製ライブラリのサブディレクトリを作成します。
- サード パーティ製のライブラリは通常、サブディレクトリ内にあります ( ベンダーと呼ばれることがよくあります)。そのため、プロジェクトでライブラリにサブディレクトリを使用していない場合は、ここで Vendor サブディレクトリを作成します。
- Xcode プロジェクト内に Vendor という名前のグループを作成して、ディスク上のファイル構造を模倣します。
Finder で解凍した AppCenter-SDK-Apple フォルダーを開き、目的の場所にあるプロジェクトのフォルダーにフォルダーをコピーします。 このフォルダーには、App Center SDK がサポートする他のプラットフォームのサブフォルダーにフレームワークが含まれているため、不要なサブフォルダーを削除する必要がある場合があります。
Xcode でプロジェクトに SDK フレームワークを追加します。
- プロジェクト ナビゲーターが表示されていることを確認します (⌘+1)。
- ここで、Finder (Vendor フォルダー内のもの) から Xcode のプロジェクト ナビゲーターに AppCenter.framework、AppCenterAnalytics.framework、AppCenterCrashes.framework をドラッグ アンド ドロップします。 SDK を起動するには、AppCenter.framework が必要です。 不足している場合、他のモジュールは機能せず、アプリはコンパイルされません。
- ダイアログが表示され、アプリのターゲットがオンになっていることを確認します。 [完了] をクリックします。
注
SDK バイナリは、macOS フレームワーク規則に従ってパッケージ化されていません。 その理由は、App Center SDK for Mac は従来のフレームワークではなく、静的なフレームワークであるためです。 静的フレームワークとしてリンクする必要があります。バイナリを埋め込んでいないことを確認し、それらを "バンドル リソースのコピー" ビルド フェーズに含めないでください。
アプリケーションにフレームワークを統合したので、次は SDK を起動し、App Center サービスを利用します。
4. SDK を起動する
App Center を使用するには、使用するモジュールにオプトインする必要があります。 既定では、モジュールは起動されません。SDK の起動時に各モジュールを呼び出す必要があります。 拡張機能を開発している場合は、「 拡張機能の概要」ページを参照してください。
4.1 import ステートメントを追加する
プロジェクトの AppDelegate ファイルを開き、次の import ステートメントを追加します。
@import AppCenter;
@import AppCenterAnalytics;
@import AppCenterCrashes;
import AppCenter
import AppCenterAnalytics
import AppCenterCrashes
4.2 start:withServices: メソッドを追加する
アプリの didFinishLaunchingWithOptions デリゲート メソッドに次の行を挿入します。
[MSACAppCenter start:@"{Your App Secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];
AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self, Crashes.self])
Catalyst アプリケーションがある場合は、iOS と macOS の両方のアプリ シークレットを同時に渡すことができます。
[MSACAppCenter start:@"ios={Your iOS App Secret};macos={Your macOS App Secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];
AppCenter.start(withAppSecret:"ios={Your iOS App Secret};macos={Your macOS App Secret}", services: [Analytics.self, Crashes.self])
警告
ソース コードにアプリ シークレットを埋め込むことは推奨されません。
App Center サービスを個別に開始する必要がある場合は、次の手順を実行する必要があります。
- アプリシークレットを使用してサービスを構成または開始します。
- コードを複数回呼び出すことができる場合は、App Center が既に構成されているかどうかを確認します。
- アプリ シークレットなしで必要なサービスを開始します。
[MSACAppCenter configureWithAppSecret:@"{Your App Secret}"];
if ([MSACAppCenter isConfigured]) {
[MSACAppCenter startService:[MSACAnalytics class]];
[MSACAppCenter startService:[MSACCrashes class]];
}
AppCenter.configure(withAppSecret: "{Your App Secret}")
if AppCenter.isConfigured {
AppCenter.startService(Analytics.self)
AppCenter.startService(Crashes.self)
}
4.3 プレースホルダーをアプリ シークレットに置き換える
{Your App Secret}テキストは、アプリケーションの実際の値に置き換えてください。 アプリ シークレットは、App Center ポータルの [はじめ に] ページまたは [設定] ページにあります。
[作業の開始] ページには、上記のコード サンプルとアプリ シークレットが含まれており、サンプル全体をコピーして貼り付けることができます。
上記の例では、 start:withServices (Swift のstart(withAppSecret:services:) ) メソッドを使用し、App Center Analytics と App Center のクラッシュの両方を含める方法を示しています。
2 つのサービスのいずれかを使用しない場合は、上記のメソッド呼び出しから対応するパラメーターを削除します。
start メソッドで各モジュールをパラメーターとして明示的に指定しない限り、その App Center サービスを使用することはできません。 また、 start:withServices (Swift のstart(withAppSecret:services:) ) API は、アプリのライフサイクルで 1 回だけ使用できます。他のすべての呼び出しでは、コンソールに警告が記録され、最初の呼び出しに含まれるモジュールのみが使用できるようになります。
たとえば、App Center Analytics にオンボードする場合は、 start:withServices (Swift の場合はstart(withAppSecret:services:) ) API 呼び出しを次のように変更する必要があります。
[MSACAppCenter start:@"{Your App Secret}" withServices:@[[MSACAnalytics class]]];
AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self])
4.4 サンドボックス アプリのインターネット機能を追加する
アプリがアプリ サンドボックスを使用している場合は、送信 (クライアント) 接続を許可してアプリがインターネットにアクセスできるように機能を設定する必要があります。 Xcode 9 では既定でアプリ サンドボックスが有効になりますが、送信接続の機能を明示的に設定する必要があります。
プロジェクト ナビゲーターでプロジェクトを選択し、[ 機能 ] タブを選択し、アプリがサンドボックスを使用している場合は、送信接続を有効にします。
これで、SDK が自動的に収集する分析データとクラッシュ データをポータルで視覚化するように設定されています。
App Center Analytics のドキュメントと App Center Crashes のドキュメントを参照して、各サービスの高度な機能をカスタマイズして使用する方法について説明します。