콘텐츠로 이동

변경 로그


0.4.3 (2026/10/30)

  • 호환 버전 업그레이드: iOS GuanceSDK 1.6.8, Android ft-sdk 1.7.6, ft-plugin 1.3.8, ft-session-replay 0.1.9 및 ft-native 1.1.4
  • 통합 백분율 샘플링 설정(0–100)을 추가했습니다. 소수를 지원하며 RUM, Log, Trace, Session Replay 및 원격 설정에 적용됩니다. 기존 확률 설정(0–1)과 호환되며, 동시에 설정된 경우 새 필드를 우선 사용합니다.
  • FTRUMConfig.visitorIdConfig 및 FTMobileReactNative.resetVisitorId()를 추가했습니다. 일치하는 HTTP(S) 요청에 익명 Visitor ID를 주입하고 유효 기간과 재설정 식별자를 설정할 수 있으며, WebSocket 요청은 포함되지 않습니다.

  • 선택적 내비게이션 플러그인 @cloudcare/mobile-react-navigation 및 @cloudcare/mobile-react-native-navigation을 추가했습니다. RUM View 자동 수집을 지원하고 포그라운드/백그라운드 생명주기에 대응합니다.

  • 페이지 로딩 소요 시간 수집을 최적화하고 내비게이션 예시의 나노초 단위 변환을 수정했습니다. FTReactNativeRUM.updateViewLoadingTime(duration)을 추가하여 현재 View의 로딩 소요 시간을 나노초 단위로 업데이트할 수 있습니다.

  • iOS WebSocket 핸드셰이크 Resource 수집을 추가했습니다. FTRUMConfig.enableIOSWebSocketResource로 독립적으로 활성화하며 기본값은 비활성화입니다. 수집 시작/종료 시간으로 핸드셰이크 소요 시간을 계산하여 네이티브 브리지 처리 지연의 영향을 방지합니다. Android는 계속 enableNativeUserResource로 네이티브 자동 수집을 제어합니다.
  • 개발 환경 Resource 필터링을 최적화하여 Metro, Inspector, HMR 및 디버거 WebSocket 요청을 제외합니다.

  • 선택적 @cloudcare/react-native-mobile-babel-plugin을 추가했습니다. 빌드 시점의 인터랙션 수집과 가독성 있는 RUM action_name을 지원합니다.

  • FTRUMConfig.enableLongTask 및 FTRUMConfig.longTaskThresholdMs를 추가했습니다. React Native JS 스레드의 LongTask를 수집하고 모니터링 임계값을 설정할 수 있습니다.

  • FTLogConfig.enableWebViewLog를 추가했습니다. WebView 내 Browser Logs SDK의 로그를 수집할 수 있으며, 원격 필드 logEnableWebViewLog로 제어할 수 있습니다.
  • FTMobileConfig.allowWebViewHost를 추가했습니다. WebView RUM 및 로그의 host 허용 목록을 통합 설정하며, 기존 RUM 설정 진입점과 호환됩니다.
  • 업로드 주소를 설정하지 않고 SDK를 초기화할 수 있으며, 초기화 후 업로드 주소를 동적으로 설정할 수 있습니다.
  • React Native 새 아키텍처에서 iOS와 Android의 원격 설정 업데이트 및 콜백 문제를 수정했습니다.

0.4.2 (2026/06/26)

  • 블랙리스트 필터링 기능을 추가했습니다. 로컬 캐시 쓰기 전에 Log 및 RUM 데이터를 필터링할 수 있습니다. 규칙은 FTMobileConfig.dataFilters로 앱 내에서 설정할 수 있으며, Guance 워크스페이스의 블랙리스트에서 자동으로 가져올 수도 있고 두 방식이 동시에 적용됩니다. 이 기능은 기본적으로 활성화되어 있으며 enableDataFilter: false로 SDK 측 필터링을 비활성화할 수 있습니다. 필터링 규칙은 lineDataModifier 이후에 실행됩니다.
  • 호환 버전 업그레이드: iOS SDK 1.6.5, Android ft-sdk 1.7.2 및 Android ft-session-replay 0.1.5
  • Android Java 8 컴파일 호환성 문제를 수정했습니다.
  • Android 구 아키텍처에서 RUM addResource bridge가 누락되는 문제를 수정했습니다.

