변경 로그¶

0.1.0-alpha.5¶

새로운 기능¶

• iOS Swift Package Manager 지원: Creator 2, Creator 3 및 Hybrid 네이티브 호스트는 프로젝트 구성에서 CocoaPods 또는 SPM을 선택할 수 있으며, 기본값은 여전히 CocoaPods입니다. 설치 도구는 기존 선택을 유지하고, Creator 3의 CMake 재생성 후 SPM 참조를 복원합니다.

• 네이티브 네트워크 SDK 의존성: Android Agent를 1.7.6-alpha03으로, Hybrid 예제의 Gradle Plugin을 1.3.9-alpha01로 업그레이드하고, CocoaPods 및 SPM에서 사용하는 iOS Agent와 Session Replay를 1.6.8-alpha.5로 업그레이드했습니다. 새 버전의 iOS에서는 별도 스위치를 통해 NSURLConnection Resource 수집과 Trace 연결을 활성화할 수 있으며, 새로 추가된 두 스위치는 기본적으로 꺼져 있습니다.

• 네트워크 검증 예제: Creator 2 Android 엔진의 HTTP 요청과, 선택적으로 활성화할 수 있는 iOS NSURLConnection 요청 예제를 추가했습니다. 실제로 업로드되는 Resource를 확인하는 방법과 JS 자동 수집 또는 수동 계측이 네이티브 수집과 중복되지 않도록 하는 방법을 설명합니다.

• Creator 3 Replay 예제: 네이티브 3D 검증 시나리오를 추가하고, 카메라, 이동 및 독립 HUD 컨트롤을 제공하여 프레임 캡처 동작과 현재 단일 카메라 수집 제한을 확인할 수 있습니다.

네트워크 수집 스위치 및 중복 수집 회피 방법은 Android 네트워크 수집 권장 사항 및 iOS 네트워크 수집 권장 사항을 참조하세요. SPM 연동 단계는 iOS 네이티브 빌드를 참조하세요.

0.1.0-alpha.4¶

새로운 기능¶

• Session Replay 프라이버시 컴포넌트: Creator 2 및 Creator 3용 ReplayPrivacy 에디터 컴포넌트를 추가하여, 캡처된 리플레이 화면에서 노드와 프리팹을 마스킹하거나 숨길 수 있습니다. 설치 도구는 컴포넌트를 프로젝트 에셋 디렉터리에 복사합니다. 코드 오버라이드 규칙이 우선하며, 입력 필드는 기본적으로 계속 마스킹됩니다.

• Session Replay 프레임 캡처 성능: Android 및 iOS에서 리플레이 파일 읽기/쓰기와 네이티브 이미지 인코딩을 게임 스레드 밖으로 이동했습니다. SDK 업데이트 후 비동기 Bridge를 포함하려면 네이티브 프로젝트를 다시 빌드해야 합니다.

• Hybrid 프라이버시 예제: 유지 관리 중인 Creator 2 및 Creator 3 Hybrid 예제에 프라이버시 컴포넌트 예제와 마스크 정렬 테스트 컨트롤을 추가했습니다.

버그 수정¶

• Android Session Replay 재생: 네이티브 의존성 설치 도구의 ft-session-replay:0.1.9-alpha02를 0.1.9-alpha03으로 업그레이드하여 세그먼트 압축이 Browser SDK 형식과 일치하도록 하고, 영향을 받던 다중 세그먼트 세션 재생을 복구했습니다. Maven에 배포된 아티팩트를 사용하여 네이티브 페이지와 Cocos 페이지 간에 이전 버전, 새 버전, 다시 이전 버전 순서로 비교 검증했습니다.

0.1.0-alpha.3¶

개선 사항¶

• Android SDK 의존성: Creator 2 및 Creator 3의 네이티브 의존성 설치 도구에서 Android Agent SDK를 1.7.6-alpha01에서 1.7.6-alpha02로, Session Replay를 0.1.9-alpha01에서 0.1.9-alpha02로 업그레이드했습니다.

• Hybrid 연동 예제: 각 Creator 세대별로 최소한의 Hybrid 연동 프로젝트를 하나씩 유지합니다. 유지 관리 중인 예제에서 이전 진단 프로젝트, 복사된 SDK 설치 디렉터리 및 리플레이 트래픽 벤치마크 테스트 도구를 제거했습니다.

• SDK 및 예제 문구: 불필요한 브랜드 이름을 제거하고, SDK 오류 메시지와 예제 문구를 간소화했습니다.

버그 수정¶

• npm 배포: 배포 전에 패키지 메타데이터를 확인하여 버전이 이미 존재하는지 감지하고 배포 식별자를 검증합니다. 첫 번째 안정 버전이 배포되기 전까지 최신 프리릴리스 버전을 latest 태그로 배포합니다.

0.1.0-alpha.2¶

버그 수정¶

