CocoaPods の手動インストール

iOS 監視を設定するには、ガイド付きインストールを使用することをお勧めします。ただし、エージェントを手動でインストールする必要がある場合は、以下の手順に従って、Cocoapods を使用して New Relic iOS エージェントをインストールします。

ご使用のiOSアプリケーションのインストール

インストレーションプロセスの一環として、New Relicはアプリケーショントークンを自動的に生成します。これはNew Relic でモニタリングする各モバイルアプリケーションを認証するための40文字の16進数の文字列です。

iOS または tvOS アプリケーションをインストールして構成するには:

one.newrelic.comにアクセスします。
(該当する場合) [モバイルアプリ] リストから、 [新しいアプリの追加]を選択します。
Get Started ページから、モバイルモニタリングのプラットフォームとして iOS を選択します。
モバイルアプリの名前を入力して、 Continue を選択します。

引き続き、New Relicをモバイルモニタリング用に設定する手順をご紹介します。

Objective-Cによる設定

CocoaPods と Objective-C を使用して iOS/tvOS アプリを構成するこれらの手順は、New Relic の Get Started ページにも表示されます。

プロジェクトのPodfileに次の行を追加します。
```
pod 'NewRelicAgent'
```
Xcode でプロジェクトを閉じてからターミナルを開き、プロジェクトのディレクトリで次のコマンドを実行します。
bash
```
$pod install
```
ターミナルで次のコマンドを実行して、Xcode でプロジェクトを開きます。
bash
```
$open App.xcworkspace
```
AppDelegate.mファイルに、次の New Relic ヘッダーを追加します。
```
#import <NewRelic/NewRelic.h>
```
AppDelegate.mファイルで、次の呼び出しをapplication:didFinishLaunchingWithOptionsの最初の行として追加し、 APP_TOKENをアプリケーショントークンに置き換えます。
```
[NewRelic startWithApplicationToken:@"APP_TOKEN"];
```
重要
エージェントはdidFinishLaunchingWithOptionsの最初の行にあり、メインスレッドで実行して、適切なインスツルメンテーションを確保する必要があります。後で、バックグラウンドスレッドで、または非同期で呼び出しを開始すると、予期しない動作や不安定な動作が発生する可能性があります。
このリポジトリをダウンロードします: https://github.com/newrelic/newrelic-ios-agent-spm/archive/refs/heads/main.zip 。
ダウンロードしたリポジトリから、 dsym-upload-tools xcodeprojectファイルが含まれるフォルダーにコピーします。これで、次のファイルを含むフォルダーが作成されるはずです。
- YOUR_PROJECT.xcodeproj
- dsym-upload-tools/
iOS エージェントのバージョンに基づいて、以下のビルドスクリプトをターゲットのBuild Phases [ビルドフェーズ]に追加します。このスクリプトが最後のビルドスクリプトであることを確認し、 APP_TOKENをアプリケーショントークンに置き換えます。
- iOS エージェント 7.4.0 以降の場合:
bash
```
$ARTIFACT_DIR="${BUILD_DIR%Build/*}"
$SCRIPT=`/usr/bin/find "${SRCROOT}" "${ARTIFACT_DIR}" -type f -name run-symbol-tool | head -n 1`
$/bin/sh "${SCRIPT}" "APP_TOKEN"
```
- iOS エージェント 7.3.8 の場合以下:
bash
```
$SCRIPT=`/usr/bin/find "${SRCROOT}" -name newrelic_postbuild.sh | head -n 1`
$/bin/sh "${SCRIPT}" "APP_TOKEN"
```
(オプション) デバッグ中にシンボルのアップロードをスキップするには、上記のビルドスクリプトに次の行を追加します。
bash
```
$if [ ${CONFIGURATION} = "Debug" ]; then
$    echo "Skipping DSYM upload CONFIGURATION: ${CONFIGURATION}"
$    exit 0
$fi
```
アプリをクリーンアップしてビルドし、シミュレーターまたは別のデバイスで実行します。

