更新履歴¶
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、および iOSGuanceSDK1.6.9に対応しました。iOS の最低バージョンを 15.0 に変更しました。 - iOS で Swift Package Manager による導入を新たにサポートし、CocoaPods による導入方式も引き続き利用できます。
- RUM
sessionSamplingRate、sessionOnErrorSamplingRate、LoglogSamplingRate、TracetraceSamplingRateのパーセンテージサンプリング設定を追加しました。[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。 FTRUMManager().setConfig(enableTraceWebView, allowWebViewHost)を追加し、Android SDK の WebView データ収集と収集を許可する Host を設定できるようにしました。FTRUMManager().setConfig(enableNativeSwiftUIUserView)を追加し、iOS ネイティブ SwiftUI View の自動追跡をサポートしました。- Flutter LongTask のサポートを追加しました:
FTRUMManager().setConfig(enableLongTask, dartLongTaskThreshold)は Dart メイン Isolate のロングタスク検出をサポートし、FTRUMManager().addLongTask(stack, duration)は LongTask の手動送信をサポートします。 FTRUMManager().addAction(actionName, actionType)を追加し、高頻度の Action 書き込みシナリオをサポートしました。Resource、LongTask、または Error イベントとは関連付けられません。FTMobileFlutter.sdkConfig(customHttpOverrides)を追加し、HTTP 自動収集を有効にした際にカスタムHttpOverridesを渡せるようにして、アプリ独自のネットワークプロキシロジックとの競合を軽減しました。- SDK を終了する
FTMobileFlutter.shutDown()を追加しました。 - 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。 FTRUMManager().setConfig(enableNativeSwiftUIUserView)を追加し、iOS ネイティブ SwiftUI View の自動追跡をサポートしました。- Flutter LongTask のサポートを追加しました:
FTRUMManager().setConfig(enableLongTask, dartLongTaskThreshold)は Dart メイン Isolate のロングタスク検出をサポートし、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、Androidft-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 の機能を統一的に使用します。
- Flutter とネイティブページの切り替え時の録画状態を調整する
FTSessionReplayManager().setCaptureActive(...)を追加しました。 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 設定を適用すると、コンポーネントが録画状態を再登録し、初期化の順序に起因してリプレイデータが存在しなくなる問題を回避します。