tvOS の概要

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

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

1.前提条件

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

• tvOS は、tvOS バージョン 11 以降の Xcode 13 以降で設定されています。
• クラッシュ レポート機能を提供する他のライブラリを使用していません。

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

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

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

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

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

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

3.1 Cocoapods による統合

1. 次の依存関係を 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'
   

2. pod installを実行して、新しく定義されたポッドをインストールし、プロジェクトの.xcworkspaceを開きます。

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

3.2 Carthage による統合

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

1. 次の依存関係を Cartfile に追加して、App Center Analytics と App Center のクラッシュをアプリに含めます。

   # 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
   

2. carthage update --platform tvOS を実行します。 これにより、依存関係が Carthage/Checkouts フォルダーにフェッチされ、各フレームワークがビルドされます。

3. アプリケーション ターゲットの [全般 設定] タブを開きます。 AppCenter.framework、 AppCenterAnalytics.framework、 AppCenterCrashes.framework ファイルを Carthage/Build/tvOS フォルダーから Xcode のプロジェクト ナビゲーターにドラッグ アンド ドロップします。 SDK を起動するには 、AppCenter.framework が必要です。 プロジェクトに追加されていない場合、他のモジュールは機能せず、アプリはコンパイルされません。

4. ダイアログが表示され、アプリのターゲットがオンになっていることを確認します。 [完了] をクリックします。

   注

   carthage copy-frameworksでを使用する場合は、静的フレームワークとして出荷されるため、そこに App Center SDK を追加しないでください。

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

3.3 Swift Package Manager による統合

1. Xcode メニューから、[ ファイル] > [Swift パッケージ] > [パッケージ依存関係の追加] をクリックします。
2. 表示されたダイアログで、リポジトリ URL https://github.com/microsoft/appcenter-sdk-apple.gitを入力します。
3. [ バージョン] で、[ 次のメジャーまで ] を選択し、既定のオプションを選択します。
4. [ パッケージ製品 ] 列で必要なモジュールを選択します。

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

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

コンパイル済みのバイナリを Xcode プロジェクトに統合して、tvOS アプリの App Center Analytics と App Center のクラッシュを設定する手順を次に示します。

1. zip ファイルとして提供されている App Center SDK フレームワークをダウンロードします。

2. ファイルを解凍すると、 AppCenter-SDK-Apple という名前のフォルダーが表示されます。このフォルダーには、各プラットフォーム フォルダーの App Center サービスごとに異なるフレームワークが含まれています。 AppCenterというフレームワークは、異なるモジュール間で共有されるコードを含むプロジェクトで必要です。

3. [省略可能]サード パーティ製ライブラリのサブディレクトリを作成します。

   • ベスト プラクティスとして、サード パーティ製ライブラリは通常、サブディレクトリ内にあります (多くの場合、 Vendor と呼ばれます)。そのため、プロジェクトをライブラリのサブディレクトリで編成していない場合は、ここで Vendor サブディレクトリを作成します。
   • Xcode プロジェクト内に Vendor という名前のグループを作成して、ディスク上のファイル構造を模倣します。

4. Finder で解凍した AppCenter-SDK-Apple フォルダーを開き、目的の場所にあるプロジェクトのフォルダーにフォルダーをコピーします。 このフォルダーには、App Center SDK がサポートする他のプラットフォームのサブフォルダーにフレームワークが含まれているため、不要なサブフォルダーを削除することが必要になる場合があります。

5. Xcode でプロジェクトに SDK フレームワークを追加します。

   • プロジェクト ナビゲーターが表示されていることを確認します (⌘+1)。
   • ここで、Finder (Vendor フォルダー内のもの) から Xcode のプロジェクト ナビゲーターに AppCenter.framework、AppCenterAnalytics.framework、AppCenterCrashes.framework をドラッグ アンド ドロップします。 SDK を起動するには AppCenter.framework が必要です。それ以外の場合は、他のモジュールが機能せず、アプリがコンパイルされません。
   • ダイアログが表示され、アプリのターゲットがオンになっていることを確認します。 [完了] をクリックします。

アプリケーションにフレームワークを統合したので、次は 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])

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

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

[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 のクラッシュ に関するドキュメントを参照してください。