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 エージェントの各オープンソースコンポーネントの著作権とライセンスのリストをダウンロードします。リリースノート手動でのアップグレード

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

CocoaPods のインストール
手動でのインストール
Swift Package Manager のインストール

iOS SDK のインストール要件

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


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

CocoaPods のインストール

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

pod 'AppDynamicsAgent'

例：

platform :ios, '8.0'
use_frameworks!

target 'YourApp' do
  pod 'AppDynamicsAgent'
end

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

手動でのインストール

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

iOS SDK のダウンロード

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

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

注意: Swift フレームワークは、アプリケーションをコンパイルする Xcode とまったく同じバージョンの Swift で構築されている場合にのみ使用できます。

iOSAgent-<version>.zip を解凍します。
ADEUMInstrumentation.framework（または ADEUMInstrumentation.xcframework）フォルダをプロジェクト Xcode にインポートします。

注: Xcode が自動的に正しいパスを追加したことを確認できない場合は、フレームワークへのプロジェクト相対パスを追加します。

必要なライブラリの追加

Splunk AppDynamics iOS エージェントには、次のライブラリが必要です。

SystemConfiguration.framework
CoreTelephony.framework
libz.dylib または .tbd

Xcode でアプリケーションを構築するターゲットを選択します。
[Build Phases] タブを選択します。
[Link Binary With Libraries] セクションを展開します。
上記のライブラリのいずれかが表示されない場合は、次の手順を実行します。
- [+] ボタンをクリックします。
- リスト内で欠落しているライブラリを特定します。
- [Add] をクリックします。

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

-ObjC フラグの設定

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

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

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

Swift Package Manager のインストール

注: Swift Package Manager のインストールは、iOS エージェント 23.10.1 以降でサポートされています。

Splunk AppDynamics iOS SDK パッケージを追加するには、Xcode 環境で次の手順を実行します。

File > Add Packages にアクセスします。
検索バーで、次の GitHub URL を指定します。
https://github.com/CiscoDevNet/AppDynamicsAgent.git
追加するバージョンを指定します。
Add Package をクリックします。
パッケージとターゲットアプリケーションを選択します。
Add Package をクリックします。

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

iOS SDK のアップグレード

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

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

手動でのアップグレード

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

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