iOS を始めるためのガイド

重要

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

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

App Center SDK によって収集されたデータ、一般的なデータ保護規則、FAQ ページで、App Center によって収集されたデータに関する情報を確認できます。また、 FAQ には、App Store のプライバシー構成に必要な回答が含まれています。

さあ、アプリで App Center Analytics と App Center Crashes を使用するために、App Center iOS SDK の設定を始めましょう。 App Center Distribute をアプリに追加するには、 App Center Distribute のドキュメントを参照してください。

1.前提条件

App Center SDK を使用するには、次の要件を満たす必要があります。

iOS プロジェクトは、macOS バージョン 10.14.4 以降の Xcode 13 以降で設定されています。
ios 11.0 以降で実行されているデバイスを対象としています。
クラッシュレポート機能を提供する他のライブラリは使用していません (App Center のクラッシュの場合のみ)。
CocoaPods を使用して App Center を統合する場合は、CocoaPods バージョン 1.10 以降が必要です。

App Center SDK の分析とクラッシュは、XCFramework または SwiftPM を介して Mac Catalyst と互換性があります。

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

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

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

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

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

App Center SDK for iOS は、Cocoapods、 Carthage、 Swift Package Manager を使用してアプリに追加することも、バイナリをプロジェクトに手動で追加して追加することもできます。

注

4.0.0 バージョンの App Center では、破壊的変更が導入されました。 App Center SDK 4.0.0 以降に移行するセクションに従って、App Center を以前のバージョンから移行します。

3.1 Cocoapods による統合

注

ARM64 シミュレーター (Apple Silicon Mac で実行されている Xcode から起動された場合) は CocoaPods を介してサポートされていません。他の統合方法を使用して動作することを検討してください。

次の依存関係を podfile に追加して、App Center Analytics と App Center のクラッシュをアプリに含めます。このアクションは、AppCenter、AppCenterAnalytics、および AppCenterCrashes のフレームワークを取り込むものです。代わりに、アプリで必要なサービスを指定できます。各サービスには独自のサブスペックがあり、それらはすべて AppCenter に依存しています。自動的に取り込まれる。
```
 # Use the following line to use App Center Analytics and Crashes.x
 pod 'AppCenter'

 # Use the following lines if you want to specify which service you want to use.
 pod 'AppCenter/Analytics'
 pod 'AppCenter/Crashes'
 pod 'AppCenter/Distribute'
```
pod installを実行して、新しく定義されたポッドをインストールし、プロジェクトの.xcworkspaceを開きます。

注

[!] Unable to find a specification for `AppCenter` の実行中にpod installのようなエラーが表示された場合は、pod repo updateを実行して Cocoapods リポジトリから最新のポッドを取得し、pod install実行します。

アプリケーションにフレームワークを統合したので、次は SDK を起動し、App Center サービスを利用します。

3.2 Carthage による統合

以下は、依存関係を構築し、バイナリフレームワークを提供する分散型依存関係マネージャーである Carthage バージョン 0.30 以降を使用して、Xcode プロジェクトに App Center SDK を統合する手順です。

注