0.4.1 (2026/04/22)

  • Session Replay 세션 리플레이 기능을 추가했으며, @cloudcare/react-native-session-replay 패키지로 분리되어 별도로 설치하여 사용할 수 있습니다.

  • Session Replay 오류 샘플링 기능을 추가했으며, 원격 설정을 통해 Session Replay를 동적으로 제어할 수 있습니다.

  • Session Replay는 touchPrivacy, textAndInputPrivacy, imagePrivacy를 통해 터치, 텍스트 및 입력, 이미지의 프라이버시 설정을 구성할 수 있습니다. 또한 네이티브 컴포넌트 FTSessionReplayView를 추가하여 세션 리플레이 녹화 과정에서 React Native 화면 내 민감 영역을 표시하고 프라이버시를 보호할 수 있습니다.
  • React Native 새 아키텍처에 대한 지원을 추가하여 최신 React Native 앱 설정과의 호환성을 향상했습니다.
  • FTMobileReactNative.setDatakitURL 및 FTMobileReactNative.setDatawayURL을 통해 데이터 업로드 주소를 동적으로 업데이트할 수 있습니다.
  • 호환 버전 업그레이드: Android ft-sdk 1.7.0, Android ft-session-replay 0.1.3 및 iOS SDK 1.6.2

0.3.16 (2026/03/26)

  • Android ft-sdk 1.6.17, iOS SDK 1.5.20 호환을 적용했습니다.
  • WebView 수집 규칙 설정을 지원하기 위해 FTRUMConfig.enableTraceWebView, FTRUMConfig.allowWebViewHost 설정 항목을 추가했습니다.
  • FTMobileConfig에 remoteConfiguration, remoteConfigMiniUpdateInterval 및 remoteConfigOverrideRules를 추가하여 원격 설정, 업데이트 간격 제어 및 설정 재정의 규칙을 지원합니다.
  • FTRUMConfig.iosCrashMonitoringType을 통해 iOS 크래시 모니터링 유형을 설정할 수 있도록 지원합니다.
  • FTMobileReactNative.appendBridgeContext 메서드로 컨텍스트를 추가하여 데이터 소스를 구분하거나 특정 시나리오를 표시할 수 있습니다.

0.3.15 (2025/08/12)

  • Android ft-sdk 1.6.13, ft-native 1.1.2 호환을 적용했습니다.
  • iOS SDK 1.5.18 호환을 적용했습니다.

0.3.14 (2025/05/16)

  • FTRUMConfig.sessionErrorSampleRate를 추가하여 오류 샘플링을 지원합니다. sampleRate로 샘플링되지 않은 경우 오류 발생 시 1분 전 RUM 데이터를 샘플링하여 수집할 수 있습니다.
  • FTMobileConfig.lineDataModifier, FTMobileConfig.dataModifier를 추가하여 데이터 쓰기 대체와 데이터 마스킹을 지원합니다.
  • Android ft-sdk 1.6.10, 1.6.11, iOS 1.5.15, 1.5.16 호환을 적용했습니다.

0.3.13 (2025/03/21)

  • Android Java 8 호환성을 조정하고 kotlin 라이브러리 의존성을 제거했습니다.

0.3.12 (2025/03/07)

  • RUM Resource 데이터 필드 resource_first_byte_time, resource_dns_time, resource_download_time, resource_connect_time, resource_ssl_time, resource_redirect_time을 추가하여 Guance에서 Resource 소요 시간을 강화 표시하고, 「애플리케이션 성능 모니터링(APM)」 플레임 그래프에서 시간 축 정렬을 지원합니다.
  • FTMobileConfig.enableDataIntegerCompatible 기본 활성화
  • Android ft-sdk 1.6.9, iOS 1.5.12, 1.5.13, 1.5.14 호환을 적용했습니다.

0.3.11 (2025/02/05)

  • 네이티브와 React Native 하이브리드 개발 SDK 설정을 최적화했습니다.
    • FTRumActionTracking.startTracking() 메서드로 React Native 컨트롤 클릭 이벤트를 자동 수집하고, FTRumErrorTracking.startTracking() 메서드로 React Native 오류 로그를 자동 수집할 수 있습니다.
    • RUM Resource 자동 수집 활성화 시, iOS 측 FTReactNativeUtils.filterBlackResource(url), Android 측 ReactNativeUtils.isReactNativeDevUrl(url) 메서드를 추가하여 개발 환경의 React Native 심볼화 요청 및 Expo 로그 요청을 필터링하고 중복 데이터를 줄입니다.
  • iOS SDK 1.5.11 호환을 적용했습니다.

