変更履歴¶
ft-sdk¶
1.7.6 (2026/10/22)¶
- パーセントサンプリング設定インターフェース
setSessionSamplingRate、setSessionOnErrorSamplingRate、setLogSamplingRate、setTraceSamplingRateを追加しました。いずれも0–100で統一し、小数および明示的な0の設定をサポートするとともに、対応するリモート設定にも対応します。旧版の0–1インターフェースは互換性のため残しますが、非推奨としてマークします。新旧のインターフェースを同時に設定した場合は新しいインターフェースが優先され、リモート設定は引き続きローカル設定より優先されます。 - Visitor ID 機能を追加しました。
FTRUMConfig.setVisitorIdConfig(...)で必要に応じて有効化でき、カスタムリクエスト Header、URL マッチングルール、有効期間、およびFTSdk.resetVisitorId()によるリセットをサポートします。デフォルトの有効期間は 24 時間です。OkHttp の自動・手動導入に対応し、Header の注入は RUM/Trace のサンプリングとは独立して行われ、ネイティブ RUM データにvisitor_idを関連付けます。WebView の Browser RUM 3.3.16 full/slim パッケージはネイティブの Visitor ID を再利用できます。 - HTTP/HTTPS URLConnection Resource の自動収集を追加しました。
setEnableTraceUserResource(true)とsetEnableHttpURLConnectionResource(true)を同時に有効化し、ft-plugin >= 1.3.9を使用してURL.openConnection()/openConnection(Proxy)にインストルメンテーションを適用する必要があります。リクエストの総所要時間、観測可能な送受信バイト数、エラー収集、および Trace 設定に基づくリンク情報の伝播をサポートします。リクエスト本文とレスポンス本文は収集せず、観測できないネットワークフェーズの所要時間はレポートしません。 - ネイティブ View メトリクス
network_settled_timeとinteraction_to_next_view_timeを追加しました。単位はナノ秒で、それぞれ初期リソースの完了所要時間と、前のページのインタラクションから現在のページ開始までの所要時間を計測します。デフォルトの初期リソース範囲は、開始時刻が View の開始から 100 ms 未満の Resource であり、インタラクション間隔は 0 より大きく 3 秒未満である必要があります。ページ終了時に初期リソースの所要時間結果が確定します。 FTRUMConfig.setInitialResourceIdentifier(...)とsetLastInteractionIdentifier(...)を追加し、ページ所要時間の計算ルールをカスタマイズできるようにしました。組み込みの時間ポリシーはミリ秒単位で閾値を設定できます。設定は RUM の初期化時に反映され、常にfalseを返す初期リソースルールを渡すとnetwork_settled_timeを無効化でき、インタラクションルールをnullにするとinteraction_to_next_view_timeを無効化できます。- View、Resource、LongTask にイベント発生区間に基づく
app_stateを追加し、ネイティブ RUM イベントにsession_start_reasonを追加しました。遅延して完了したリクエスト、キャッシュデータ、および過去の ANR に対して、所属セッションの起動理由を保持できます。この情報を持たない古いキャッシュはunknownを使用します。 - フレームワーク統合向けに
startView(viewName, property, ViewTrackingType)、stopView(viewId, property)、onCreateView(viewName, loadTime, loadStartTime)を追加しました。自動 View とそのアクティブな Action はバックグラウンド移行時に同期的に終了し、置き換えられたページの遅延停止コールバックは無視され、ページの読み込み開始時刻を指定できます。 FTRUMConfig.setEnableHeatMap(boolean)初期化設定を追加しました。Heatmap はデフォルトで無効であり、明示的に有効化する必要があります。無効時はヒートマップのターゲット識別および関連属性の計算をスキップします。ft-session-replay >= 0.1.9と組み合わせることで、リプレイのヒートマップバインドノードも同時にスキップでき、通常の RUM とリプレイ録画には影響しません。- 列挙型に基づく
FTRUMConfig.setDeviceMetricsMonitorTypes(...)を追加し、デバイスメトリクスおよび収集頻度を選択できるようにしました。旧版のビットマスクインターフェースは互換性のため残しますが、非推奨としてマークします。ページ終了後または置き換え後もデバイスメトリクスタスクがスケジュールされ続ける問題を修正しました。 - 汎用の外部 Session Replay 導入インターフェースを追加し、フレームワークやエンジンのレコーダーが RUM コンテキスト、シャードストレージ、画像リソース、リプレイメタデータを再利用し、ネイティブレコーダーの一時停止と再開を調整できるようにしました。動的レコーダー管理とフレーム単位のバイト予算に基づく WebP 画像エンコードには
ft-session-replay >= 0.1.9が必要です。従来の Flutter 専用インターフェースは非推奨の互換エイリアスとして残します。 - コールドスタート収集を最適化し、重複する起動コールバックが初回起動時刻を上書きする問題、および最初の Activity が描画されない場合にコールドスタート Action が欠落する問題を修正しました。
app_launch_type=foreground_and_backgroundを追加し、フォアグラウンド起動後、初回フレーム完了前にバックグラウンドへ移行したケースを識別できるようにしました。バックグラウンドで開始された起動は引き続きbackgroundを保持します。 - 早期クラッシュ後の同期タイミングを最適化しました。プロセスが SDK を初回インストールしてから 5 秒以内(含む)に Java Crash を自動捕捉した場合、またはリアルタイムの Native Crash コールバックを受信した場合、次回起動時の初回自動アップロード待機時間を 10 秒から 2 秒に短縮します。以降の同期周期とリトライポリシーは変更ありません。
- Java/Native Crash または過去の致命的な ANR の後に View の
time_spentがゼロのままになる問題を修正し、同じアプリの UI が他のフォアグラウンドプロセスによって担われている場合に、SDK のメインプロセスがバックグラウンド移行を早期に判定してしまう問題を修正しました。 - リモート設定の更新後にネイティブ RUM のサンプリングレートメタデータが不正確になる問題を修正し、
0–100のパーセントで統一して記録し、小数および明示的なゼロ値を保持するようにしました。 - SQLite 内で数字以外の文字で始まる View ID の属性を更新できない問題、および前のページが履歴から削除された後に計算済みのインタラクション所要時間が失われる問題を修正しました。ページ所要時間メトリクスは既存のストレージ構造を引き続き使用するため、データベースバージョンのアップグレードは不要です。
- 動的に生成される View ID のリソース検索を最適化し、Session Replay や Heatmap のターゲット識別によって
Invalid IDエラーが繰り返し発生するのを回避しました。バッテリー監視ブロードキャストの登録を最適化し、Android バージョンごとのレシーバーフラグ要件に適合させました。
1.7.5 (2026/08/16)¶
- OkHttp WebSocket ハンドシェイクの RUM Resource 収集を追加しました。
FTRUMConfig.setEnableTraceUserResource(true)を有効化したうえでft-plugin >= 1.3.8を使用すると自動収集でき、FTWebSocket.newWebSocket(...)またはFTWebSocket.wrap(...)による手動導入も可能です。データにはresource_type=websocket、resource_websocket_collection_level=handshake、resource_websocket_handshake_state(success、rejected、failed)が追加されます。 - バックグラウンドコンポーネントが最初の Activity より先に起動した場合に、コールドスタート Action の
app_launch_type分類が不正確になる問題、および起動所要時間にデバイスの深いスリープ時間が含まれる問題を修正しました。 FTRUMConfig.setIssueDataProvider(...)を追加し、自動収集される Crash および ANR の RUM Error(過去に復元された ANR データを含む)にカスタムフィールドを追加できるようにしました。- Android 11(API 30)以降の致命的な ANR 復元機能を追加しました。
FTRUMConfig.setEnableTrackAppANR(true)を有効化すると、SDK はプロセスの次回起動時に致命的な ANR を復元し、元の RUM View の関連付けを保持します。Android 10 以前は引き続きリアルタイムの watchdog/native ANR 収集を使用し、Android 11 以降では非致命的なリアルタイム ANR を収集しません。 - watchdog ANR が同一 SDK ライフサイクル内で重複レポートされる問題、および
FTSdk.shutDown()呼び出し時に検出スレッドが速やかに終了しない問題を修正しました。 - WebView Browser Log 収集を追加しました。
FTLoggerConfig.setEnableWebViewLog(true)で有効化でき、ログフィルタリング、キャッシュアップロード、FTLoggerConfig.setEnableLinkRumData(...)による RUM 関連付け、およびリモートのlogEnableWebViewLog設定をサポートします。 - WebView host 設定を最適化し、
FTSDKConfig.setAllowWebViewHost(...)を追加して WebView RUM と Log の host 範囲を統一的に制御できるようにするとともに、FTRUMConfig.setAllowWebViewHost(...)を非推奨にしました。 - Session Replay の停止後も WebView と Activity を保持し続けることで発生するメモリリークを修正しました。
1.7.4 (2026/07/15)¶
- 実験的な Android RUM Heatmap サポートを追加し、RUM データに
display、action_position、action_targetを追加しました。リプレイ要素の関連付けにはft-session-replay >= 0.1.7が必要です。 - ロケールに関連するパース問題を修正し、カスタムログのコンソール出力の耐障害性を向上させました。
1.7.3 (2026/07/02)¶
FTSdk.setAutoSync(boolean)を追加し、SDK 初期化後にキャッシュデータの自動同期を動的に有効化または無効化できるようにしました。FTLoggerConfig.setLogLevelFiltersがwarnとwarningのログレベルフィルター値を一貫して処理しない問題を修正しました。- Native Crash と ANR の logcat 設定が適用されない問題を修正し、それぞれ
nativeCrashLogCatSettingとanrCrashLogCatSettingを正しく使用するようにしました。 - 起動段階のキャッシュ数初期化とファイルキャッシュサイズ更新のロジックを最適化し、SDK 起動時にメインスレッドがブロックされるのを回避しました。
- ファイルキャッシュサイズの統計方法を最適化し、永続化された増分メタデータを使用して、大容量 FileStore シナリオにおけるキャッシュ上限判定の正確性と書き込み性能を向上させました。
- 総キャッシュサイズ制限を有効化した際の RUM キャッシュポリシーのロック競合を最適化し、高並列 FileStore 書き込みの安定性を向上させました。
- リモート設定のログ表示を最適化し、
rumAllowWebViewHost、logLevelFiltersなどの配列フィールドが実際の内容を出力するようにしました。
1.7.2 (2026/05/20)¶
- ブラックリストフィルタリング機能を追加し、ローカルキャッシュ書き込み前に Logging および RUM データをフィルタリングできるようにしました。ルールはアプリ内で
FTSDKConfig.setDataFiltersにより設定でき、Guance ワークスペースのブラックリストから自動取得することもでき、両方の方法が同時に有効になります。この機能はデフォルトで有効であり、FTSDKConfig.setEnableDataFilter(false)で無効化できます。フィルタリングルールはLineDataModifierの後に実行されます。 - 汎用のキャッシュサイズ制限設定
FTSDKConfig.enableLimitWithCacheSize、FTSDKConfig.setCacheDiscard、CacheDiscardを追加しました。従来のenableLimitWithDbSize、setDbCacheDiscardは互換性のため残しますが、新しいインターフェースへの移行を推奨します。 - ファイルキャッシュ機能
FTSDKConfig.enableFileDataStore()を追加し、同期キャッシュと RUM 集約データに使用するとともに、旧キャッシュとの互換性を保つ移行パスを提供します。 ft-sdkはft-session-replayに強く依存しなくなりました。Session Replay を有効化していないアプリでは、ft-session-replay依存を追加で導入する必要はありません。- コールドスタート Action に
app_launch_typeフィールドを追加し、フォアグラウンド起動とバックグラウンド起動を区別できるようにしました。 - RUM のフォールバック View データを追加し、
ApplicationLaunch、BackgroundView、RootViewのシナリオで実際の View 集約レコードを生成することで、起動時、バックグラウンド時、およびフォアグラウンド View が欠落した RUM イベントにランダムなview_idを関連付けられるようにしました。 - データ同期ポリシーを最適化し、RUM データを優先的に同期するとともに、データタイプごとにリトライとバックオフの状態を分離し、ログ同期が RUM データのレポートに影響する状況を軽減しました。
- カスタム Resource 属性が SDK の計算した
durationを上書きする可能性がある問題を修正し、異常時のフォールバック所要時間に対して非負値の保護を行うようにしました。 - Session Replay のアップロードリトライとアップロード先検証のロジックを修正し、無効なアドレスでアップロードが繰り返し発生するのを回避するとともに、リトライ可能な失敗をバックオフポリシーで処理するようにしました。
1.7.1 (2026/04/30)¶
- View RUM メトリクス
view_long_task_rateを追加し、View ライフサイクル内の Long Task 総時間の割合を統計できるようにしました。値の最大は1です。 - クラッシュ RUM Error メトリクス
foreground_crash_free_durationとbackground_crash_free_durationを追加し、フォアグラウンドとバックグラウンドの無クラッシュ稼働時間を区別できるようにしました。 - Resource ネットワークスナップショットフィールドとして
network_available、network_validated、network_downlink_kbps、network_uplink_kbps、network_signal_strengthを追加しました。 - SDK のデータ同期で deflate 圧縮がデフォルトで有効になりました。
FTSDKConfig.setCompressIntakeRequests(false)で無効化できます。 ft-sdkと Session Replay モジュール間のバージョン依存制約を修正し、統合時の互換性検証の正確性を向上させました。
1.7.0 (2026/04/17)¶
- Session Replay 機能を追加し、WebView Session Replay、DCloud WebView、および WebView コンテナの全量スナップショットキーフレーム収集をサポートしました。
- Session Replay と RUM コンテキストの関連付け機能を追加し、WebView コンテナと読み込み済み HTML コンテンツのコンテキストを関連付けられるようにしました。
- Session Replay のエラーサンプリング機能を追加し、リモート設定による Session Replay の動的制御をサポートしました。
- Session Replay の画像リソースアップロード機能を追加し、userAgent、appVersion などのパラメータの受け渡しと同期経路の適応を補完しました。
- Session Replay の初期化、シャード補完フレーム、フレーム生成と消費、遅延書き込み、ディスク書き込み制限などのロジックを最適化し、録画と同期の安定性を向上させました。
- WebView データの欠落、非表示シナリオの処理異常、早期書き込みによる白画面、低バージョンの OkHttp で同期できない問題、Bitmap の回収による録画失敗などの問題を修正しました。
- 一部のコントロールでレイアウト未完了時にメソッドを呼び出すことで発生するクラッシュを修正し、全体的な安定性と互換性を向上させました。
1.6.17 (2026/3/25)¶
- 1.6.16 バージョンで発生した問題を修正しました。リモート動的設定が初回読み込み時に反映されませんでした。
TraceContextとTraceContext.Simpleを追加し、カスタム Trace Header の処理に使用できるようにしました。HeaderHandler.getTraceContext(Request)をオーバーライドすることで、headers、traceId、spanIdを一度に提供でき、 既存のgetTraceHeader、getTraceID/getSpanID実装と完全に互換性があります。FTSdk.setDatakitUrl(url)、FTSdk.setDatawayUrl(datawayUrl, clientToken)による転送アドレスの動的変更をサポートしました。
1.6.16 (2026/1/08)¶
- globalContext と属性 key に不正文字のフィルタリングを追加しました。
resource_typeのサポート範囲を拡張し、image、media、font、CSS、JS、native タイプを追加しました。FTSDKConfig.setRemoteConfigurationCallBack(FTRemoteConfigManager.FetchResult),FTSdk.updateRemoteConfig(int remoteConfigMiniUpdateInterval, FTRemoteConfigManager.FetchResult result)によるリモート変数のカスタム解析と設定をサポートしました。- Resource に
resource_http_protocol、resource_request_size、resource_connection_reuseフィールドを追加しました。 - コールドスタート時間メトリクスを細分化し、
app_pre_application_init_time、app_application_init_time、app_first_frame_init_timeを追加しました。 - OkHttp 3.12 以降のバージョンへの互換サポートを追加しました。
- Resource リクエストの開始時刻が不正確になる問題を修正しました。
- SDK のシャットダウン過程中に Action と View を取得する際、まれに発生する null ポインタ例外を修正しました。
- エラースタックの形式を最適化し、特定のシナリオで改行が正しくない問題を修正しました。
- アプリがバックグラウンドにある場合に、制限付きの Long Task 監視機能を追加しました。
- アプリのバックグラウンド状態における Session のリフレッシュメカニズムを最適化しました。
- Action、View、Resource におけるナノ秒単位の所要時間計算ロジックを最適化しました。
1.6.15 (2025/12/03)¶
- FPS 監視メカニズムを最適化しました。メインスレッドで開始し、アプリがバックグラウンドに入ると自動的に監視を停止します。
- 4K を超える長いログの出力メカニズムを最適化し、ログの可読性と完全性を向上させました。
- View コンテキストにおける resource、long task、error の生成ロジックを最適化しました。
- View の生成速度を向上させ、同じ view_id を持つことで発生するトラフィックデータを削減しました。
- サブプロセスにおける ActivityLifecycleCallbacks の制限を解除し、ライフサイクル監視をより完全にしました。
- View でまれに発生するデータ更新の欠落問題を修正しました。
- 非同期ネットワークリクエストによるセッションリフレッシュ異常を修正しました。
- SDK のシャットダウン後に再度初期化しても、アイドル時の DB 解放がトリガーされない問題を修正しました。
1.6.14 (2025/08/20)¶
- ContentProvider を使用して、マルチプロセスデータ収集の高負荷シナリオにおける互換性問題を最適化しました
- SDK の AndroidMainfest における
android.permission.READ_PHONE_STATEの宣言を削除しました。統合側で実際の状況に応じて追加する必要があります。権限の使用説明は統合ドキュメントを参照してください - サブプロセスのデータ同期を制限し、サブプロセスが収集したデータはメインプロセスからレポートされるようにしました。
1.6.13 (2025/08/10)¶
FTRUMConfig.setActionTrackingHandlerを追加し、カスタムのユーザー操作追跡をサポートしました。このハンドラーにより、開発者は RUM データにおける ユーザー操作(アプリ起動、クリック)の追跡方法をカスタマイズできます。開発者は操作名の変更、カスタム属性の追加、または特定の操作の追跡スキップが可能です。FTRUMConfig.setViewActivityTrackingHandlerを追加し、カスタムの Activity ページ追跡をサポートしました。このハンドラーにより、開発者は RUM データにおける Activity ページの追跡方法をカスタマイズできます。開発者はページ名の変更、カスタム属性の追加、または特定の Activity の追跡スキップが可能です。FTRUMConfig.setViewFragmentTrackingHandlerを追加し、カスタムの Fragment ページ追跡をサポートしました。このハンドラーにより、開発者は RUM データにおける Fragment ページの追跡方法をカスタマイズできます。開発者はページ名の変更、カスタム属性の追加、または特定の Fragment の追跡スキップが可能です。FTRUMGlobalManager.addActionに bindUserData のバインド関連情報(userid など)が欠落する問題を修正しました- View の
Fragemntにload_timeデータメトリクスを追加しました FTRUMGlobalManager.updateTimeを追加し、現在の view の読み込み時間をカスタマイズできるようにしました- OkHttp 3.12.x バージョンとの互換性を向上させました。
FTRUMConfig.appendRUMGlobalContextで追加したタグを session 期間中に更新できるようにしました。
1.6.12 (2025/06/11)¶
FTRUMConfig.setEnableTraceWebViewを追加し、Android SDK による WebView データ収集の有効化を設定できるようにしました。FTRUMConfig.setAllowWebViewHostにより、フィルタリングが必要な host アドレスを制御できますContentHandlerHelperEx.onExceptionWithFilterを追加し、ローカルネットワークエラーをフィルタリングできるようにしましたFTSDKConfig.setRemoteConfigurationを追加し、リモート条件設定機能の有効化をサポートしました。FTSDKConfig.setRemoteConfigMiniUpdateIntervalを追加し、リモート制御の有効化後に最短更新間隔を設定できるようにしました
1.6.11 (2025/05/15)¶
FTRUMConfig.setEnableTraceUserViewInFragmentを追加し、fragment view のデータ収集をサポートしました。デフォルトはfalseですFTSDKConfig.setLineDataModifier、FTSDKConfig.setDataModifierを追加し、データ書き込み時の置換およびデータマスキングをサポートしましたFTRUMConfig.setSessionErrorSampleRateを追加し、エラーサンプリングをサポートしました。setSamplingRateでサンプリングされなかった場合でも、 エラー発生時に 1 分前の RUM データをサンプリング収集できますFTSDKConfig.setEnableAccessAndroidID(false)の場合、ローカルのランダムUUIDをdevice_uuidとして使用します- 高頻度ログ書き込みを最適化し、データ同期およびデータアイドル時のクローズロジックを最適化しました
1.6.10 (2025/04/18)¶
FTSDKConfig.setEnableOkhttpRequestTagを追加し、OkHttp request に一意の ResourceID を追加できるようにしました。 これにより、同じリクエストが高並列で発生した際の trace_id、span_id の誤った対応関係を解消します。ft-plugin 1.3.5 以降のバージョンで ResourceID の自動追加をサポートします。- RUM 設定を複数回初期化するシナリオで、他のクラッシュ収集 SDK との間で循環呼び出しが発生する問題を修正しました
- ネイティブページから WebView ページへ遷移する際、ネイティブページ名で view_referrer を埋めるようにしました
- ネットワークリクエストの IOException を再スローする際に元の型が改変される問題を修正しました
- FTSDKConfig に
setProxy,setProxyAuthenticator,setDnsを追加し、OkHttp データ同期のネットワークリクエストに対して Proxy、ProxyAuthenticator、Dns を設定できるようにしました - OkHttp データ同期のネットワークリクエストで、既知の hostName に対する DNS IP ラウンドロビン接続をサポートしました
1.6.9 (2025/03/07)¶
- isAppForeground の判定メカニズムを変更し、プライバシーに敏感な情報の検出に対応しました
resourceデータフィールドresource_first_byte_time、resource_dns_time、resource_download_time、resource_connect_time、resource_ssl_timeを追加し、 Guance 上での Resource 所要時間の拡張表示、および「APM」フレームグラフのタイムライン整列をサポートしました- 同期リトライメカニズムを最適化し、
FTSDKConfig.setDataSyncRetryCount(0)でデータを直接破棄する設定オプションを廃止しました FTSDKConfig.enableDataIntegerCompatibleはデフォルトで有効であり、web の数値浮動小数点型データとの互換性に使用します- RUM 設定を複数回初期化するシナリオで、クラッシュデータが重複して生成される問題を修正しました
1.6.8 (2025/01/21)¶
- RUM 設定を複数回初期化すると FPS 収集が不正確になる問題を修正しました
- 旧バージョンのキャッシュデータアップグレードに対するフォールトトレランスを追加しました
FTRUMConfig.setOkHttpTraceHeaderHandlerをFTTraceConfig.setOkHttpTraceHeaderHandlerに移行しました- WebView SDK の内部情報を強化し、パフォーマンスを最適化しました
1.6.7 (2025/01/10)¶
- カスタム
FTTraceInterceptor.HeaderHandlerと RUM データの関連付けをサポートしました FTRUMConfig.setOkHttpTraceHeaderHandlerにより ASM が書き込むFTTraceInterceptor.HeaderHandlerの内容を変更できるようにし、FTRUMConfig.setOkHttpResourceContentHandlerにより ASM が書き込むFTResourceInterceptor.ContentHandlerHelperの内容を変更できるようにしました。- クラッシュ収集機能を最適化し、一部の OS が
system.exitをトリガーしてクラッシュデータを収集できないシナリオに対応しました - tag がまれに空文字となり、データが正常にレポートされない問題を修正しました
- ASM OkHttpListener EventListener のオーバーライドロジックを最適化し、元のプロジェクトの EventListener イベントパラメータの受け渡しを保持できるようにしました
1.6.6 (2024/12/27)¶
- ネットワーク状態およびタイプの取得を最適化し、ethernet タイプのネットワークタイプ表示をサポートしました
- ネットワークがない状態で、データ書き込みによりデータベースが頻繁にクローズされる問題を最適化しました
- ログおよび RUM の古いデータを破棄する際に、データ件数が設定した件数とずれる問題を修正しました
- TV デバイスのキーイベントに対応し、TV 以外のデバイスの tag を除外しました
FTRUMConfig.setRumCacheLimitCount(int)により RUM データキャッシュ件数の上限を制限できるようにしました。デフォルトは 100_000 ですFTSDKConfig enableLimitWithDbSize(long dbSize)により総キャッシュサイズを制限する機能をサポートしました。有効化するとFTLoggerConfig.setLogCacheLimitCount(int)およびFTRUMConfig.setRumCacheLimitCount(int)は無効になります- デバイスが無操作のシナリオにおける Session リフレッシュルールを最適化しました
1.6.5 (2024/12/24)¶
- AOP 過程で WebView のパラメータが null になる場合の警告を緩和しました
- アプリがバックグラウンドにある際の長い Session の更新メカニズムを最適化しました
1.6.4 (2024/12/03)¶
- API 24 以降における App 起動時間の統計を最適化しました
FTRUMConfig.setEnableTrackAppUIBlock(true, blockDurationMs)により検出時間範囲を設定できるようにしました
1.6.3 (2024/11/18)¶
- カスタム
addActionを高頻度で呼び出した際のパフォーマンスを最適化しました FTSDKConfig.setCompressIntakeRequestsを使用して、同期データにdeflate圧縮を設定できるようにしました
1.6.2 (2024/10/24)¶
- RUM に
addActionメソッドを追加し、property 拡張属性と高頻度の連続データレポートをサポートしました
1.6.1 (2024/10/18)¶
- RUM でカスタム
startViewを単独で呼び出した場合に、監視メトリクスFTMetricsMTRのスレッドが回収されない問題を修正しました FTSdk.appendGlobalContext(globalContext)、FTSdk.appendRUMGlobalContext(globalContext)、FTSdk.appendLogGlobalContext(globalContext)により動的属性を追加できるようにしましたFTSdk.clearAllData()により未レポートのキャッシュデータをクリアできるようにしました- SDK
setSyncSleepTimeの最大制限を 5000 ms に延長しました
1.6.0 (2024/08/18)¶
- データストレージと同期のパフォーマンスを最適化しました
(旧バージョンから 1.6.0 へアップグレードする場合は、
FTSDKConfig.setNeedTransformOldCacheを設定して旧データの互換同期を行う必要があります) - ft-plugin 使用時に
Log.w(String,Throwable)を呼び出すと例外が発生する問題を修正しました
1.5.2 (2024/07/10)¶
- Error network_error にローカルネットワークエラータイプのヒントを追加し、Resource データの resource_status=0 シナリオを補足説明できるようにしました
setEnableTrackAppCrash(false)の場合に uncaughtException の rethrow が伝播しない問題を修正しました
1.5.1 (2024/06/19)¶
- Java Crash および ANR に他のスレッドのコードスタックを補完しました
- Java Crash、Native Crash、ANR に追加の logcat 設定機能を追加しました
- 長い session で action の更新がないシナリオにおいて、session_id が頻繁に更新される問題を修正しました
1.5.0 (2024/06/03)¶
- RUM resource のネットワークリクエストに remote IP アドレス解析機能を追加しました
- RUM SampleRate を有効化した後、高並列のネットワークリクエストで発生する配列のスレッドセーフティ問題を修正しました
ConnectivityManager.registerDefaultNetworkCallbackメソッドのフォールトトレランスを最適化しました- 行プロトコルの Integer データ互換モードを追加し、web データ型の競合問題に対処しました
- 自動収集される Action click におけるコントロールリソース名 ID の取得を最適化しました
- SDK config 設定の読み取り異常に対するフォールトトレランスを最適化しました
1.4.6 (2024/05/15)¶
- SDK 初期化のフォールトトレランスを最適化しました
- ログに Status.Debug タイプを追加しました
- コンソール取得ログレベルの対応関係を調整しました:
Log.i->info、Log.d->debug - FTLogger のカスタムログで status フィールドをカスタマイズできるようにしました
1.4.5 (2024/04/26)¶
- 重複初期化の互換処理を最適化しました
- c/c++ クラッシュ収集データの同期ロジックを最適化し、特定のシナリオで予期せず中断終了してデッドロックが発生するのを回避しました
- startAction Property 属性の書き込みロジックを最適化し、スレッドセーフティなアクセス問題が発生するのを回避しました
1.4.4 (2024/04/01)¶
- データベース接続のフォールトトレランス保護を追加しました
setOnlySupportMainProcessが true の場合に、サブプロセスの設定の一部が有効にならない問題を修正しました- RUM で View 収集を有効化していない場合に、Crash が rethrow されない問題を修正しました
1.4.3 (2024/03/22)¶
- Dataway と Datakit のアドレスアップロードをサポートしました
- Action、View、Resource、LongTask、Error タイプの RUM データ送信をサポートしました。
- View、Action のページ遷移、コントロールクリック操作の自動収集には ft-plugin が必要です
- Resource の自動収集は OkHttp のみをサポートし、ft-plugin が必要です
- Error のうち Native Crash と ANR には ft-native が必要です
- Log データの送信をサポートし、コンソールへの自動書き込みには ft-plugin が必要です
- 分散型トレーシングの HTTP header propagation は OkHttp のみをサポートし、ft-plugin が必要です
- データ同期パラメータの設定として、リクエスト件数、同期間隔、ログキャッシュ件数をサポートしました。
- SDK 内部ログのファイル出力をサポートしました
ft-session-replay¶
0.1.10 (2026/11/10)¶
ft-session-replay¶
- ネイティブリプレイが Window のフォーカス変更イベントを伝達していなかったため、Cocos などフォーカスイベントに依存するホストがネイティブ Activity から戻った後にレンダリングを復元できない問題を修正しました。
- ネイティブレコーダーと外部レコーダーの引き継ぎ後に、残存コールバックがネイティブレコーダーを再起動してしまう問題を修正し、外側のコールバックとホストイベントの伝達を保持するようにしました。
ft-session-replay-material¶
- 変更なし
ft-session-replay-compose¶
- 変更なし
0.1.9 (2026/10/22)¶
ft-session-replay¶
- 汎用の外部レコーダー管理機能を追加し、複数のフレームワークやエンジンのレコーダーが協調してネイティブ録画を一時停止し、最後の外部レコーダーが解放された後にネイティブ録画を再開して全量スナップショットを生成できるようにしました。外部レコーダーのみを使用するモードを公開設定としてサポートします。
- ネイティブレコーダーと外部レコーダーの切り替え時の RUM View 関連付けの問題を修正し、キュー内のレコードが元のページの関連付けを保持し、終了済みのページが新しいレコードを受信せず、ネイティブ録画が新しいページ境界で再開されるようにしました。
- 外部録画画像の WebP エンコードサイズ制御を追加し、フレーム単位のバイト予算に応じて品質とサイズを段階的に下げ、それでも制限を超える場合はそのフレームを拒否するようにしました。
ft-sdk 1.7.6の画像リソースインターフェースと組み合わせることで、受信結果、リソース識別子、エンコードサイズ、サイズを取得できます。 - リプレイシャードの圧縮形式を修正し、単一の SYNC_FLUSH 境界に整列した zlib データストリームを使用することで、複数のネイティブまたは外部録画シャードを結合した後に正常に再生できない問題を解決しました。
FTSessionReplayConfig.setSessionReplaySamplingRate(float)とsetSessionReplayOnErrorSamplingRate(float)を追加し、0–100のパーセントで統一しました。デフォルト値はそれぞれ100と0で、小数および明示的なゼロ値をサポートします。旧版の0–1インターフェースは互換性のため残しますが、非推奨としてマークします。新旧のインターフェースを同時に設定した場合は新しいインターフェースが優先され、ft-sdk 1.7.6と組み合わせることでリモート設定を引き続きローカル設定より優先できます。- ネイティブリプレイは
ft-sdk 1.7.6のFTRUMConfig.setEnableHeatMap(...)設定に従い、Heatmap はデフォルトで無効です。無効時はヒートマップの永続識別子計算と透明バインドノードをスキップし、通常のコントロールリプレイ、ビューポート情報、タッチ可視化は保持します。 - 実行時のリプレイサンプリングレート更新のスレッド間可視性を修正し、ネイティブ RUM メタデータが有効中のサンプリングレートを読み取れるようにしました。リプレイコンテキスト内のサンプリングレートフィールドは
0–100のパーセントで統一しました。
ft-session-replay-material¶
- Session Replay コアバージョンに追随した更新で、モジュール独自の変更はありません。
ft-session-replay-compose¶
- Session Replay コアバージョンに追随した更新で、モジュール独自の変更はありません。
0.1.8 (2026/08/16)¶
ft-session-replay¶
- Session Replay のリソースチェックとアップロードで、
FTSessionReplayConfig.enableLinkRUMKeys(...)により選択された RUMglobalContextを伝達できるようにし、リソースリクエストが対応する RUM コンテキストを保持できるようにしました。 - Session Replay の停止後も WebView と Activity を保持し続けることで発生するメモリリークを修正しました。
ft-session-replay-material¶
- 変更なし。
ft-session-replay-compose¶
- 変更なし。
0.1.7 (2026/07/15)¶
ft-session-replay¶
- 実験的な Android Heatmap の Session Replay 要素関連付け機能を追加しました。
ft-sdk >= 1.7.4と組み合わせて使用する必要があります。 - マルチタッチおよびジェスチャーキャンセルのシナリオで Pointer ID と座標が正しく記録されない問題を修正しました。
- トルコ語などの言語環境で、
PrivacyOverrideExtensions.setSessionReplayTouchPrivacy(View, TouchPrivacy)により設定した View のタッチプライバシーオーバーライドが反映されない可能性がある問題を修正しました。
ft-session-replay-material¶
- 変更なし。
ft-session-replay-compose¶
- 変更なし。
0.1.6 (2026/07/09)¶
ft-session-replay¶
- Flutter Session Replay の外部レコーダーモードを追加しました。Flutter 側のレコーダーが Session Replay のサンプリング、コンテキスト更新、データ書き込みの機能を再利用できる一方で、ネイティブレコーダーのライフサイクルは無効化されます。
- Session Replay が
DialogFragmentを処理する際、getDialog()または所属 Window が空であることにより発生するクラッシュを修正しました。
ft-session-replay-material¶
- 変更なし。
ft-session-replay-compose¶
- 変更なし。
0.1.5 (2026/05/19)¶
ft-session-replay¶
- Flutter Session Replay のアップロード互換機能を追加し、Flutter RUM コンテキスト Key により Replay バッチを対応する Segment にマッピングできるようにしました。
- 通常ストレージと暗号化ストレージの実装における Session Replay ファイル読み書きファクトリの互換性問題を修正しました。
- Session Replay のデータおよびリソースアップロードのリトライ状態処理を修正し、アップロード失敗時はバックオフポリシーでリトライするようにしました。無効なアップロード先は、有効なアドレスが設定されるまでスキップされます。
- Session Replay に残っていた JetBrains の null 許容アノテーションを AndroidX アノテーションに置き換え、冗長なアノテーション依存を削減しました。
ft-session-replay-material¶
- 変更なし。
ft-session-replay-compose¶
- 変更なし。
0.1.4 (2026/04/30)¶
ft-session-replay¶
- 冗長な Kotlin 依存を削除し、Session Replay の依存関係を簡素化しました。
- Session Replay の設定、プライバシー制御、カスタム Mapper 拡張、リソースアップロードコールバックなどの公開 API のコメントを整備し、Java/Kotlin 統合時の IDE ヒントとカスタム拡張開発の体験を向上させました。
ft-session-replay-material¶
ft-session-replay0.1.4 とバージョンを揃え、API や動作の変更はありません。
ft-session-replay-compose¶
AndroidView互換ノードを録画する際、低バージョンの Session Replay Core にMappingContext.getInteropViewCallback()がなくクラッシュする問題を修正しました。- consumer ProGuard ルールを追加し、Compose Replay が依存する
MappingContextの AndroidView 互換コールバックアクセスメソッドを保持するようにしました。 - Compose Replay の
Modifierプライバシーオーバーライド、拡張サポート、テキスト切り詰めモード、画像 Wireframe 補助メソッドのコメントを整備し、Kotlin/Compose 統合時の IDE ヒントを向上させました。
0.1.3 (2026/04/17)¶
ft-session-replay¶
- WebView Session Replay 機能を追加し、DCloud WebView および WebView コンテナの全量スナップショットキーフレーム収集をサポートしました。
- Session Replay と RUM コンテキストの関連付け機能を追加し、WebView コンテナと読み込み済み HTML コンテンツのコンテキストを関連付けられるようにしました。
- エラーサンプリング機能を追加し、リモート設定による Session Replay の動的制御をサポートしました。
- 画像リソースアップロード機能を追加し、userAgent、appVersion、forceFullSnapshot などのメタデータ処理を整備しました。
- フレーム生成と消費、シャード補完フレーム、WebView Replay データの遅延書き込み、非表示 WebView の処理、ディスク書き込み制限を最適化し、安定性とパフォーマンスを向上させました。
- WebView Replay データの欠落、早期書き込みによる白画面、低バージョンの OkHttp での同期失敗、Bitmap の回収による録画失敗、rumLinkKey の空値処理、複数画像シナリオでの録画タイムアウトなどの問題を修正しました。
ft-session-replay-material¶
- Session Replay の Material コンポーネント(CardView と Chip)サポートを追加しました。
- 低バージョン Android の互換性とデバッグサポートを最適化しました。
- Replay データにおける Material コンポーネントのレンダリング表現を最適化し、MaterialDrawableToColorMapper ルールを更新しました。
ft-session-replayとバージョンポリシーを揃え、リリース管理と統合の一貫性を向上させました。
ft-session-replay-compose¶
- Jetpack Compose Session Replay サポートを追加し、
ComposeViewとAndroidComposeViewのシナリオを録画およびリプレイできるようにしました。 - テキスト、テキスト入力欄、ボタン、画像、スライダー、Switch、Checkbox、RadioButton、Tab、コンテナ系ノードなど、一般的な Compose コンポーネントのセマンティックマッピングとリプレイをサポートしました。
- Compose において
Modifierによる Session Replay のプライバシーオーバーライド(ノードの非表示、画像プライバシー、テキストと入力のプライバシー、タッチプライバシー)をサポートしました。 - 現在の Compose リプレイはセマンティックノードのマッピングに基づいており、ピクセル単位の再現は保証されません。
Brush背景は現時点ではサポートされておらず、リニアグラデーションやラジアルグラデーションなどの背景は元の効果どおりにはリプレイされません。
ft-session-replay-material のその他の変更履歴
ft-session-replay-compose のその他の変更履歴
ft-native¶
1.1.4 (2026/10/22)¶
- Native Crash と ANR のカスタム logcat 設定がエラー収集スイッチに制御されてしまう問題を修正し、それぞれの設定が対応する収集スイッチに従って反映されるようにしました。また、いずれか一方の収集のみを有効化した場合にカスタムログ行数が反映されない問題を修正しました。これには Android 11 以降で Agent がネイティブ ANR 収集を無効化した際の Native Crash シナリオも含まれます。
- 公開インターフェースの説明を整備しました。公開メソッドシグネチャと基盤の
.soライブラリは変更ありません。
1.1.3 (2026/04/30)¶
- Native Crash のバックトレースの堅牢性を強化し、空アドレス検出を追加するとともに、libft_native_exp_lib.so において libunwind.so のバックトレース時の null ポインタおよびダングリングポインタのチェックを強化しました。
- Native Crash 処理中に libunwind.so が二次クラッシュする可能性がある問題を修正しました。
1.1.2 (2025/07/18)¶
- Android 16K ページサイズに対応しました(Android 15 以降と互換)
1.1.1 (2024/06/22)¶
- Native Crash と ANR の logcat 設定機能を追加しました
1.1.0 (2024/03/22)¶
- ANR Crash の捕捉をサポートしました
- C/C++ Native Crash の捕捉をサポートしました
- クラッシュ時にアプリの稼働状態を収集できるようにしました
- ANR と Native Crash のトリガーコールバックをサポートしました
ft-plguin ( AGP >=7.4.2 )¶
1.3.9 (2026/10/22)¶
URL.openConnection()とURL.openConnection(Proxy)の戻り値に対する自動ラップを追加しました。ft-sdk 1.7.6と組み合わせ、FTRUMConfig.setEnableTraceUserResource(true)とsetEnableHttpURLConnectionResource(true)を同時に有効化すると、HTTP/HTTPS URLConnection の RUM Resource を自動収集できます。FTExt.instrumentHttpURLConnectionスイッチを追加しました。デフォルトで有効で、falseに設定すると URLConnection のインストルメンテーションを無効化できます。この設定は Gradle インストルメンテーションキャッシュの判定に含まれ、既存のパッケージ、クラス、メソッドの除外ルールを踏襲するため、重複処理によって収集フックが重複して追加されることはありません。
1.3.8 (2026/08/16)¶
- OkHttp
newWebSocket()の自動インストルメンテーションを追加しました。FTRUMConfig.setEnableTraceUserResource(true)を有効化すると WebSocket ハンドシェイクの RUM Resource を自動収集でき、ft-sdk >= 1.7.5と組み合わせる必要があります。
1.3.7 (2026/06/26)¶
ignorePackagesにワイルドカード設定のサポートを追加しました。autoUploadNativeDebugSymbolを有効化し、デフォルトのnativeLibPathによる自動識別を使用した場合に、一部の AGP ビルドで strip されていない Native.soシンボルファイルのディレクトリを識別できず、シンボル圧縮パッケージの生成が異常になる問題を修正しました。
1.3.6 (2025/12/03)¶
- UniApp WebView をサポートしました
- knownWebViewClasses パラメータを追加し、ASM 書き込みをサポートしました。
- ログのファイル出力機能を追加しました。
- verboseLog パラメータを追加し、より多くのログを出力できるようにしました。
- FTMethodAdapter に数値境界処理を追加しました。
- カスタム WebView の内部メソッドをフィルタリングするための除外設定を追加しました。
1.3.5 (2025/04/18)¶
- 並列コンパイルにおける plugin パラメータの安定性を最適化しました
- ASM で FTAutoTrack.trackRequestBuilder メソッドを書き込む機能を追加しました。ft-sdk 1.6.10 以降のバージョンが必要です
- Log.println ログの自動取得をサポートしました。ft-sdk 1.6.8 以降のバージョンが必要です
1.3.4 (2024/12/11)¶
- エラーログの出力を最適化しました
- minifyEnabled が有効になっていない場合に sourcemap symbol ファイルが生成されない問題を修正しました
- generateSourceMapOnly true により、sourcemap を生成しつつ自動アップロードは行わない設定をサポートしました
1.3.3 (2024/09/04)¶
- native symbol so の自動取得とアップロードを最適化し、nativeLibPath のカスタム指定をサポートしました
1.3.2 (2024/08/13)¶
- React Native WebView イベントの自動キャプチャをサポートしました
1.3.1 (2024/07/04)¶
- asmVersion 設定機能を追加し、asm7 から asm9 までをサポートしました。デフォルトは asm9 です
- WebView のカスタムメソッドが ASM 書き込み後に循環呼び出しを引き起こし、WebView の内容を読み込めなくなる問題を修正しました
(対象メソッド
loadUrl、loadData、loadDataWithBaseURL、postUrl) - IgnoreAOP をクラス内で宣言し、クラス全体のメソッドを無視できるようにしました
ignorePackages設定を追加し、パッケージパスで ASM の無視対象を設定できるようにしました
1.3.0 (2024/03/22)¶
- datakit source map の自動アップロード、および native symbol のアップロードをサポートしました
- Application のコールドスタート・ウォームスタート、Activity のページ遷移、View、ListView、Dialog、Tab のクリックイベントの捕捉をサポートしました。
- WebView JS 監視メソッドの書き込みをサポートしました
- OkHttp の Trace および Resource データの自動書き込みをサポートしました
- Gradle 8.0、AGP 8.0 をサポートしました
- IgnoreAOP の無視マーカーをサポートしました
- Alibaba Cloud ホットフィックスフレームワークとの互換性をサポートしました
ft-plugin-legacy ( AGP <=7.4.2 )¶
1.1.9 (2025/12/09)¶
- UniApp WebView をサポートしました
- knownWebViewClasses パラメータを追加し、ASM 書き込みをサポートしました。
- ログのファイル出力機能を追加しました。
- verboseLog パラメータを追加し、より多くのログを出力できるようにしました。
- FTMethodAdapter に数値境界処理を追加しました。
- カスタム WebView の内部メソッドをフィルタリングするための除外設定を追加しました。
1.1.8 (2024/08/13)¶
- React Native WebView イベントの自動キャプチャをサポートしました
1.1.7 (2024/07/04)¶
- WebView サブクラスでオーバーライドしたメソッドが ASM 書き込み後に循環呼び出しを引き起こし、WebView の内容を読み込めなくなる問題を修正しました
(対象メソッド
loadUrl、loadData、loadDataWithBaseURL、postUrl) - IgnoreAOP をクラス内で宣言し、クラス全体のメソッドを無視できるようにしました
ignorePackages設定を追加し、パッケージパスで ASM の無視対象を設定できるようにしました
1.1.6 (2024/03/22)¶
- datakit source map の自動アップロード、および native symbol のアップロードをサポートしました
- Application のコールドスタート・ウォームスタート、Activity のページ遷移、View、ListView、Dialog、Tab のクリックイベントの捕捉をサポートしました。
- WebView JS 監視メソッドの書き込みをサポートしました
- OkHttp の Trace および Resource データの自動書き込みをサポートしました
- AGP 7.4.2 未満のバージョンをサポートしました
- IgnoreAOP の無視マーカーをサポートしました
- Alibaba Cloud ホットフィックスフレームワークとの互換性をサポートしました