Xcode 12では、Carthageの統合が標準では動作しません。動作させるには、このカルタゴの指示を参照してください

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.X
```
carthage updateを実行して、Carthage/Checkouts フォルダーに依存関係をフェッチします。次に、各フレームワークをビルドします。
アプリケーションターゲットの [全般 設定] タブを開きます。 AppCenter.framework、 AppCenterAnalytics.framework、 AppCenterCrashes.framework ファイルを Carthage/Build/iOS フォルダーから Xcode の Project Navigator にドラッグアンドドロップします。 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 プロジェクトに統合して、iOS アプリの App Center Analytics と App Center のクラッシュを設定する手順を次に示します。

注

App Center SDK では、 XCframeworkの使用がサポートされています。 XCframeworks をプロジェクトに統合する場合は、リリースページから AppCenter-SDK-Apple-XCFramework.zip をダウンロードして解凍します。結果のフォルダーの内容はプラットフォーム固有ではなく、モジュールごとに XCframeworks が含まれます。これらは、以下で説明するように、通常のフレームワークと同じ方法で統合できます。

zip ファイルとして提供されている App Center SDK フレームワークをダウンロードします。
ファイルを解凍すると、 AppCenter-SDK-Apple という名前のフォルダーが表示されます。このフォルダーには、各プラットフォームフォルダーの App Center サービスごとに異なるフレームワークが含まれています。 AppCenterというフレームワークは、異なるモジュール間で共有されるコードを含むプロジェクトで必要です。
[省略可能]サードパーティ製ライブラリのサブディレクトリを作成します。
- ベストプラクティスとして、サードパーティ製ライブラリは、通常は Vendor と呼ばれるサブディレクトリにあります。プロジェクトがライブラリのサブディレクトリで編成されていない場合は、ここで Vendor サブディレクトリを作成します。
- Xcode プロジェクト内に Vendor という名前のグループを作成して、ディスク上のファイル構造を模倣します。
Finder で解凍した AppCenter-SDK-Apple フォルダーを開き、目的の場所にあるプロジェクトのフォルダーにフォルダーをコピーします。このフォルダーには、App Center SDK がサポートする他のプラットフォームのサブフォルダーにフレームワークが含まれているため、不要なサブフォルダーを削除することが必要になる場合があります。
Xcode でプロジェクトに SDK フレームワークを追加します。
- プロジェクトナビゲーターが表示されていることを確認します (⌘+1)。
- ここで、Finder から (前の手順の場所にある) AppCenter.framework、 AppCenterAnalytics.framework、 AppCenterCrashes.framework を Xcode のプロジェクトナビゲーターにドラッグアンドドロップします。 SDK を起動するには 、AppCenter.framework が必要です。プロジェクトに追加されていない場合、他のモジュールは機能せず、アプリはコンパイルされません。
- ダイアログが表示され、アプリのターゲットがオンになっていることを確認します。 [完了] をクリックします。

アプリケーションにフレームワークを統合したので、次は SDK を起動し、App Center サービスを利用します。

4. SDK を起動する

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

以下の手順は、使用しているライフサイクルによって若干異なります。 Xcode 12 以降では、"Swift UI App" (Xcode 12 では既定で選択) と "UI Kit AppDelegate" の 2 つのライフサイクルのいずれかを選択できます。拡張機能を開発している場合は、「拡張機能の概要」ページを参照してください。

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

プロジェクトの AppDelegate ファイル (UI Kit AppDelegate ライフサイクルの場合) または <ProjectName>App.swift ファイル (Swift UI アプリライフサイクルの場合) を開き、次の import ステートメントを追加します。

@import AppCenter;
@import AppCenterAnalytics;
@import AppCenterCrashes;

import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

4.2 `start:withServices:` メソッドを追加する

UI Kit AppDelegate

デリゲートメソッドに初期化コード didFinishLaunchingWithOptions 追加します。

[MSACAppCenter start:@"{Your App Secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];

AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self, Crashes.self])

Swift UI アプリのライフサイクル

App Center SDK が Swift UI で正しく動作することを確認するには、UI が読み込まれた後に初期化します。これを実現する最も簡単な方法は、UIApplicationDelegate を使用することです。

class AppDelegate: NSObject, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
          AppCenter.start(withAppSecret: "{Your App Secret}", services:[
            Crashes.self, Analytics.self, Distribute.self])
        return true
    }
}

次に、UIApplicationDelegateAdaptorでstructを使用します。

@main
struct YourAppName: App {

  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

Catalyst アプリケーションがある場合は、iOS と macOS の両方のアプリシークレットを同時に渡すことができます。

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])

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

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

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

フィードバック

このページはお役に立ちましたか?

Last updated on 2023-06-12

次の方法で共有

iOS を始めるためのガイド

1.前提条件

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

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

3.1 Cocoapods による統合

3.2 Carthage による統合

3.3 Swift Package Manager による統合

3.4 バイナリをプロジェクトにコピーして統合する

4. SDK を起動する

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

4.2 start:withServices: メソッドを追加する

UI Kit AppDelegate

Swift UI アプリのライフサイクル

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

フィードバック

その他のリソース

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

4.2 `start:withServices:` メソッドを追加する

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