프로젝트 소개

Unity Engine SDK for Aptabase 이 패키지는 오픈소스이며 프라이버시 우선 분석 플랫폼인 Aptabase를 사용하여 Unity Engine 프로젝트를 계측합니다. 설치 Unity Package Manager에서 Window > Package Manager > Add Package from git URL을 통해 git URL https://github.com/aptabase/aptabase-unity.git을 추가하여 설치합니다. 구성 Aptabase에서 App Key를 얻은 후, Aptabase/Resources/AptabaseSettings.Asset 파일에 설정합니다. 호스트는 키에 따라 자동 선택되며, 자체 호스팅 배포의 경우 SelfHostURL 필드가 나타납니다. A-DEV-*로 prefixed된 키는 로컬 Aptabase 인스턴스인 https://localhost:3000을 대상으로 합니다. 선택적 설정으로는 앱 버전 재정의(AppVersion), 플랫폼별 빌드 번호 지정(AppBuildNumber), 이벤트 플러시 간격 조정(FlushInterval), 자동 크래시 보고 활성화(EnableCrashReporting)가 있습니다. 이벤트 추적 이벤트는 AptabaseSDK 네임스페이스 내의 Aptabase.TrackEvent() 메서드로 기록됩니다. 커스텀 속성은 문자열과 숫자만 허용됩니다. 이벤트는 프로덕션에서는 60초마다, 개발에서는 2초마다 배치되어 전송됩니다. 수동 플러시는 Aptabase.Flush()를 통해 가능합니다. SDK는 OS, 앱 버전 및 기타 메타데이터로 이벤트를 자동으로 보강합니다. 자동으로 추적되는 이벤트는 없으며, 모든 기록은 수동으로 수행해야 합니다. 오류 추적 (베타) 처리된 예외에는 Aptabase.TrackError(ex)를, 복구 불가능한 오류에는 Aptabase.TrackError(ex, fatal: true)를 사용합니다. EnableCrashReporting이 활성화된 경우 SDK는 다음과 같이 자동으로 보고합니다: - MonoBehaviour 콜백, 코루틴, Debug.LogException에서 잡힌 예외는 unhandled로 보고 - 프로세스 종료 예외는 fatal 심각도를 가진 crash로 보고 - 관측되지 않은 Task 예외는 taskException으로 보고 각 보고서는 예외 유형, 메시지, 스택 트레이스, 심각도, 캡처 방법을 포함합니다. 세션당 최대 100개의 고유 오류가 보고됩니다. 네이티브 크래시는 캡처되지 않습니다. 추가 기능 - HTTP 상태 코드를 위한 SetResponseListener()를 통한 응답 리스너 - SetEnabled()를 사용한 SDK 활성화/비활성화 - Apple App Store 개인정보 보호 폼 가이드 제공