iOS SDK のインストール

Related pages：

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

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

iOS エージェントの各オープンソースコンポーネントの著作権とライセンスのリストをダウンロードします。リリースノートを参照してください。

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

CocoaPods のインストール
手動でのインストール

iOS SDK のインストール要件

iOS SDK をインストールするには、Xcode 7 以降を実行している必要があります。

CocoaPods のインストール

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

pod 'AppDynamicsAgent'

例：

platform :ios, '8.0'
use_frameworks!

target 'YourApp' do
  pod 'AppDynamicsAgent'
end

TEXT

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

手動でのインストール

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

iOS SDK のダウンロード

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

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

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

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

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

必要なライブラリの追加

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] タブを選択します。
[Linking] にスクロールして開きます。
[Other Linker Flags] に移動し、ダブルクリックしてポップアップを開きます。
-ObjC フラグがリストにない場合は、[+] をクリックして追加します。

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

iOS SDK のアップグレード

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

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

手動でのアップグレード

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

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