Swiftを使った設定

CocoaPods と Swift を使用して iOS/tvOS アプリを構成するこれらの手順は、New Relic の [Get Started] ページにも表示されます。

プロジェクトのPodfile に、次の行を追加します。
```
pod 'NewRelicAgent'
```
Xcode でプロジェクトを閉じ、プロジェクトディレクトリのターミナルから次のコマンドを実行して更新します。
bash
```
$pod install
```
プロジェクトディレクトリのターミナルから次のコマンドを実行して、Xcode でプロジェクトを開きます。
bash
```
$open App.xcworkspace
```
AppDelegate.swiftに、New Relic ヘッダーを追加します (アプリが SwiftUI で記述されている場合は、次の手順に従って AppDelegate をプロジェクトに追加します)。
```
import NewRelic
```
AppDelegate.swiftファイルで、次の呼び出しをapplication:didFinishLaunchingWithOptionsの最初の行として追加し、 APP_TOKENをアプリケーショントークンに置き換えます。
```
NewRelic.start(withApplicationToken:"APP_TOKEN")
```
重要
適切な計測を行うには、 didFinishLaunchingWithOptions()の最初の行でエージェントを呼び出し、メインスレッドでエージェントを実行する必要があります。後で (バックグラウンドスレッドまたは非同期で) 呼び出しを開始すると、予期しない動作や不安定な動作が発生する可能性があります。
このリポジトリをダウンロードします: https://github.com/newrelic/newrelic-ios-agent-spm/archive/refs/heads/main.zip 。
ダウンロードしたリポジトリから、 dsym-upload-tools xcodeprojectファイルが含まれるフォルダーにコピーします。これで、次のファイルを含むフォルダーが作成されるはずです。
- YOUR_PROJECT.xcodeproj
- dsym-upload-tools/
iOS エージェントのバージョンに基づいて、以下のビルドスクリプトをターゲットのBuild Phases [ビルドフェーズ]に追加します。このスクリプトが最後のビルドスクリプトであることを確認し、 APP_TOKENをアプリケーショントークンに置き換えます。
- iOS エージェント 7.4.0 以降の場合:
```
ARTIFACT_DIR="${BUILD_DIR%Build/*}"
SCRIPT=`/usr/bin/find "${SRCROOT}" "${ARTIFACT_DIR}" -type f -name run-symbol-tool | head -n 1`
/bin/sh "${SCRIPT}" "APP_TOKEN"
```
- iOS エージェント 7.3.8 の場合以下:
```
SCRIPT=`/usr/bin/find "${SRCROOT}" -name newrelic_postbuild.sh | head -n 1`
/bin/sh "${SCRIPT}" "APP_TOKEN"
```
(オプション) デバッグ中にシンボルのアップロードをスキップするには、上記のビルドスクリプトに次の行を追加します。
```
if [ ${CONFIGURATION} = "Debug" ]; then
    echo "Skipping DSYM upload CONFIGURATION: ${CONFIGURATION}"
    exit 0
fi
```
アプリをクリーンアップしてビルドし、シミュレーターまたは別のデバイスで実行します。

このドキュメントはインストールで役立ちましたか。

(オプション) ログレベルを変更する

デフォルトでは、iOS エージェントはinfoレベルでログを記録します。ログレベルを変更して、収集するデータを増減できます。サポートされているログレベルは 6 つあります。

none
error
warning
info
verbose
ALL

重要

ログレベルをverbose以上に増やすのは、リリースビルドではなく、デバッグの場合のみです。

アプリのロギングレベルを変更するには、 NewRelic.start(withApplicationToken)を呼び出す前に次のメソッド呼び出しを追加します。

目的-c:
```
[NRLogger setLogLevels:NRLogLevelALL];
```

迅速：

NRLogger.setLogLevels(NRLogLevelALL.rawValue)