Unity 모바일 앱 모니터링

요구 사항 검토

Unity 에이전트를 설치하기 전에 Unity 앱이 다음 버전 요구 사항을 충족하는지 확인하세요.

• Android 네이티브 앱의 경우:

  • 안드로이드 API 24 이상
  • Android 기본 요구사항보기

• iOS 네이티브 앱의 경우:

  • iOS 네이티브 요구 사항보기

프로젝트에 Unity 에이전트 추가

Unity 패키지 관리자에서 다음 GitHub URL을 추가합니다.

https://github.com/newrelic/newrelic-unity-agent.git

애플리케이션 토큰 추가

Unity 앱의 데이터를 인증하기 위해 New Relic을 활성화하려면 다음 단계를 따르세요.

1. New Relic에서 애플리케이션 토큰을 가져옵니다.

   1. one.newrelic.com 으로 이동하여 Integrations & Agents 클릭한 다음 Mobile 클릭하세요.
   2. Unity 앱을 선택하세요.
   3. Settings > Application 으로 이동하여 표시된 Application token 을 복사합니다.

2. Unity 프로젝트에 토큰을 추가합니다.

   1. Unity IDE를 엽니다.

   2. 편집기 창을 열려면 Tools > New Relic > Getting Started 으로 이동하세요.

   3. 앱이 지원하는 각 플랫폼에 해당하는 필드에 적절한 애플리케이션 토큰을 붙여넣습니다.

      • Android: Android 토큰을 'Android 앱 토큰' 필드에 붙여넣습니다.
      • iOS: iOS 토큰을 'iOS 앱 토큰' 필드에 붙여넣습니다.

      앱이 Android와 iOS 모두에서 실행되는 경우 각 플랫폼마다 별도의 토큰을 제공하세요. 두 가지 모두에 동일한 토큰을 사용하지 마십시오.

   

(Android 전용) Android 앱 구성

Android 앱을 구성하려면 Gradle 템플릿을 사용자 정의해야 합니다. Unity 2019 이상을 사용하는 경우 아래 단계를 따르세요.

1. Gradle 빌드 설정에서 뉴럴릭 Maven 저장소 URL을 포함해야 합니다. 이렇게 하려면 일반적으로 Assets/Plugins/Android 폴더에 있는 mainTemplate.gradle 파일을 엽니다. 다음 스니펫을 추가합니다.

   allprojects {
     buildscript {
       repositories {
         ARTIFACTORY_REPOSITORY
         google()
         jcenter()
         mavenCentral()
       }
     }
   }

   카피

2. baseProjectTemplate.gradle 파일(일반적으로 Unit 프로젝트의 Android 폴더에 있음)에서 프로젝트 수준에서 뉴렐릭 classpath 을 추가합니다.

   dependencies {
     // If you are changing the Android Gradle Plugin version,
     // make sure it is compatible with the Gradle version preinstalled with Unity.
     // See which Gradle version is preinstalled with Unity here:
     //    https://docs.unity3d.com/Manual/android-gradle-overview.html
     // See the official Gradle and Android Gradle Plugin compatibility table here:
     //    https://developer.android.com/studio/releases/gradle-plugin#updating-gradle
     // To specify a custom Gradle version in Unity, go to "Preferences > External Tools",
     // uncheck "Gradle Installed with Unity (recommended)",
     // and specify a path to a custom Gradle version.
     classpath 'com.newrelic.agent.android:agent-gradle-plugin:7.2.0'
     BUILD_SCRIPT_DEPS
   }

   카피

   Gradle 7.0 이하가 필요한 이전 Unity 버전을 사용하는 경우 호환성을 보장하기 위해 특정 클래스 경로 종속성을 사용해야 합니다.

   dependencies {
     // If you are changing the Android Gradle Plugin version,
     // make sure it is compatible with the Gradle version preinstalled with Unity.
     // See which Gradle version is preinstalled with Unity here:
     //    https://docs.unity3d.com/Manual/android-gradle-overview.html
     // See official Gradle and Android Gradle Plugin compatibility table here:
     //    https://developer.android.com/studio/releases/gradle-plugin#updating-gradle
     // To specify a custom Gradle version in Unity, go to "Preferences > External Tools",
     // uncheck "Gradle Installed with Unity (recommended)",
     // and specify a path to a custom Gradle version.
     classpath 'com.newrelic.agent.android:agent-gradle-plugin:6.11.0'
     BUILD_SCRIPT_DEPS
   }

   카피

   프로젝트에서 플러그인 DSL을 사용하는 경우 다음과 같이 변경하세요(3단계는 건너뛰세요).

   android/app/build.gradle에서:

   plugins {
       id "com.android.application"
       id "kotlin-android"
       id "com.newrelic.agent.android" version "7.5.1"  //<-- include this
   }

   카피

3. launcherTemplate.gradle 파일(일반적으로 Unity 프로젝트의 Android 폴더에 있음)에서 launcherTemplate.gradle 파일 맨 위에 newrelic 플러그인을 적용합니다.

   apply plugin: "com.android.application"
   apply plugin: 'newrelic' // <-- add this

   카피

4. AndroidManifest.xml 파일에서 다음 권한을 추가하세요.

   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

   카피

(iOS만 해당) 종속성 관리

iOS의 경우 외부 종속성 관리자 설정을 확인하세요.

1. Unity IDE에서 Assets 으로 이동하여 External Dependency Manager 을 엽니다.

2. iOS Resolver 을(를) 클릭합니다.

3. Podfile 구성 섹션에서 다음 설정을 확인합니다.

   • Add use_frameworks! to Podfile 비활성화되었습니다
   • Always add the main target to Podfile 사용 가능
   

4. iOS 종속성 관리를 위해 Podfile을 사용하지 않는 경우 다음 단계를 따르세요.

   1. New Relic XCFramework SDK(iOS 에이전트)를 다운로드하고 압축을 풉니다. iOS 에이전트 릴리스 노트 에서 최신 iOS 에이전트를 얻을 수 있습니다.

   2. Xcode 프로젝트에 New Relic XCFramework를 추가합니다.

      1. SDK 다운로드의 압축을 풉니다.
      2. Finder에서 NewRelicAgent.xcframework 폴더를 Xcode 프로젝트로 드래그하여 Targets Frameworks 창에 배치합니다.
      3. Embed 열 아래에서 Embed & Sign 클릭합니다.

   그리고 끝났습니다! 5분 이내에 New Relic에서 데이터를 보기 시작해야 합니다.