iOSの手動インストレーション

New Relic機能をご使用のiOSアプリケーションとともにインストールして設定するには、以下の手順に従ってください。ご使用のiOSアプリケーションがCocoapodsを使用する場合は、Cocoapodsインストレーション手順に従ってください。

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

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

iOSアプリケーションをインストールして設定するには：

1. one.newrelic.comに移動します。

2. 該当する場合：Mobile appsインデックスから、

   Add a new appを選択します。

3. Get startedページから、モバイルモニタリング用のプラットフォームとして XCFrameworkを選択します。

4. モバイルアプリケーションに名前を付けて、Continueを選択します。

New Relic の設定手順を続けます。

New Relicフレームワークをアプリケーションに追加する

1. New Relic用のiOS SDKをダウンロードし、解凍します。

2. New RelicフレームワークをXcodeプロジェクトに追加するには：Finderを使用して、NewRelicAgent.frameworkフォルダーをXcodeプロジェクトにドラッグし、フレームワーク、ライブラリ、組み込みコンテンツの下にあるProject navigatorウィンドウにあるプロジェクトにドロップします。埋め込みドロップダウンメニューの下で、埋め込んで署名が選択されていることを確認します。

3. 適切な方法を使用してエージェントを実装します。

   重要

   適切なインストゥルメンテーションを確保するために、didFinishLaunchingWithOptions()の先頭行でエージェントを呼び出し、メインスレッドでエージェントを実行する必要があります。呼び出しを後回しにして、バックグラウンドスレッドで実行したり、非同期で実行したりすると、想定外の動作や不安定な動作を引き起こす場合があります。

   言語	手順
   Objective-C	エージェントを起動するには：New Relicヘッダーをprefix.pchの先頭にインポートします。 自動的に生成される一意のアプリケーショントークンを使用して、AppDelegate.mの-application:didFinishLaunchingWithOptions:の先頭に+[NewRelic startWithApplicationToken:@"<appToken>"]を追加します。
   Swift	ブリッジングヘッダファイルを作成します。 File（ファイル）> New（新規）> File（ファイル）> Objective-C File（Objective-Cファイル）の順に選択します。 ファイルPlaceholder.mに名前を付け、次へを選択します。 Create（作成）を選択し、ブリッジングヘッダの生成を促すXcodeプロンプトに同意します。 Placeholder.mを削除します。 MyApp-Bridging-Header.hの先頭に#import "NewRelic/NewRelic.h"を追加してNew Relicエージェントをインポートします。 自動的に生成される一意のアプリケーショントークンを使用して、AppDelegate.swiftのapplication(_:didFinishLaunchingWithOptions:)の先頭にNewRelic.start(withApplicationToken: ">appToken>")を追加します。

4. ビルドスクリプトをターゲットのビルドフェーズに追加します。新しいビルドスクリプトが最後のビルドフェーズであることを確認してから、以下をペーストして、PUT_NEW_RELIC_APP_TOKEN_HEREをアプリケーショントークンに置き換えます：

   SCRIPT=`/usr/bin/find "${SRCROOT}" -name newrelic_postbuild.sh | head -n 1`
   /bin/sh "${SCRIPT}" "PUT_NEW_RELIC_APP_TOKEN_HERE"

   コピー

5. アプリをクリーンにして構築してから、シミュレータまたは他のデバイスで実行します。

オプション: デモクラッシュの実行

アプリがクラッシュする問題が発生している場合、New Relic エージェントでは API でデモクラッシュを実行できます。

推奨事項：以下のいずれか1つの命令行を、必要に応じて、ボタンクリックイベントハンドラに追加します。

[NewRelic crashNow];

[NewRelic crashNow:@"<reason>"];

NewRelic.crashNow()

NewRelic.crashNow(_ message:)

オプション：ロギングレベルの変更

モバイルアプリをモニタリングする際は、以下の6つのログレベルを使用できます。

• none
• error
• warning
• info
• verbose
• ALL

アプリでロギングレベルを上げるには、以下のメソッドを追加します。

[NRLogger setLogLevels:NRLogLevelALL];

NRLogger.setLogLevels(NRLogLevelALL.rawValue)