0.3.10 (2025/01/21)

  • iOS bridge 코드에서 native SDK 헤더 파일을 참조하는 방식을 수정했습니다.

  • RUM 항목 수 제한 기능을 추가했습니다. FTRUMConfig.rumCacheLimitCount로 SDK의 최대 캐시 항목 수를 제한할 수 있으며, FTRUMConfig.rumDiscardStrategy 설정으로 새 데이터를 버릴지 오래된 데이터를 버릴지 지정할 수 있습니다.

  • FTMobileConfig.enableLimitWithDbSize로 전체 캐시 크기를 제한하는 기능을 추가했습니다. 활성화하면 FTLogConfig.logCacheLimitCount 및 FTRUMConfig.rumCacheLimitCount가失效하며, FTMobileConfig.dbDiscardStrategy로 db 폐기 정책을 설정할 수 있고 FTMobileConfig.dbCacheLimit로 db 캐시 제한 크기를 설정할 수 있습니다.

  • iOS SDK 1.5.8, 1.5.9, 1.5.10 호환을 적용했습니다.

  • Android SDK ft-sdk 1.6.6, 1.6.7, 1.6.8 호환을 적용했습니다.

0.3.9 (2024/12/24)

  • React Android 호환성 향상을 위해 Android React Native Bridge 일부를 Kotlin 언어에서 Java로 변경했습니다.
  • Android SDK ft-sdk 1.6.5 호환을 적용했습니다.

0.3.7 (2024/12/04)

  • Android RN 오류 데이터 유형 표기 오류 문제를 수정했습니다.
  • FTRUMConfig.nativeFreezeDurationMs로 지연(Freeze) 감지 임계값을 설정할 수 있습니다.
  • FTMobileConfig.compressIntakeRequests를 사용하여 동기화 데이터에 deflate 압축을 설정할 수 있습니다.
  • iOS SDK 1.5.6, 1.5.7 호환을 적용했습니다.
  • Android SDK ft-sdk 1.6.2, 1.6.3, 1.6.4 호환을 적용했습니다.

0.3.6 (2024/11/06)

  • iOS SDK 1.5.5 호환을 적용했습니다.

0.3.5 (2024/10/23)

  • Native Error, ANR, Freeze 수집을 지원합니다.
  • react-native에서 error를 자동 수집할 때의 기본 오류 유형을 수정했습니다.
  • onPress 속성을 가진 컴포넌트에 대해, enableAutoTrackUserAction 활성화 후 사용자 정의 속성 ft-enable-track을 추가하여 해당 컴포넌트의 클릭 이벤트 수집 여부를 정의하고, ft-extra-property를 통해 Action 추가 속성을 지정할 수 있도록 지원합니다.

0.3.4 (2024/10/19)

  • globalContext 속성을 전역에서 동적으로 추가할 수 있습니다.
  • FTReactNativeRUM.addErrorWithType()으로 오류 유형을 사용자 정의할 수 있습니다.
  • FTMobileReactNative.shutDown()으로 SDK를 종료할 수 있습니다.
  • FTMobileReactNative.clearAllData()로 미보고 캐시 데이터를 정리할 수 있습니다.
  • react-native Error 자동 수집 시 stack과 message 파라미터가 반대로 할당되는 문제를 수정했습니다.
  • Android SDK ft-sdk 1.6.1 호환을 적용했습니다.
  • iOS SDK 1.5.4 호환을 적용했습니다.

0.3.3 (2024/10/09)

  • iOS SDK 1.5.3 호환을 적용했습니다.

0.3.2 (2024/08/28)

  • Android에서 FTMobileConfig.env 설정이 적용되지 않는 문제를 수정했습니다.

0.3.1 (2024/08/21)

  • React 버전이 16.14.0 미만일 때 react/jsx-runtime 사용 시 오류가 발생하는 문제를 호환 수정했습니다.
  • Android에서 react native 0.63 저버전과 호환됩니다.
  • localhost를 가리키는 URL을 필터링하는 정규식을 수정하여 매칭 범위를 확대했습니다.
  • iOS SDK 1.5.2 호환을 적용했습니다.

0.3.0 (2024/08/16)

  • 데이터 동기화 파라미터 설정을 지원합니다. 요청 항목 수, 동기화 간격 시간, 로그 캐시 항목 수를 설정할 수 있습니다.
  • RUM resource 네트워크 요청에 remote ip 주소 확인 기능을 추가했습니다.
  • 라인 프로토콜 Integer 데이터 호환 모드를 추가하여 web 데이터 유형 충돌 문제를 처리합니다.
  • 로그에 사용자 정의 status 메서드를 추가했습니다.
  • react-native action 수집 메서드를 수정하여 React 17에서 React.createElement로 클릭 이벤트를 가로챌 수 없는 문제에 대응했습니다.
  • Debug 시나리오에서 RUM Resource 수집 시 localhost를 가리키는 핫 리로드 연결을 필터링합니다.
  • Android 하위 레이어 Double 호환 문제를 수정했습니다.

추가 로그

문서 평가

이 페이지가 도움이 되었나요?