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プロジェクトにドラッグし、Frameworks, Libraries, and Embedded Contentの下にあるProject navigatorウィンドウにあるプロジェクトにドロップします。埋め込みドロップダウンメニューの下で、埋め込んで署名が選択されていることを確認します。

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

   重要

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

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

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つのログレベルを使用できます。

• なし
• エラー
• 警告
• 情報
• 詳細
• ALL

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

[NRLogger setLogLevels:NRLogLevelALL];

NRLogger.setLogLevels(NRLogLevelALL.rawValue)