Objective-C

アプリケーションの起動後すぐにモバイルエージェントを初期化するには、アプリケーションの ファイルを編集します。これによりアプリケーションが登録されます。編集はコードで一度だけ実行する必要があります。

1. AppDelegate.m ファイルに次の import ステートメントを追加します。

   #import <ADEumInstrumentation/ADEumInstrumentation.h>

2. didFinishLaunchingWithOptions メソッドで、Getting Started Wizard の完了時に受領した EUM アプリケーションキーを使用して ADEumAgentConfiguration オブジェクトを作成し、iOS エージェントを初期化します。

   // Example EUM App Key: "AAA-AAB-AUM"
   ADEumAgentConfiguration *config = [[ADEumAgentConfiguration alloc] initWithAppKey:<#EUM_APP_KEY#>];

   コードは次のように指定する必要があります。

   #import <ADEumInstrumentation/ADEumInstrumentation.h>
   #import "AppDelegate.h"
    
       // ...
       -(BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
       {
           // Example EUM App Key: "AAA-AAB-AUM"
           ADEumAgentConfiguration *config = [[ADEumAgentConfiguration alloc] initWithAppKey:<#EUM_APP_KEY#>]; 
           // other tasks
           return YES;
       }
   

3. iOS エージェントを設定して地域内の SaaS EUM サーバにメトリックとスクリーンショットを報告し、ADEumAgentConfiguration オブジェクトをメソッド initWithConfiguration に渡してエージェントを初期化します。（オンプレミスの EUM サーバーを使用している場合は、「オンプレミス展開用の iOS エージェントの構成（オプション）」を参照してください）。

   #import <ADEumInstrumentation/ADEumInstrumentation.h>
   #import "AppDelegate.h"
    
       // ...
       -(BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
       {
           ADEumAgentConfiguration *config = [[ADEumAgentConfiguration alloc] initWithAppKey:<#EUM_APP_KEY#>];
           //The default SaaS EUM Server and Screenshot Service are in the Americas, 
   		// so you can omit the following settings if you are in the Americas.
           config.collectorURL = @"https://<your_region>-col.eum-appdynamics.com";
           config.screenshotURL = @"https://<you_region>-image.eum-appdynamics.com/";
           [ADEumInstrumentation initWithConfiguration: config];
           // other tasks
           return YES;
        }
   

4. （オプション）アプリケーションが別のツールを使用してクラッシュを報告している場合、iOS エージェントは次のメッセージによる警告を行うことがあります。

   Agent has detected a third party crash reporting tool. You may wish to disable AppDynamics Crash Reporting by setting the crashReportingEnabled configuration flag to NO

   より良い結果を得るために、クラッシュレポートツールは 1 つだけ使用することをお勧めします。iOS エージェントのクラッシュレポートを無効にする方法については、「クラッシュレポートの無効化」を参照してください。
5. ファイルを保存します。

Swift

iOS エージェントは、Swift プログラミング言語を使用して作成されたアプリケーションと互換性があります。

1. アプリケーションの AppDelegate クラスで、次の import ステートメントを追加します。

   import ADEumInstrumentation

2. AppDelegate クラス didFinishLaunchingWithOptionsで、Getting Started Wizard の完了時に受領した EUM アプリケーションキーを使用して ADEumAgentConfiguration オブジェクトを作成し、iOS エージェントを初期化します。

   #import <ADEumInstrumentation/ADEumInstrumentation.h>
   #import "AppDelegate.h"
    
       // ...
       func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
           let config = ADEumAgentConfiguration(appKey: <#EUM_APP_KEY#>)
       }

3. iOS エージェントを設定して地域内の SaaS EUM サーバにメトリックとスクリーンショットを報告し、ADEumAgentConfiguration オブジェクトをパラメータとして initWith() メソッドに渡してエージェントを初期化します。
   注: （オンプレミスの EUM サーバーを使用している場合は、「オンプレミス展開用の iOS エージェントの構成（オプション）」を参照してください）。

   #import <ADEumInstrumentation/ADEumInstrumentation.h>
   #import "AppDelegate.h"
    
       // ...
        func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
           let config = ADEumAgentConfiguration(appKey: <#EUM_APP_KEY#>)
           config.collectorURL = "https://<your_region>.eum-appdynamics.com"
           config.screenshotURL = "https://<your_region>-image.eum-appdynamics.com"
           ADEumInstrumentation.initWith(config)
           // other tasks
           return true
       }
   // ...

4. （オプション）アプリケーションが別のツールを使用してクラッシュを報告している場合、iOS エージェントは次のメッセージによる警告を行います。

   Agent has detected a third party crash reporting tool. You may wish to disable AppDynamics Crash Reporting by setting the crashReportingEnabled configuration flag to NO

   より良い結果を得るために、クラッシュレポートツールは 1 つだけ使用することを推奨します。iOS エージェントのクラッシュレポートを無効にする方法については、「クラッシュレポートの無効化」を参照してください。
5. ファイルを保存します。

Apple Watch の拡張機能

watchOS 1 用に作成されたアプリケーションには、ユーザーの iPhone で実行する WatchKit 拡張機能が含まれていますが、watchOS 2 ではさらに新しいアーキテクチャもサポートされます。つまり、WatchKit 拡張機能が Apple Watch 自体で実行されます。Splunk AppDynamics では watchOS 1 アーキテクチャをサポートしていますが、新しい watchOS 2 アーキテクチャはサポートしていません。watchOS 1 アーキテクチャを使用するアプリケーションは watchOS 1 と 2 の両方で実行できるため、アプリケーションが watchOS 1 用に設計されている場合は、両方のバージョンの watchOS で Splunk AppDynamics を使用できます。

watchOS 1 アプリは Watch UI の操作に応答して機能的に起動されるため、SDK 初期化コードは iPhone アプリでのその操作の時点で呼び出される必要があります。これは通常、拡張機能の AppDelegate.m コールとは異なります。構文に変更はありません。

アプリケーションがクラッシュした場合に生成されるクラッシュスナップショットに、人間が判読可能な情報をエージェントが提供できるようにするには、[ ] ファイルオプションを使用してコンパイルし、アプリケーションのデバッグシンボル（dSYM）ファイルを生成します。これを行う理由について詳しくは、「人間が判読可能なクラッシュスナップショットの取得」を参照してください。