• Session Replay 프라이버시 마스킹: Creator 2 및 Creator 3에서 Camera 투영으로 인해 캡처된 프레임 내 컨트롤의 위치나 크기가 변경될 때 입력 필드와 사용자 정의 노드 마스크가 어긋나던 문제를 수정했습니다. 프라이버시 경계를 안정적으로 투영할 수 없는 경우 해당 프레임을 건너뛰어 마스크 위치가 올바르지 않은 화면을 수집하지 않도록 합니다.

0.1.0-alpha.1¶

커밋 2bbeeb86270b666e5eeddc6f220586df66f10362을 기준으로 배포되었습니다.

첫 번째 프리릴리스 버전으로, Android 및 iOS 네이티브 플랫폼에서 실행되는 Cocos Creator 애플리케이션에 실제 사용자 모니터링(RUM), 로그, 분산 추적 및 실험적 Session Replay를 제공합니다.

새로운 기능¶

• RUM 자동 수집 및 수동 계측: 필요에 따라 씬 전환, 터치 인터랙션, 런타임에서 지원하는 JavaScript 오류 및 처리되지 않은 Promise 거부를 수집할 수 있습니다. 주요 비즈니스 흐름을 모니터링하기 위해 View, Action, Error, Long Task 및 네트워크 Resource를 수동으로 기록할 수 있습니다. 네이티브 크래시, Android ANR, UI 끊김 및 기기 성능 모니터링을 구성할 수 있습니다.

• 로그 수집: 사용자 정의 로그 업로드와 필요에 따른 Console 출력 수집을 지원합니다. 로그 레벨 필터링, 샘플링 및 캐시 정책을 구성할 수 있으며, 현재 RUM 세션과 연결하여 사용자 행동을 바탕으로 문제를 진단할 수 있습니다.

• 네트워크 모니터링 및 트레이스 연계: 런타임에서 제공하는 fetch 및 XMLHttpRequest의 기본 요청, 응답 정보 및 총 소요 시간을 자동으로 수집하고 Trace Header를 주입합니다. 사용자 정의 네트워크 연동을 위해 수동 Resource 계측 및 Trace Header 생성을 지원합니다. DNS, TCP, SSL 단계별 소요 시간은 수동 계측이 필요합니다.

• Session Replay(실험적): Cocos 화면을 수집하고 RUM 세션에 연결합니다. 샘플링, 오류 세션 추가 샘플링, 프레임 캡처 빈도 및 이미지 크기를 구성할 수 있습니다. 노드 마스킹 및 숨김을 지원하며, 기본적으로 입력 필드를 마스킹하고 터치 위치를 숨깁니다.

• 리플레이 화질 및 트래픽 제어: 화질 프리셋, 단일 프레임 크기 제한 및 슬라이딩 윈도우 이미지 데이터 예산을 구성할 수 있습니다. 적응형 수집은 예산 사용량에 따라 프레임 캡처 빈도, 화질 및 크기를 조정하여 리플레이 디테일과 데이터 사용량 간의 균형을 맞추는 데 도움을 줍니다.

• 네이티브 호스트 Hybrid 연동: Cocos가 내장된 네이티브 애플리케이션에서 이미 초기화된 SDK를 재사용합니다. guanceSdk.attach()로 연동하고, guanceSdk.enterCocos() 및 guanceSdk.leaveCocos()를 사용하여 Cocos 수집 라이프사이클을 관리함으로써 호스트 SDK가 중복 초기화되지 않도록 합니다.

• 사용자 및 비즈니스 컨텍스트: 사용자 바인딩 및 해제, 전역 및 이벤트 레벨 사용자 정의 속성 추가를 지원하여 사용자, 환경 및 비즈니스 컨텍스트별로 모니터링 데이터를 필터링할 수 있습니다. DataKit 또는 DataWay를 통한 업로드를 지원합니다.

• 프로젝트 설치 도구: 별도의 Creator 2 및 Creator 3 진입점을 포함하는 npm 패키지, 설치 명령 및 빌드 확장을 제공하여 Android 및 iOS 네이티브 Bridge와 의존성 구성을 지원합니다.

연동 요구 사항¶

• Cocos Creator 2.4.5–2.4.15 및 3.6.3–3.8.x를 지원하며, 3.0–3.6.2는 최선 노력(best-effort)으로 지원됩니다.

• Android API 21+ 또는 iOS 12+가 필요합니다. 현재 Web, 미니 게임 및 데스크톱 타깃은 지원되지 않습니다.

• 독립 Cocos 앱은 guanceSdk.start()로 초기화합니다. Hybrid 앱은 네이티브 호스트에서 SDK를 먼저 초기화한 후 guanceSdk.attach()를 호출합니다. 두 초기화 방식은 상호 배타적입니다.

• 필요에 따라 RUM, 로그, 분산 추적, Session Replay 및 자동 수집을 구성합니다. iOS 네이티브 프로젝트를 생성한 후 pod install을 실행하여 의존성을 설치합니다.