업데이트 로그¶

UniApp¶

0.3.0 (2026/08/20)¶

• 플러그인 구조 재구성:
  • GC-JSPlugin이 공통 JS API 및 View, Error, Resource, Action 수집기를 통합 제공
  • 새로운 GC-UniPlugin이 네이티브 플러그인을 대체하며 Android, iOS, HarmonyOS 세 플랫폼을 위한 UTS 구현 제공; 일반 uni-app은 명명된 임포트를 통해 interface가 있는 SDK API 획득
  • uni MiniApp 프로젝트는 GC-JSPlugin만 통합하며, 호스트 App이 SDK를 초기화하고 호스트 확장 제공
• HarmonyOS 지원 추가

0.2.x에서 업그레이드하려면 UniApp 0.3.0 마이그레이션 가이드에 따라 플러그인 구조 마이그레이션을 완료하세요.

0.2.7 (2026/08/19)¶

• uni MiniApp iOS 호스트 App 업그레이드 주의사항: 0.2.7의 GC_UniPlugin_App.xcframework가 의존하는 iOS Native SDK 패키지명이 FTMobileSDK에서 GuanceSDK로 변경됨. 0.2.6 이하 버전에서 업그레이드할 때는 GC_UniPlugin_App.xcframework와 iOS Native SDK 1.6.7을 모두 업데이트해야 하며, 하나만 업데이트할 수 없음
• iOS 1.6.7, Android ft-sdk 1.7.5, ft-plugin 1.3.8 및 ft-native 1.1.3 지원, iOS 최소 지원 버전이 12.0으로 조정됨
• GCUniPlugin-MobileAgent
  • 새로운 setDatakitURL, setDatawayURL 추가: 보고 주소가 구성되지 않은 상태에서 SDK 초기화를 지원하며, 이후 동적으로 Datakit 또는 DataWay 주소 설정 가능
  • 새로운 remoteConfiguration, remoteConfigMiniUpdateInterval, updateRemoteConfigWithMiniUpdateInterval 추가: 원격 조건부 구성 기능 활성화
  • 새로운 enableDataFilter 및 dataFilters 추가: SDK 측 DataFilter 활성화 및 로컬 블랙리스트 규칙 구성
  • Android에서 ft-plugin을 사용하지 않고 offlinePackage가 false일 때 수동 콜드 스타트 시간 및 타임스탬프 수집이 부정확한 문제 수정
• GCUniPlugin-RUM
  • enableTraceWebView 및 allowWebViewHost WebView RUM 구성 호환성 유지
• GC-JSPlugin
  • 새로운 gcResourceTracking 추가: 표준 uni.request에 자동으로 Trace 헤더를 주입하고 RUM Resource 수집; gcRequest는 폐기된 호환 API로 유지
  • gcViewTracking 페이지 생명주기 수집 최적화: 페이지 인스턴스별 상태 유지 지원, onLoad부터 onReady까지의 로드 시간 정확히 계산, 실패한 라우트 정리 및 전경/배경 전환 중 중복 수집 방지

0.2.6 (2026/01/05)¶

• GCUniPlugin-RUM
  • enableTraceWebView, allowWebViewHost를 통해 WebView 수집 규칙 구성 지원
• GC-JSPlugin
  • GCErrorTracking: Vue2 환경의 오류 데이터 수집 기능 지원

0.2.5 (2025/10/31)¶

• GC-JSPlugin
  • RUM View에 view_url_query 필드 추가
  • 새로운 GCViewTracking.js 추가: gcViewTracking.startTracking() 메서드를 통해 RUM Views 자동 수집 활성화 지원

0.2.4 (2025/09/12)¶

• GCUniPlugin-MobileAgent
  • appendBridgeContext 메서드를 통해 컨텍스트를 추가하여 데이터 소스 구분 또는 특정 시나리오 표시 지원
• GC-JSPlugin
  • 새로운 GC-JSPlugin 플러그인 추가: RUM 관련 데이터를 자동 수집하는 js 파일을 플러그인 형태로 재구성
  • GCErrorTracking.js 추가: 오류 정보 자동 수집 지원
• iOS 1.5.17, 1.5.18, Android ft-sdk 1.6.12, 1.6.13, 1.6.14 지원

0.2.3 (2025/07/18)¶

• iOS에서 RUM enableNativeUserAction, enableNativeUserView, enableNativeUserResource, Log enableLinkRumData, enableCustomLog, Trace enableAutoTrace 파라미터에 false를 할당해도 적용되지 않는 문제 수정

