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

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

1. アプリケーションの AppDelegate.m ファイルで、次の import ステートメントを追加します。

   #import <ADEUMInstrumentation/ADEumInstrumentation.h>

   CPP

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

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

   CPP

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

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

   CPP

3. iOS エージェントを設定して地域内の SaaS EUM Server にメトリックとスクリーンショットを報告し、ADeumAgentConfiguration オブジェクトをメソッド initWithConfiguration に渡してエージェントを初期化します（オンプレミスの EUM Server を使用している場合は、実装の詳細について、「オンプレミス展開用の 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://col.eum-appdynamics.com";
           config.screenshotURL = "https://image.eum-appdynamics.com/";
           [ADEumInstrumentation initWithConfiguration: config];
           // other tasks
           return YES;
        }
   

   CPP

   #import <ADEUMInstrumentation/ADEumInstrumentation.h>
   #import "AppDelegate.h"
    
       // ...
       -(BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
       {
           ADEumAgentConfiguration *config = [[ADEumAgentConfiguration alloc] initWithAppKey:<#EUM_APP_KEY#>]; 
           // Configure the iOS Agent to report the metrics and screenshots to the SaaS EUM Server in EMEA
           config.collectorURL = "https://fra-col.eum-appdynamics.com";
           config.screenshotURL = "https://fra-image.eum-appdynamics.com/";
           [ADEumInstrumentation initWithConfiguration: config];
           // other tasks
           return YES;
       }
   

   CPP

   #import <ADEUMInstrumentation/ADEumInstrumentation.h>
   #import "AppDelegate.h"
    
       // ...
       -(BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
       {
           ADEumAgentConfiguration *config = [[ADEumAgentConfiguration alloc] initWithAppKey:<#EUM_APP_KEY#>]; 
           // Configure the iOS Agent to report the metrics and screenshots to the SaaS EUM Server in EMEA
           config.collectorURL = "https://syd-col.eum-appdynamics.com";
           config.screenshotURL = "https://syd-image.eum-appdynamics.com/";
           [ADEumInstrumentation initWithConfiguration: config];
           // other tasks
           return YES;
       }
   

   CPP

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

   TEXT

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

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

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

1. アプリケーションの AppDelegate.swift ファイルで、次の import ステートメントを追加します。

   import ADEUMInstrumentation

   CPP

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

   // Example EUM App Key: "AAA-AAB-AUM"
   let config = ADEumAgentConfiguration(appKey: <#EUM_APP_KEY#>) 

   CPP

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

   #import <ADEUMInstrumentation/ADEumInstrumentation.h>
   #import "AppDelegate.h"
    
       // ...
       func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
           let config = ADEumAgentConfiguration(appKey: <#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://col.eum-appdynamics.com"
           config.screenshotURL = "https://image.eum-appdynamics.com"
           ADEumInstrumentation.initWith(config)
           // other tasks
           return true
       }
   

   CPP

   #import <ADEUMInstrumentation/ADEumInstrumentation.h>
   #import "AppDelegate.h"
    
       // ...
       func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
           let config = ADEumAgentConfiguration(appKey: <#EUM_APP_KEY#>) 
           // Configure the iOS Agent to report the metrics and screenshots 
           // to the SaaS EUM Server in EMEA
           config.collectorURL = "https://fra-col.eum-appdynamics.com"
           config.screenshotURL = "https://fra-image.eum-appdynamics.com"
           ADEumInstrumentation.initWith(config)
           // other tasks
           return true
       }
   

   CPP

   #import <ADEUMInstrumentation/ADEumInstrumentation.h>
   #import "AppDelegate.h"
    
       // ...
       func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
           let config = ADEumAgentConfiguration(appKey: <#EUM_APP_KEY#>) 
           // Configure the iOS Agent to report the metrics and screenshots 
           // to the SaaS EUM Server in APAC
           config.collectorURL = "https://syd-col.eum-appdynamics.com"
           config.screenshotURL = "https://syd-image.eum-appdynamics.com"
           ADEumInstrumentation.initWith(config)
           // other tasks
           return true
       }
   

   CPP

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

   TEXT

   より良い結果を得るために、クラッシュレポートツールは 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 コールとは異なります。構文に変更はありません。