변경 로그¶

ft_mobile_agent_flutter¶

0.5.7 (2026/07/09)¶

1. Android ft-sdk 1.7.3, Android ft-native 1.1.3, iOS FTMobileSDK 1.6.5에 대응합니다.
2. ft_session_replay_flutter를 통한 Flutter Session Replay 연동을 지원합니다.
3. 블랙리스트 필터링 기능이 추가되어 로컬 캐시에 쓰기 전에 Log 및 RUM 데이터를 필터링할 수 있습니다. 규칙은 FTMobileFlutter.sdkConfig(dataFilters: ...)를 통해 앱 내에서 구성하거나, Guance 워크스페이스의 블랙리스트에서 자동으로 가져올 수 있으며 두 방식이 동시에 적용됩니다. 이 기능은 기본적으로 활성화되어 있으며 enableDataFilter: false로 SDK 측 필터링을 비활성화할 수 있습니다. 필터 규칙은 lineDataModifier 이후에 실행됩니다.
4. 원격 구성 API가 추가되었습니다. FTMobileFlutter.sdkConfig(enableRemoteConfiguration, remoteConfigMiniUpdateInterval, remoteConfigOverrideRules), FTMobileFlutter.updateRemoteConfig(), FTMobileFlutter.updateRemoteConfigWithMiniUpdateInterval(...).
5. Android 캐시 총 크기 및 FileStore 구성이 추가되었습니다. enableLimitWithCacheSize, cacheLimit, cacheDiscard, enableFileDataStore, needTransformOldCache, fileDataStoreShadow.
6. FTRUMManager().setConfig(enableTraceWebView, allowWebViewHost)가 추가되어 Android SDK WebView 데이터 수집 및 수집이 허용된 Host를 구성할 수 있습니다.
7. FTRUMManager().setConfig(enableNativeSwiftUIUserView)가 추가되어 iOS 네이티브 SwiftUI View 자동 추적을 지원합니다.
8. Flutter LongTask 지원이 추가되었습니다. FTRUMManager().setConfig(enableLongTask, dartLongTaskThreshold)는 Dart 메인 Isolate의 긴 작업 감지를 지원하고, FTRUMManager().addLongTask(stack, duration)는 LongTask를 수동으로 보고하는 기능을 지원합니다.
9. FTRUMManager().addAction(actionName, actionType)가 추가되었습니다. 높은 빈도의 Action 쓰기 시나리오를 지원하며, Resource, LongTask 또는 Error 이벤트와 연관되지 않습니다.
10. FTMobileFlutter.sdkConfig(customHttpOverrides)가 추가되어 HTTP 자동 수집 활성화 시 사용자 정의 HttpOverrides를 전달할 수 있으며, 앱의 사용자 정의 네트워크 프록시 로직과의 충돌을 줄입니다.
11. FTMobileFlutter.shutDown()이 추가되어 SDK를 종료할 수 있습니다.
12. RUM Resource 보고에 resourceType이 보강되었고, requestSize, resourceHttpProtocol, reusedConnection, connectionReuse 등의 메트릭 필드가 추가되었습니다.
13. FTRUMManager().addError(...) 호출 시 Error 스택이 잘못 정렬될 수 있는 문제와, Android에서 FTRUMManager().startAction(...) 호출 시 속성이 유실될 수 있는 문제를 수정했습니다.

0.5.7-pre.4 (2026/07/09)¶

1. 블랙리스트 필터링 기능이 추가되어 로컬 캐시에 쓰기 전에 Log 및 RUM 데이터를 필터링할 수 있습니다. 규칙은 FTMobileFlutter.sdkConfig(dataFilters: ...)를 통해 앱 내에서 구성하거나, Guance 워크스페이스의 블랙리스트에서 자동으로 가져올 수 있으며 두 방식이 동시에 적용됩니다. 이 기능은 기본적으로 활성화되어 있으며 enableDataFilter: false로 SDK 측 필터링을 비활성화할 수 있습니다. 필터 규칙은 lineDataModifier 이후에 실행됩니다.
2. Android 캐시 총 크기 및 FileStore 구성이 추가되었습니다. enableLimitWithCacheSize, cacheLimit, cacheDiscard, enableFileDataStore, needTransformOldCache, fileDataStoreShadow.
3. FTRUMManager().setConfig(enableNativeSwiftUIUserView)가 추가되어 iOS 네이티브 SwiftUI View 자동 추적을 지원합니다.
4. Flutter LongTask 지원이 추가되었습니다. FTRUMManager().setConfig(enableLongTask, dartLongTaskThreshold)는 Dart 메인 Isolate의 긴 작업 감지를 지원하고, FTRUMManager().addLongTask(stack, duration)는 LongTask를 수동으로 보고하는 기능을 지원합니다.
5. RUM Resource 보고에 resourceType이 보강되었고, requestSize, resourceHttpProtocol, reusedConnection, connectionReuse 등의 메트릭 필드가 추가되었습니다.
6. Android Maven 저장소 주소가 mvnrepo.guance.com으로 업데이트되었습니다.

