更新履歴¶
1.6.7 (2026/08/19)¶
- WebSocket ハンドシェイクリクエストの RUM Resource 収集をサポートしました。データに
resource_type=websocket、resource_websocket_collection_level=handshake、resource_websocket_handshake_state(success、rejected、failed)を追加しました。 FTRumConfig.issueDataProviderを追加しました。自動収集された Crash および ANR RUM Error に、検証済みのカスタムフィールドと履歴コンテキストを付加できます。- macOS Session Replay の録画をサポートしました。一般的な AppKit ビューおよびコントロールをカバーします。
- macOS アプリ起動 Action の自動収集を追加し、macOS のデフォルト
serviceおよび Logsourceタグを統一しました。 - Session Replay のリソースチェックとアップロードで RUM コンテキストの関連付けをサポートしました。
FTSessionReplayConfig.enableLinkRUMKeysで転送する RUM globalContext フィールドを選択できます。これにより、同じリソースが異なる関連コンテキストで正しくルーティングされ、独立して保持され、重複排除されます。 - フォールバック View、アプリ起動、初回フレーム追跡、遅延した初期 Action、Session 期限切れなどのシナリオにおける RUM ライフサイクル処理を最適化しました。
- UIKit および SwiftUI の自動収集 RUM View における
loading_time測定を最適化し、プリレンダリングおよびプリロードフェーズのアイドル時間を除外しました。
1.6.6 (2026/07/15)¶
- 移行の変更: CocoaPods および Swift Package Manager の配布プロダクト名が
FTMobileSDKシリーズからGuanceSDKシリーズに変更されました。GuanceSDK、GuanceWidgetExtension、GuanceSessionReplayを使用してください。CocoaPods のエイリアスGuanceSDK/ExtensionおよびGuanceSDK/FTSessionReplayは引き続き利用可能です。既存プロジェクトのアップグレードについては移行ガイドを参照してください。 - 実験的な Session Replay ヒートマップ連携機能を追加しました。
FTSessionReplayConfig.enableHeatmapで有効化できます。この機能は自動収集された UIKit Action とのみ連携します。一部の UIKit Action はヒートマップをサポートしていません。SwiftUI Action は自動収集をサポートしていないため、この機能ではヒートマップの連携はできません。 - システムの
compressionおよびzlibヘッダーファイルを追加しました。 - URLSession Resource の安定性を最適化しました。非同期処理で request および trace データを保持し、キャッシュされたレスポンスボディサイズを制限して OOM リスクを低減しました。
- RUM CPU 計算、アプリ起動、アプリ状態、Session タイムアウト、クラッシュコンテキスト、アクティブ View コンテキスト処理の問題を修正しました。
- ANR の信頼性を向上させました。アプリがバックグラウンドに入ったときに SQLite
VACUUMを実行しないようにし、全スレッドバックトレース収集をリトライするようにしました。 - 無効な列挙値による潜在的な配列範囲外クラッシュを修正しました。
1.6.5 (2026/06/09)¶
FTSessionReplayConfig.enableSwiftUIを追加しました。Session Replay の SwiftUI 録画機能を明示的に有効化します。デフォルトは無効です。- iOS Session Replay Segment アップロード時のカスタム
source値のサポートを追加しました。Flutter Session Replay シナリオに対応します。 - 動的な
UIColor解析による Session Replay のクラッシュ問題を修正し、バックグラウンドスナップショット処理と SwiftUI 録画の安定性を最適化しました。 - サンプリング状態変更後の Session Replay データキャッシュ処理を最適化し、誤ったサンプリング有効化後に録画が開始されない問題を修正しました。録画の連続性と安定性を向上させました。
- Session Replay、RUM、Log のアップロードスケジューリングとリトライ処理を最適化しました。
- Session Replay のレンダリング正確性とパフォーマンスを最適化しました。ノードのフラット化、スナップショット処理キューの優先順位、View Tree のプライバシーオーバーライドの継承、サポートされていないプレースホルダーのトリミングを含みます。
- RUM View の時間とアップロードパッケージの一貫性の問題を修正しました。イベント時間を保持し、パッケージ ID 生成前に View データを重複排除することで対応しました。
1.6.4 (2026/05/21)¶
- SwiftUI ビューの Session Replay をサポートしました。
- RUM SwiftUI ビュートラッキングと手動クリック Action トラッキングをサポートしました。
- コールドスタート Action に
app_launch_typeフィールドを追加しました。フォアグラウンド起動とバックグラウンド起動を区別します。 FTMobileConfig.enableDataFilterとFTMobileConfig.dataFiltersを追加しました。SDK 側の DataFilter を有効化し、ローカルのブラックリストルールを設定できます。DataFilter ルールはlineDataModifierの後、ローカルキャッシュ書き込みの前に実行されます。- アップロード Worker のシャットダウン分離、アップロードコールバックの同期、RUM アップロード動作を最適化しました。重複アップロード、期限切れリトライループ、アップロード実行の競合を回避し、アップロード時に重複する View データをスキップします。
- RUM プレースホルダー View の処理をフォールバック View の解決に置き換え、元の View が利用できない場合の View トラッキングの一貫性を向上させました。
- プリセット属性タグの nil、空値、ユーザー情報更新時の処理を最適化しました。
1.6.3 (2026/04/30)¶
view_long_task_rateを追加しました。RUM View のページカクツキ率を統計します。- RUM Resource データに
network_availableフィールドを追加しました。リソース開始時のネットワーク可用性スナップショットを記録します。 - RUM クラッシュデータに、アプリ状態統計からのクラッシュ継続時間フィールドを追加しました。
foreground_crash_free_durationおよびbackground_crash_free_durationです。 - Session Replay リソースアップロードに連携 RUM Key のサポートを追加しました。
- データアップロードリクエストの圧縮をデフォルトで有効にしました。
- ロングタスク検出器における NSDate の競合問題を修正しました。
- WKWebView bridge のロックと重複有効化処理の問題を修正し、WebView RUM / Session Replay の安定性を向上させました。
- Session Replay が WebView ノードデータを処理する際に、ローカル CSS インジェクションが失敗する可能性がある問題を修正しました。
1.6.2 (2026/04/17)¶
- Session Replay 機能を追加しました。WebView Session Replay をサポートします。
- Session Replay と RUM コンテキストの連携機能を追加しました。WebView コンテナと、ロードされた HTML コンテンツのコンテキストを関連付けることができます。
- Session Replay のエラーサンプリング機能を追加し、リモート設定による動的な Session Replay 制御をサポートしました。
- Session Replay の画像リソースアップロード機能を追加しました。
- Session Replay は、
touchPrivacy、textAndInputPrivacy、imagePrivacyによるタッチ、テキストと入力、画像のプライバシー設定をサポートし、sessionReplayPrivacyOverridesによる個別 UIView のビューレベルプライバシーオーバーライドもサポートします。
1.5.21 (2026/04/15)¶
setDatakitURL:、setDatawayURL:clientToken:メソッドを追加しました。実行時の動的なエンドポイント更新をサポートします。- 最小デプロイバージョンを iOS 12+、macOS 10.14+ に調整しました。
addAction:呼び出し時の View 関連付け失敗の問題を修正しました。- Log と RUM の関連付けロジックを最適化し、欠落していた
action_idフィールドを補完しました。 - RemoteConfig のプル間隔ロジックを修正しました。SDK 起動時にローカルの前回リクエスト時間を使用してリクエスト間隔を検証します。
- サンプリングレートの動的変更が反映されない問題を修正しました。
1.5.20 (2026/02/26)¶
FTPresetPropertyにおける並行読み書きの問題を修正しました。ディクショナリの破損と重複解放によるクラッシュを回避します。- SDK 内の SQLite で WAL モードを有効化しました。
- 非推奨の
SCNetworkReachabilityをNWPathMonitorに置き換えました。 - 非推奨 API
UIScreen.mainScreenの使用を削除しました。 FTMobileConfig.dataModifierの処理ロジックを修正し、すべてのデータエントリをカバーするようにしました。
1.5.19 (2026/01/09)¶
resource_typeを拡張し、image、media、font、CSS、JS、native タイプを追加しました。- ネットワークエラーに
resource_idを追加しました。対応するリソースデータとの関連付けに使用します。 FTMobileConfig.remoteConfigFetchCompletionBlockまたは+updateRemoteConfigWithMiniUpdateInterval:completion:メソッドのコールバックを介して、リモート変数のカスタム解析と設定をサポートしました。- Resource に
resource_http_protocol、resource_request_size、resource_connection_reuseフィールドを追加しました。 - コールドスタートとウォームスタートの時間指標を詳細化し、
app_pre_runtime_init_time、app_runtime_init_time、app_uikit_init_time、app_application_init_time、app_first_frame_init_timeを追加しました。 - RUM View の欠落によるデータ損失の問題を修正しました。
- クラッシュおよび ANR のスタックトレース機能を強化し、全スレッド情報収集をサポートしました。
FTRumConfig.crashMonitoringでクラッシュ監視タイプを設定できます。
1.5.18 (2025/08/08)¶
FTRumConfig.viewTrackingHandlerとFTRumConfig.actionTrackingHandlerを介した RUM View/Action 収集フィルタリング、カスタム View/Action 名をサポートしました。- メソッド
-updateViewLoadingTime:を追加しました。現在アクティブな RUM View のロード時間を更新できます。 - ログデータの
sdk_nameフィールド欠落問題を修正しました。 - WebView データ収集における UserScripts の競合問題を修正しました。
- SDK シャットダウン操作のスレッドセーフティ問題を修正しました。
- ロングタスク監視時にメインスレッドの名前を変更することで発生するクラッシュを修正しました。
FTRumConfig.h/.mファイルを追加し、FTRumConfigをFTMobileConfig.hから独立したファイルに分割しました。
1.5.17 (2025/06/11)¶
FTRUMConfig.enableTraceWebViewを追加しました。SDK を介した WebView データ収集を有効にするかどうかを設定します。FTRUMConfig.allowWebViewHostでフィルタリングするホストアドレスを制御できます。FTRumConfig.sessionTaskErrorFilterを追加しました。ローカルネットワークエラーをフィルタリングできます。FTMobileConfig.remoteConfigurationを追加しました。リモート条件設定機能を有効にします。FTMobileConfig.remoteConfigMiniUpdateIntervalで、リモート制御を有効にした後の最短更新間隔を設定できます。
1.5.16 (2025/05/16)¶
FTMobileConfig.lineDataModifier、FTMobileConfig.dataModifierを追加しました。データ書き込み置換をサポートし、データマスキングを可能にします。FTRUMConfig.sessionErrorSampleRateを追加しました。エラーサンプリングをサポートします。sampleRate でサンプリングされなかった場合、エラー発生時に 1 分前の RUM データをサンプリング収集できます。- Logger は
logLevelFilterによるカスタムログレベルのフィルタリングをサポートします。 - ネイティブページから WebView ページに遷移する際、ネイティブページ名で
view_referrerを埋めます。
1.5.15 (2025/04/14)¶
- Swift Package Manager のコンパイルエラーを修正しました。
1.5.14 (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をデフォルトで有効にしました。- マクロ定義
FT_DISABLE_SWIZZLING_RESOURCEによる SDK 内の URLSession Method Swizzling の無効化をサポートしました。 - データ同期を最適化し、失敗時の再送ロジックを追加しました。
1.5.13 (2025/02/27)¶
- ページ収集ロジックを最適化し、特殊なビューによる RUM View 収集の欠落を防止しました。
1.5.12 (2025/02/10)¶
- ファイル保存パス設定を調整し、tvOS 環境でのデータベース作成失敗を修正しました。
- tvOS 環境のデフォルト
serviceおよびログsourceを更新し、それぞれdf_rum_tvosおよびdf_rum_tvos_logに設定しました。 - RUM Action イベントの
duration時間計算の不正確さを修正しました。
1.5.11 (2025/02/05)¶
- RUM Resource 収集を最適化し、RUM の Resource 自動収集が有効な場合に SDK 内のリクエストを収集しないようにしました。
- Widget Extension における skyWalking タイプの分散型トレーシング失敗問題を修正しました。
1.5.10 (2025/01/21)¶
FTTraceConfig.traceInterceptorによる Request のインターセプトとカスタムトレースをサポートしました。FTRumConfig.resourcePropertyProviderによる RUM Resource カスタム属性の追加をサポートしました。- 動的グローバル属性追加メソッドのマルチスレッドアクセス時における異常を修正しました。
- WebView に渡すデータ情報を最適化しました。
1.5.9 (2025/01/08)¶
FTURLSessionDelegate.traceInterceptorblock によるURLRequestのインターセプトと、カスタム分散トレーシング、spanId および traceId の変更をサポートしました。- RUM Resource は、swift async/await URLSession API を使用して開始されたネットワークリクエストの収集をサポートしました。
- LongTask と ANR の関連 View エラーを修正しました。
1.5.8 (2024/12/23)¶
- tvOS のサポートを追加しました。
FTRUMConfig.rumCacheLimitCountによる RUM 最大キャッシュエントリ数の制限をサポートしました。FTRUMConfig.rumDiscardTypeによる破棄ポリシーの設定をサポートしました。FTMobileConfig.enableLimitWithDbSizeによる総キャッシュサイズ制限機能をサポートしました。有効にすると、FTLoggerConfig.logCacheLimitCountおよびFTRUMConfig.rumCacheLimitCountは無効になります。FTMobileConfig.dbDiscardTypeによる DB 破棄ポリシーの設定、FTMobileConfig.dbCacheLimitによる DB キャッシュ制限サイズの設定をサポートしました。
1.5.7 (2024/12/04)¶
FTRUMConfig.freezeDurationMsによるカクツキ検出しきい値の設定をサポートしました。- SDK の
shutDownメソッドを最適化し、メインスレッドの同期待機によるカクツキや WatchDog クラッシュを回避しました。
1.5.6 (2024/11/13)¶
FTMobileConfig.compressIntakeRequestsを使用した同期データの deflate 圧縮設定をサポートしました。- RUM に
addAction:actionType:propertyとstartAction:actionType:property:メソッドを追加し、 RUM Action 収集ロジックを最適化しました。 - NSFileHandle の非推奨 API 使用によるクラッシュを修正しました。
1.5.5 (2024/11/06)¶
FTResourceMetricsModelにおける配列範囲外アクセスによるクラッシュを修正しました。
1.5.4 (2024/10/18)¶
- グローバル、log、RUM globalContext 属性の動的設定方法を追加しました。
- データクリアメソッドを追加しました。まだサーバーにアップロードされていないすべてのデータを削除できます。
- 同期間隔でサポートされる最大時間間隔を 5000 ミリ秒に調整しました。
1.5.3 (2024/10/09)¶
- LongTask、ANR 収集時に、属性修飾子の誤用によるメモリアクセスエラーのクラッシュを修正しました。
FTSwizzler内のメソッドシグネチャ検証アサーションを内部警告ログに置き換えました。- 収集データの小数点精度を最適化しました。
1.5.2 (2024/08/21)¶
- Xcode 16 での
#include <arm/_mcontext.h>ヘッダーファイル欠落によるコンパイルエラーを修正しました。 - 自動収集 RUM-Resource 時に、ローカルキャッシュから直接取得された、または取得タイプが不明な Resource をフィルタリングし、重複収集を防止しました。
- UITabBarController の子ビューにおける loadingTime 計算ロジックを修正しました。
1.5.1 (2024/08/02)¶
- 行プロトコルデータのエスケープアルゴリズムを修正し、改行によるデータ同期失敗を解決しました。
- エラータイプ
network_errorのエラーメッセージを最適化し、ネットワークリクエストエラーコードの説明を統一して英語で記述するようにしました。 - データ同期ロジックを最適化し、マルチスレッドアクセスで解放済みの
uploadDelayTimerにアクセスすることによるクラッシュを修正しました。 - クラッシュ情報収集時の OC と C の文字列変換におけるエンコーディング形式の誤りによるクラッシュを修正しました。
1.5.0 (2024/06/03)¶
- RUM Resource ネットワークリクエストにリモート IP アドレス解決機能を追加しました。
- 行プロトコル Integer データ互換モードを追加し、Web データ型の競合問題を処理します。
- ログにカスタム status メソッドを追加しました。
- ログデータ書き込みの最適化、データ同期の最適化。
- SDK に渡される NSDictionary 型パラメータの形式を処理し、JSON 変換失敗によるデータ損失を防止します。
1.4.14 (2024/05/29)¶
FTSwizzler内で、破棄された Class オブジェクトにアクセスすることによるメモリアクセスエラーのクラッシュを修正しました。- SDK に渡される NSDictionary 型パラメータが実際には可変オブジェクトである場合に発生する可能性がある、データ一貫性と操作の競合問題を修正しました。
1.4.13 (2024/05/15)¶
- RUM LongTask、ANR 収集を最適化し、LongTask のスタック情報収集の不正確さを修正しました。致命的なカクツキ収集を新たにサポートしました。
FTSwizzler内で、マルチスレッドによる NSMutableSet の同時操作によるクラッシュを修正しました。- SDK Framework info.plist のバージョン情報欠落問題を修正しました。
- カスタム NSURLSession に delegate が設定されていない場合の Resource パフォーマンス指標収集失敗を修正しました。
- SDK 内部ログのファイル出力機能を最適化し、ファイルパス指定メソッドを追加しました。
1.4.12 (2024/04/26)¶
- SDK のシャットダウンメソッド shutDown 呼び出しによるメモリリーク問題を修正しました。
- RUM-Resource 収集時の他のライブラリとの競合によるクラッシュを修正しました。
- クラッシュ収集時の UncaughtExceptionHandler 未転送問題を修正しました。
- SDK の複数回初期化によるデータ異常を修正しました。
1.4.11(2024/03/28)¶
- データ同期パラメータ設定、リクエストエントリ数、同期間隔時間、およびログキャッシュエントリ数をサポートしました。
- 内部ログのファイル出力メソッドを追加しました。
- ログが RUM データを関連付ける際の取得エラーを修正しました。
- 時間のかかる操作の最適化。
- WebView jsBridge 時のクラッシュを修正しました。WebView への参照を弱参照に変更しました。