iOS アプリケーションのインストゥルメント化

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

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

   #import <ADEumInstrumentation/ADEumInstrumentation.h>

   OBJ-C

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

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

   OBJ-C

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

   #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;
       }
   

   OBJ-C

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>.eum-appdynamics.com";
           config.screenshotURL = "https://<you_region>-image.eum-appdynamics.com/";
           [ADEumInstrumentation initWithConfiguration: config];
           // other tasks
           return YES;
        }
   

   OBJ-C

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

   OBJ-C

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

5. ファイルを保存します。

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

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

   import ADEumInstrumentation

   SWIFT

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#>)
       }

   SWIFT

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
       }
   // ...

   SWIFT

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

   SWIFT

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

5. ファイルを保存します。

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

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