0.2.2 (2025/06/25)¶

• GCUniPlugin-MobileAgent
  • dataModifier, lineDataModifier를 통한 데이터 쓰기 치환 지원, 데이터 마스킹 지원
• GCUniPlugin-RUM
  • sessionOnErrorSampleRate를 통한 오류 샘플링 지원: samplerate에 샘플링되지 않은 경우 오류 발생 시 1분 전 RUM 데이터를 샘플링하여 수집 가능
• iOS에서 RUM Resource 자동 수집 활성화 시 dcloud 내부 요청을 필터링하는 메서드 추가, 중복 데이터 감소
• iOS 1.5.15, 1.5.16, Android ft-sdk 1.6.10, 1.6.11 지원

0.2.1 (2025/03/18)¶

• Android: offlinePackage가 false일 때 잘못된 시작 시간 규칙 수정
• Android: 순수 uni-app 프로젝트에서 compressIntakeRequests 활성화 시 크래시 발생 문제 수정
• GCUniPlugin-MobileAgent enableDataIntegerCompatible 기본 활성화
• iOS 1.5.10, 1.5.11, 1.5.12, 1.5.13, 1.5.14, Android ft-sdk 1.6.8, 1.6.9 지원

0.2.0 (2025/01/19)¶

• iOS 1.5.9 지원
• Android ft-sdk 1.6.7, ft-native:1.1.1, ft-plugin-legacy 1.1.8
• Open Dataway 직접 전송 지원
• uni MiniApp과 네이티브 App 혼합 개발 지원
• GCUniPlugin-MobileAgent
  • autoSync = false, flushSyncData()를 통해 데이터 동기화 시점 자체 관리 지원, 기본값은 자동 동기화
  • syncPageSize, syncSleepTime을 통해 데이터 동기화 페이지 크기 및 동기화 간격 시간 설정 지원
  • compressIntakeRequests를 통해 동기화 데이터에 대한 deflate 압축 구성 지원
  • enableLimitWithDbSize = true, dbCacheLimit을 통해 데이터 동기화 캐시 제한 활성화 지원, dbDiscardStrategy를 사용하여 캐시 상한 초과 시 데이터 폐기 전략 설정 지원. 설정 시 rumCacheLimitCount 및 logCacheLimitCount 설정은 효과 상실
• GCUniPlugin-RUM
  • enableTrackNativeCrash를 통해 Native Crash 모니터링 활성화 지원
  • enableTrackNativeAppANR을 통해 Native ANR 모니터링 활성화 지원
  • enableTrackNativeFreeze를 통해 Native Freeze 모니터링 활성화 지원, nativeFreezeDurationMs를 통해 모니터링 임계값 범위 설정
  • rumCacheLimitCount, rumDiscardStrategy를 통해 RUM 데이터 캐시 항목 수 상한 제한 지원, 기본값 100,000
• GCUniPlugin-Logger
  • logCacheLimitCount를 통해 RUM 데이터 캐시 항목 수 상한 제한 지원, 기본값 5000

UniApp 추가 로그

Uni MiniApp¶

2.2.21 (2026/08/20)¶

• @cloudcare/rum-uniapp
  • 페이지 첫 렌더링, FP, FCP, LCP, Ready 상태, 페이지 종료 이유 및 setData 세그먼트 시간 등 성능 필드 추가
  • 새로운 performance_supported, first_render_supported 기능 필드 추가: 플랫폼별 실제 지원 여부에 따라 커버리지 및 화이트 스크린 후보 계산 용이
  • 새로운 launch_attempt 시작 시도 이벤트 추가: 네이티브 시작 성능 항목의 커버리지 분모로 사용
  • route, pageId 및 최신 navigationStart에 따라 성능 항목을 귀속시켜 빠른 페이지 전환, 동일 라우트 재구성 및 지연 콜백으로 인한 페이지 간 오염 방지
  • 네트워크 유형 작성 필드 불일치 문제 수정

2.2.20 (2026/08/11)¶

• @cloudcare/rum-uniapp
  • 새로운 allowTraceHeaderWithoutSession 구성 추가, 기본값은 false; 활성화 후 현재 Session이 RUM 샘플링에 포함되지 않아도 allowedTracingOrigins에 해당하는 요청에는 Trace 헤더가 주입되지만, 이로 인해 해당 Session의 RUM 데이터가 강제 샘플링되거나 보고되지는 않음