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으로 이동합니다. Add data클릭한 다음 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 빌드 설정에 New Relic Maven 저장소 URL을 포함합니다. 이렇게 하려면 mainTemplate.gradle 파일을 엽니다. 이 파일은 일반적으로 Assets/Plugins/Android folder 에 있습니다. 이제 다음과 같이 New Relic Maven URL을 엽니다.

   allprojects {
   buildscript {
       repositories {**ARTIFACTORYREPOSITORY**
           google()
           jcenter()
           mavenCentral()
       }
   }

   카피

2. 프로젝트 수준 baseProjectTemplate.gradle 파일에 New Relic classpath 을 추가합니다. 일반적으로 이 파일은 Unity 프로젝트의 Android 폴더에서 찾을 수 있습니다.

   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**
   }

   카피

3. launcherTemplate.gradle 파일 상단에 newrelic 플러그인을 적용합니다. 이 파일은 일반적으로 Unity 프로젝트의 Android 폴더에 있습니다.

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

   카피

4. AndroidManifest.xml 파일에 INTERNET 및 ACCESS_NETWORK_STATE 권한을 추가합니다.

   <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 [iOS 리졸버 를] 클릭합니다.

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에서 데이터를 보기 시작해야 합니다.