0.5.6 (2025/06/16)¶

1. FTRUMManager().setConfig(sessionOnErrorSampleRate)가 추가되어 오류 샘플링을 지원합니다. setSamplingRate에서 샘플링되지 않은 경우에도 오류 발생 시 1분 전의 RUM 데이터를 샘플링하여 수집할 수 있습니다.
2. FTMobileFlutter.sdkConfig(dataModifier, lineDataModifier)가 추가되어 데이터 쓰기 대체 및 데이터 마스킹을 지원합니다.
3. Android ft-sdk 1.6.11, iOS 1.5.16에 대응합니다.

ft_mobile_agent_flutter 더 많은 변경 로그

ft_session_replay_flutter¶

0.1.0 (2026/07/09)¶

1. FTSessionReplayManager().setConfig(FTSessionReplayConfig(...)) 및 SessionReplayCapture가 추가되어 Flutter Session Replay 데이터 수집을 지원합니다.
2. Session Replay 개인정보 보호 구성 필드가 추가되었습니다. touchPrivacy, textAndInputPrivacy, imagePrivacy.
3. FTSessionReplayConfig(enableSwiftUI)가 추가되어 iOS 네이티브 SwiftUI 세션 리플레이 녹화를 활성화할 수 있습니다.
4. Android 의존성 ft-session-replay가 0.1.6으로 업그레이드되었으며, ft-sdk:1.7.3 및 ft-native:1.1.3을 사용합니다.
5. iOS 의존성은 FTMobileSDK 1.6.5 및 FTMobileSDK/FTSessionReplay 1.6.5입니다.
6. SessionReplayCapture가 이미 마운트된 후 Session Replay 구성을 적용하면 컴포넌트가 녹화 상태를 다시 등록하여 초기화 순서 문제로 리플레이 데이터가 없는 상황을 방지합니다.

0.1.0-pre.1 (2026/07/09)¶

1. FTSessionReplayConfig(enableSwiftUI)가 추가되어 iOS 네이티브 SwiftUI 세션 리플레이 녹화를 활성화할 수 있습니다.
2. Android 의존성 ft-session-replay가 0.1.6-beta01으로 업그레이드되었으며, ft-sdk:1.7.3 및 ft-native:1.1.3을 계속 사용합니다.
3. Android Maven 저장소 주소가 mvnrepo.guance.com으로 업데이트되었습니다.

0.1.0-dev.1 (2026/07/03)¶

1. 독립적인 Flutter Session Replay 플러그인 패키지 ft_session_replay_flutter가 추가되었습니다. 이제 Session Replay는 ft_mobile_agent_flutter에서 더 이상 제공되지 않습니다.
2. 새 패키지는 FTSessionReplayManager, FTSessionReplayConfig, SessionReplayCapture, SessionReplayPrivacy 및 터치, 텍스트 입력, 이미지 개인정보 보호 구성 열거형을 제공합니다.
3. 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입니다.
4. FTMobileFlutter.sdkConfig(...), FTRUMManager().setConfig(...), FTSessionReplayManager().setConfig(...) 순서로 초기화하고, 녹화할 Flutter 뷰 트리를 SessionReplayCapture로 감싸는 것을 권장합니다.
5. SessionReplayCapture가 이미 마운트된 후 Session Replay 구성을 적용하면 컴포넌트가 녹화 상태를 다시 등록하여 초기화 순서 문제로 리플레이 데이터가 없는 상황을 방지합니다.

ft_session_replay_flutter 더 많은 변경 로그