Swift 패키지 관리자 수동 설치

iOS 모니터링을 설정하려면 설치 안내를 사용하는 것이 좋습니다. 그러나 에이전트를 수동으로 설치해야 하는 경우 아래 단계에 따라 Swift Package Manager를 사용하여 New Relic iOS 에이전트를 설치하세요.

iOS 애플리케이션 설치

설치 프로세스의 일부로 New Relic은 자동으로 애플리케이션 토큰 을 생성합니다. 이것은 New Relic에서 모니터링하는 각 모바일 앱을 인증하기 위한 40자의 16진수 문자열입니다.

iOS/tvOS 애플리케이션을 설치 및 구성하려면:

1. one.newrelic.com

   으)로 이동합니다.

2. 해당하는 경우:

   Mobile Apps

   목록에서

   Add a new app

   선택합니다.

3. Get Started

   페이지에서 모바일 모니터링 플랫폼으로

   iOS

   선택합니다.

4. 모바일 앱의 이름을 입력한 다음

   Continue

   선택합니다.

모바일 모니터링을 위해 New Relic을 구성하는 단계를 계속 진행합니다.

Swift 패키지 관리자를 사용하여 구성

1. File > Swift Packages > Add Package Dependency... 선택합니다.

2. 패키지 파일의 Github URL을 추가합니다.

   https://github.com/newrelic/newrelic-ios-agent-spm

   카피

   팁

   패키지를 추출할 때 artifact of binary target 'NewRelic' failed extraction: The operation couldn’t be completed. (TSCBasic.StringError error 1.) 오류가 발생하면 Xcode를 닫고 Derrived Data 폴더를 삭제한 다음 Xcode를 다시 열고 다시 시도하세요.

3. NewRelic 패키지 제품을 선택하고, 바구니, 목표를 선택한 후 Finish 선택하세요.

4. AppDelegate.swift 파일에서 이 호출을 applicationDidFinishLaunchWithOptions 의 첫 번째 줄로 추가하고 APP_TOKEN 애플리케이션 토큰으로 바꿉니다. (앱이 SwiftUI로 작성된 경우 다음 지침 에 따라 AppDelegate를 프로젝트에 추가하세요.)

   NewRelic.start(withApplicationToken:"APP_TOKEN")

   카피

   중요

   적절한 계측을 보장하려면 didFinishLaunchingWithOptions() 의 첫 번째 줄에서 에이전트를 호출하고 기본 스레드에서 에이전트를 실행해야 합니다. 나중에, 백그라운드 스레드에서 또는 비동기적으로 호출을 시작하면 예기치 않거나 불안정한 동작이 발생할 수 있습니다.

5. 귀하의 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"

6. (선택 사항) 디버깅 중에 기호 업로드를 건너뛰려면 위의 빌드 스크립트에 다음 줄을 추가합니다.

   bash

   카피

   $
   if [ ${CONFIGURATION} = "Debug" ]; then
   $
       echo "Skipping DSYM upload CONFIGURATION: ${CONFIGURATION}"
   $
       exit 0
   $
   fi

7. "스크립트 실행: 종속성 분석 기반"이라는 확인란이 있으면 선택 취소되어 있는지 확인하세요.

8. 앱을 정리하고 빌드한 다음 시뮬레이터나 다른 장치에서 실행합니다.

문제점 해결

Swift 패키지를 추가할 때 다음 오류가 표시될 수 있습니다.

• 아티팩트가 체크섬과 일치하지 않습니다.
• remoteSourceControl에서 프레임워크를 다운로드할 수 없습니다.

이러한 유형의 오류가 표시되면 다음을 시도하십시오.

1. Xcode 프로젝트에서 New Relic Swift 패키지를 통합 해제합니다.

2. 터미널에서 다음 명령을 실행하여 spm 캐시를 삭제합니다.

   bash

   카피

   $
   rm -rf ~/Library/Caches/org.swift.swiftpm
   $
   rm -rf ~/Library/org.swift.swiftpm

3. Xcode를 사용하여 파생 데이터를 삭제합니다.

4. New Relic Swift 패키지를 Xcode 프로젝트에 다시 통합합니다.

(선택사항) 로깅 수준 변경

기본적으로 iOS 에이전트는 info 수준에서 로깅합니다. 로그 수준을 변경하여 더 많거나 적은 데이터를 수집할 수 있습니다. 지원되는 로그 수준은 6개입니다.

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

앱에서 로깅 수준을 변경하려면 NewRelic.start(withApplicationToken) 호출하기 전에 다음 메서드 호출을 추가하세요.

NRLogger.setLogLevels(NRLogLevelALL.rawValue)