iOS SDK のインストール

注: iOS 14 リリース（iOS エージェント 20.10.0 でサポート）で、Apple は新しいデータ収集ポリシーを導入しました。「データ収集の詳細」を参照してください。

Splunk AppDynamics iOS SDK フレームワークは、iOS アプリケーションのパフォーマンスとアクティビティをモニターするのに役立ちます。Splunk AppDynamics GitHub リポジトリから Xcode 環境に Splunk AppDynamics iOS SDK を追加できます。

CocoaPods または Swift Package Manager を使用して iOS SDK をインストールするか、iOS SDK を手動でダウンロードしてインストールできます。CocoaPods または Swift Package Manager では依存関係、ビルド設定が処理され、アップグレードが簡単になるので、これらを使用した iOS SDK のインストールをお勧めします。

注:
  • Swift Package Manager のインストールは、iOS エージェント 23.10.1 以降でサポートされています。
  • iOS エージェントの各オープン ソース コンポーネントの著作権とライセンスのリストをダウンロードします。リリースノートリリースノート

推奨されるインストール方法については、次の手順に従ってください。

iOS SDK Install Requirements

You must have the supported Xcode version.

Installation Type Xcode Version
CocoaPods and Manual >=7
Swift Package Manager >=14.1

CocoaPods のインストール

  1. 次の行を Podfile の ブロックに追加します。 
    ポッド「AppDynamicsAgent」

    例：

    platform :ios, '8.0'
use_frameworks!

target 'YourApp' do
  pod 'AppDynamicsAgent'
end
  2. プロジェクトディレクトリで、次のコマンドを実行します。 
    ポッドのインストール

iOS SDK のダウンロード

  1. ダウンロードページに移動します。
  2. [APP AGENT] リストから、[Mobile RUM Agent - iOS] チェックボックスをオンにします。
  3. [] の結果に表示される最新の iOS エージェントで [] をクリックします。これにより、iOSAgent-<version>.zip という名前のファイルがダウンロードされます。

アプリケーションへのフレームワークの追加

注意: Swift フレームワークは、アプリケーションをコンパイルする Xcode とまったく同じバージョンの Swift で構築されている場合にのみ使用できます。
  1. iOSAgent-<version>.zip を解凍します。
  2. ADEUMInstrumentation.framework（または ADEUMInstrumentation.xcframework）フォルダをプロジェクトの Xcode にインポートします。
注: Xcode が自動的に正しいパスを追加したことを確認できない場合は、フレームワークへのプロジェクト相対パスを追加します。

必要なライブラリの追加

Splunk AppDynamics iOS エージェントには、次のライブラリが必要です。
  • SystemConfiguration.framework
  • CoreTelephony.framework
  • libz.dylib または .tbd
  1. Xcode でアプリケーションを構築するターゲットを選択します。
  2. [Build Phases] タブを選択します。
  3. [バイナリとライブラリのリンク]セクションを展開します。
  4. 上記のライブラリのいずれかが表示されない場合は、次の手順を実行します。
    • [+]ボタンをクリックします。
    • リスト内で欠落しているライブラリを特定します。
    • [追加（Add）] をクリックします。
欠落しているライブラリごとにこの手順を繰り返します。

-ObjC フラグの設定

また、[Other Linker Flags] にも -ObjC フラグを追加する必要があります。
  1. Xcodeのプロジェクトナビゲータでプロジェクトを選択します。
  2. ターゲットリストで、アプリケーションを構築するターゲットを選択します。
  3. [Build Settings] タブを選択します。
  4. [] にスクロールして開きます。
  5. [] に移動し、ダブルクリックしてポップアップを開きます。
  6. フラグがリストにない場合は、[]をクリックして追加します。
警告: この フラグが必要になるのは、iOS エージェントが実行時に呼び出すことができるメソッドでカテゴリを定義するためです。デフォルトでは、これらのメソッドはリンカによってロードされません。その結果、「unrecognized selector」という実行時の例外が取得されます。 を使用すると、メソッドが確実にロードされます。

Swift Package Manager のインストール

注: Swift Package Manager のインストールは、iOS エージェント 23.10.1 以降でサポートされています。
Splunk AppDynamics iOS SDK パッケージを追加するには、Xcode 環境で次の手順を実行します。
  1. [File > Add Packages] に移動します。
  2. 検索バーで、次の GitHub URL を指定します。
    https://github.com/CiscoDevNet/AppDynamicsAgent.git
  3. 追加するバージョンを指定します。
  4. [アップグレードパッケージの追加（Add Upgrade Package）] をクリックします。
  5. パッケージとターゲットアプリケーションを選択します。
  6. [アップグレードパッケージの追加（Add Upgrade Package）] をクリックします。

パッケージを追加したら、次の手順を実行します。

  1. 必要なライブラリを追加します。
  2. -Objc フラグを設定します。
  3. 各ビルドに dSYM ファイルを自動的にアップロードします。

Upgrade the iOS SDK

Upgrade with CocoaPods

  1. In your project directory, run this command: $ pod update
  2. Rebuild.

Upgrade Manually

To pick up new features or to get crucial bug fixes, you may want to upgrade the iOS SDK in your app manually.
  1. Download the updated SDK.
  2. Replace the .framework file with the updated SDK.
  3. Rebuild your app to apply the changes.