변경 로그
ft_mobile_agent_flutter
0.5.8 (2026/11/15)
- Android
ft-sdk:1.7.6, ft-native:1.1.4, ft-plugin:1.3.8 및 iOS GuanceSDK1.6.9에 대응합니다. iOS 최소 버전이 15.0으로 조정되었습니다.
- iOS에 Swift Package Manager 연동 지원이 추가되었으며, CocoaPods 연동 방식도 유지됩니다.
- RUM
sessionSamplingRate, sessionOnErrorSamplingRate, Log logSamplingRate 및 Trace traceSamplingRate 백분율 샘플링 구성이 추가되었습니다. [0,100] 범위의 소수와 명시적 0을 지원하며, 새 필드가 기존 확률 필드보다 우선 적용되고 기존 필드는 계속 호환됩니다.
- 원격 구성 로컬 재정의 규칙에 위 백분율 필드,
sessionReplaySamplingRate, sessionReplayOnErrorSamplingRate 및 logEnableWebViewLog가 추가되었습니다.
- 기본 구성
FTMobileFlutter.sdkConfig(allowWebViewHost: ...)와 로그 구성 FTLogger().logConfig(enableWebViewLog: ...)가 추가되어 WebView RUM 및 Log Host를 통합 관리합니다. 기존 RUM Host 구성은 호환성을 유지합니다.
- 보고 주소를 설정하지 않고 SDK를 초기화한 후,
setDatakitURL 또는 setDatawayURL을 통해 주소를 보완할 수 있습니다.
- 현재 View 로딩 소요 시간을 갱신하는
FTRUMManager().updateViewLoadingTime(duration)이 추가되었습니다. 단위는 나노초입니다.
- Dart WebSocket 연결 핸드셰이크를 수집하는
enableWebSocketResource와 FTWebSocket.connect(...)가 추가되었습니다. 네이티브 Resource 자동 수집은 네이티브 SDK가 모니터링할 수 있는 WebSocket 핸드셰이크를 지원하며, 메시지 프레임은 수집하지 않습니다.
- 연속 라우팅 및 포그라운드/백그라운드 전환 시 자동 View 연관성을 최적화하여, 비동기 응답으로 인해 다른 View가 잘못 종료되는 문제를 방지합니다.
- iOS 네이티브 View 자동 로딩 소요 시간 구성
enableNativeUserViewLoadingTime, nativeViewLoadingTimeClassNameExcludes가 추가되었습니다. 로딩 소요 시간 수집을 비활성화하거나 제외해도 View 추적에는 영향을 주지 않습니다.
- iOS
FTRUMManager().setConfig(launchPrewarmInterval: ...)가 추가되어 시작 예열 소요 시간 추정 임계값을 밀리초 단위로 설정합니다. 초기 예열 감지 메서드는 여전히 네이티브 측에서 호출됩니다.
- RUM View에
network_settled_time 메트릭이 추가되었습니다.
FTMobileFlutter.shutDown()은 선택적 Flutter Session Replay 정리가 완료될 때까지 대기한 후 네이티브 SDK를 종료하며, 이후 명시적으로 다시 초기화할 수 있습니다.
0.5.7 (2026/07/09)
- Android ft-sdk 1.7.3, Android ft-native 1.1.3, iOS FTMobileSDK 1.6.5에 대응합니다.
ft_session_replay_flutter를 통해 Flutter Session Replay를 연동할 수 있습니다.
- 블랙리스트 필터링 기능이 추가되어 로컬 캐시에 기록되기 전에 Log와 RUM 데이터를 필터링할 수 있습니다. 규칙은
FTMobileFlutter.sdkConfig(dataFilters: ...)를 통해 앱 내에서 구성할 수도 있고, Guance 워크스페이스의 블랙리스트에서 자동으로 가져올 수도 있으며, 두 방식이 동시에 적용됩니다. 이 기능은 기본적으로 활성화되며 enableDataFilter: false로 SDK 측 필터링을 비활성화할 수 있습니다. 필터링 규칙은 lineDataModifier 이후에 실행됩니다.
- 원격 구성 API
FTMobileFlutter.sdkConfig(enableRemoteConfiguration, remoteConfigMiniUpdateInterval, remoteConfigOverrideRules), FTMobileFlutter.updateRemoteConfig() 및 FTMobileFlutter.updateRemoteConfigWithMiniUpdateInterval(...)가 추가되었습니다.
- Android 캐시 총 크기 및 FileStore 구성
enableLimitWithCacheSize, cacheLimit, cacheDiscard, enableFileDataStore, needTransformOldCache, fileDataStoreShadow가 추가되었습니다.
- Android SDK WebView 데이터 수집 및 수집을 허용할 Host를 구성할 수 있는
FTRUMManager().setConfig(enableTraceWebView, allowWebViewHost)가 추가되었습니다.
- iOS 네이티브 SwiftUI View 자동 추적을 지원하는
FTRUMManager().setConfig(enableNativeSwiftUIUserView)가 추가되었습니다.
- Flutter LongTask 지원이 추가되었습니다.
FTRUMManager().setConfig(enableLongTask, dartLongTaskThreshold)는 Dart 메인 Isolate의 LongTask 감지를 지원하고, FTRUMManager().addLongTask(stack, duration)는 LongTask 수동 보고를 지원합니다.
FTRUMManager().addAction(actionName, actionType)가 추가되어 고빈도 Action 기록 시나리오를 지원하며, Resource, LongTask 또는 Error 이벤트와 연관되지 않습니다.
FTMobileFlutter.sdkConfig(customHttpOverrides)가 추가되어 HTTP 자동 수집 활성화 시 사용자 정의 HttpOverrides를 전달할 수 있으며, 앱의 사용자 정의 네트워크 프록시 로직과의 충돌을 줄입니다.
FTMobileFlutter.shutDown()이 추가되어 SDK를 종료할 수 있습니다.
- RUM Resource 보고에
resourceType이 보완되었으며, requestSize, resourceHttpProtocol, reusedConnection, connectionReuse 등의 메트릭 필드가 추가되었습니다.
FTRUMManager().addError(...) 호출 시 Error 스택이 어긋날 수 있는 문제와, Android에서 FTRUMManager().startAction(...) 호출 시 속성이 유실될 수 있는 문제를 수정했습니다.
0.5.7-pre.4 (2026/07/09)
- 블랙리스트 필터링 기능이 추가되어 로컬 캐시에 기록되기 전에 Log와 RUM 데이터를 필터링할 수 있습니다. 규칙은
FTMobileFlutter.sdkConfig(dataFilters: ...)를 통해 앱 내에서 구성할 수도 있고, Guance 워크스페이스의 블랙리스트에서 자동으로 가져올 수도 있으며, 두 방식이 동시에 적용됩니다. 이 기능은 기본적으로 활성화되며 enableDataFilter: false로 SDK 측 필터링을 비활성화할 수 있습니다. 필터링 규칙은 lineDataModifier 이후에 실행됩니다.
- Android 캐시 총 크기 및 FileStore 구성
enableLimitWithCacheSize, cacheLimit, cacheDiscard, enableFileDataStore, needTransformOldCache, fileDataStoreShadow가 추가되었습니다.
- iOS 네이티브 SwiftUI View 자동 추적을 지원하는
FTRUMManager().setConfig(enableNativeSwiftUIUserView)가 추가되었습니다.
- Flutter LongTask 지원이 추가되었습니다.
FTRUMManager().setConfig(enableLongTask, dartLongTaskThreshold)는 Dart 메인 Isolate의 LongTask 감지를 지원하고, FTRUMManager().addLongTask(stack, duration)는 LongTask 수동 보고를 지원합니다.
- RUM Resource 보고에
resourceType이 보완되었으며, requestSize, resourceHttpProtocol, reusedConnection, connectionReuse 등의 메트릭 필드가 추가되었습니다.
- Android Maven 저장소 주소가
mvnrepo.guance.com으로 업데이트되었습니다.
0.5.6 (2025/06/16)
FTRUMManager().setConfig(sessionOnErrorSampleRate)가 추가되어 오류 샘플링을 지원합니다. setSamplingRate로 샘플링되지 않은 경우에도 오류 발생 시 1분 전 RUM 데이터를 샘플링하여 수집할 수 있습니다.
FTMobileFlutter.sdkConfig(dataModifier, lineDataModifier)가 추가되어 데이터 기록 치환 및 데이터 마스킹을 지원합니다.
- Android ft-sdk 1.6.11, iOS 1.5.16에 대응합니다.
ft_mobile_agent_flutter 추가 로그
ft_session_replay_flutter
0.1.1 (2026/11/15)
- iOS
GuanceSDK1.6.9와 GuanceSDK/SessionReplay 1.6.9, Android ft-session-replay:0.1.9, ft-sdk:1.7.6 및 ft-native:1.1.4에 대응합니다. iOS 최소 버전이 15.0으로 조정되었습니다.
- iOS에 Swift Package Manager 연동 지원이 추가되었으며, CocoaPods 연동 방식도 유지됩니다.
sessionReplaySamplingRate, sessionReplayOnErrorSamplingRate 백분율 샘플링 구성이 추가되었습니다. 소수와 명시적 0을 지원하며, 새 필드가 기존 확률 필드보다 우선 적용되고 기존 필드는 계속 호환됩니다.
- Replay의 샘플링, RUM 연관, 캐시, 이미지 리소스 및 업로드는 모두 네이티브 SDK 기능을 사용합니다.
FTSessionReplayManager().setCaptureActive(...)가 추가되어 Flutter와 네이티브 페이지 전환 시 녹화 상태를 조정합니다.
enableLinkRUMKeys는 재생 데이터, 이미지 리소스 존재 여부 확인, 업로드 및 백엔드 라우팅에 모두 사용됩니다.
- Core SDK 0.5.8과 함께
FTMobileFlutter.shutDown()을 통해 Dart Replay를 통합 정리하며, 종료 후 명시적으로 다시 초기화할 수 있습니다.
- iOS Replay 데이터 기록 이상으로 세션에 재생 표시가 나타나지만 재생이 불가능한 문제를 수정했습니다.
0.1.0 (2026/07/09)
FTSessionReplayManager().setConfig(FTSessionReplayConfig(...))와 SessionReplayCapture가 추가되어 Flutter Session Replay 데이터 수집을 지원합니다.
- Session Replay 프라이버시 구성 필드
touchPrivacy, textAndInputPrivacy, imagePrivacy가 추가되었습니다.
FTSessionReplayConfig(enableSwiftUI)가 추가되어 iOS 네이티브 SwiftUI 세션 리플레이 녹화를 활성화할 수 있습니다.
- Android는
ft-session-replay를 0.1.6으로 업그레이드하고 ft-sdk:1.7.3과 ft-native:1.1.3을 사용합니다.
- iOS는
FTMobileSDK 1.6.5와 FTMobileSDK/FTSessionReplay 1.6.5에 의존합니다.
SessionReplayCapture가 마운트된 후 Session Replay 구성을 적용하면 컴포넌트가 녹화 상태를 다시 등록하여 초기화 순서로 인해 재생 데이터가 없는 문제를 방지합니다.
0.1.0-pre.1 (2026/07/09)
FTSessionReplayConfig(enableSwiftUI)가 추가되어 iOS 네이티브 SwiftUI 세션 리플레이 녹화를 활성화할 수 있습니다.
- Android는
ft-session-replay를 0.1.6-beta01로 업그레이드하고 ft-sdk:1.7.3과 ft-native:1.1.3을 계속 사용합니다.
- Android Maven 저장소 주소가
mvnrepo.guance.com으로 업데이트되었습니다.
0.1.0-dev.1 (2026/07/03)
- 독립 Flutter Session Replay 플러그인 패키지
ft_session_replay_flutter가 추가되어 Session Replay는 더 이상 ft_mobile_agent_flutter에서 제공하지 않습니다.
- 새 패키지는
FTSessionReplayManager, FTSessionReplayConfig, SessionReplayCapture, SessionReplayPrivacy 및 터치, 텍스트 입력, 이미지 프라이버시 구성 열거형을 제공합니다.
- Android는
ft-session-replay:0.1.6-alpha02, ft-sdk:1.7.3 및 ft-native:1.1.3에 의존하며, iOS는 FTMobileSDK 1.6.5와 FTMobileSDK/FTSessionReplay 1.6.5에 의존합니다.
FTMobileFlutter.sdkConfig(...), FTRUMManager().setConfig(...), FTSessionReplayManager().setConfig(...) 순서로 초기화하고, 녹화가 필요한 Flutter 뷰 트리를 SessionReplayCapture로 감싸는 것을 권장합니다.
SessionReplayCapture가 마운트된 후 Session Replay 구성을 적용하면 컴포넌트가 녹화 상태를 다시 등록하여 초기화 순서로 인해 재생 데이터가 없는 문제를 방지합니다.
ft_session_replay_flutter 추가 로그