関連ページ：

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

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 のインストール要件

サポートされている Xcode バージョンが必要です。

インストール タイプXcode バージョン
CocoaPods と手動7 以降
Swift Package Manager14.1 以降

CocoaPods のインストール

  1. 次の行を Podfile の target ブロックに追加します。

    pod 'AppDynamicsAgent'

    例：

    platform :ios, '8.0'
use_frameworks!

target 'YourApp' do
  pod 'AppDynamicsAgent'
end
    TEXT

  2. プロジェクトディレクトリで、次のコマンドを実行します。

    pod install

手動でのインストール

iOS SDK を手動でインストールするには、次の手順を実行します。

iOS SDK のダウンロード

  1. ダウンロードページに移動します。

  2. [APP AGENT] リストから、[Mobile RUM Agent - iOS] チェックボックスをオンにします。
  3. [Releases] の結果に表示される最新の iOS エージェントで [Download] をクリックします。これにより、「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. [Link Binary With Libraries] セクションを展開します。
  4. 上記のライブラリのいずれかが表示されない場合は、次の手順を実行します。
    • [+] ボタンをクリックします。
    • リスト内で欠落しているライブラリを特定します。
    • [Add] をクリックします。 

欠落しているライブラリごとにこの手順を繰り返します。

-ObjC フラグの設定

また、[Other Linker Flags] にも -ObjC フラグを追加する必要があります。  

  1. [Project Navigator] でプロジェクトを選択します。
  2. ターゲットリストで、アプリケーションを構築するターゲットを選択します。
  3. [Build Settings] タブを選択します。
  4. [Linking] にスクロールして開きます。
  5. [Other Linker Flags] に移動し、ダブルクリックしてポップアップを開きます。 
  6. -ObjC フラグがリストにない場合は、[+] をクリックして追加します。  

この -ObjC フラグが必要になるのは、iOS エージェントが実行時に呼び出すことができるメソッドでカテゴリを定義するためです。デフォルトでは、これらのメソッドはリンカによってロードされません。その結果、「unrecognized selector」という実行時の例外が取得されます。-ObjC を使用すると、メソッドが確実にロードされます。

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 Package をクリックします。
  5. パッケージとターゲットアプリケーションを選択します。
  6. Add Package をクリックします。

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

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

Swift Package Manager を使用した iOS エージェントの更新

Xcode 環境で次の手順を実行します。

  1. [Package Dependencies] セクションで、Splunk AppDynamics エージェントパッケージに移動します。
  2. Splunk AppDynamics エージェントパッケージを右クリックし、[Update Package] をクリックします。
  3. 更新バージョンに一致するようにバージョンルールを変更します。

詳細については、「Adding package dependencies to your app」を参照してください。

iOS SDK のアップグレード

CocoaPods を使用したアップグレード

  1. プロジェクトディレクトリで、次のコマンドを実行します。$ pod update

  2. 再構築します。

手動でのアップグレード

新しい機能を取得したり、重要なバグを修正したりするには、アプリで iOS SDK をアップグレードします。

  1. 更新された SDK をダウンロードします。
  2. 更新された SDK を使用して、.framework ファイルを置き換えます。
  3. アプリを再構築します。