변경 로그¶
0.4.3 (2026/10/30)¶
- 호환 버전 업그레이드: iOS
GuanceSDK 1.6.8, Androidft-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을 추가했습니다. 빌드 시점의 인터랙션 수집과 가독성 있는 RUMaction_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
addResourcebridge가 누락되는 문제를 수정했습니다.
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)¶
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 캐시 제한 크기를 설정할 수 있습니다. - 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 호환 문제를 수정했습니다.