更新履歴¶
1.6.9 (2026/11/15)¶
- 自動収集される Long Task と ANR は、デフォルトでバックグラウンドのスタッターをフィルタリングし、ANR はスタッター開始時点のアプリ状態を保持します。あわせて、スタッター計測の精度、収集済みスタックの保持、モニタリング起動の信頼性を最適化しました。
FTRumConfig.enableTraceUserViewLoadingTimeとviewLoadingTimeClassNameExcludesを追加し、グローバルまたはコントローラクラス単位でページ読み込み時間の自動収集を無効化できるようにしました。RUM View の追跡は維持されます。詳細はページ読み込み時間の収集制御を参照してください。- RUM Resource に
network_signal_strengthを追加し、iOS 26、tvOS 26、macOS 26 以降のシステムでネットワークリンク品質を報告します。ネットワーク状態は Resource 開始時に収集されます。 - RUM の
custom_keysマーキングを改善し、グローバルカスタムコンテキスト、ユーザー拡張属性、イベントカスタム属性を補完しました。 - RUM のコールドスタートのソース識別を修正し、フォアグラウンド起動がバックグラウンドへの切り替えによって中断された場合、
app_launch_typeにforeground_and_background分類を追加しました。 - セルラーネットワークタイプの識別を修正し、現在データ通信サービスを提供している SIM カードを使用してネットワークタイプを判定するようにしました。
- iOS アプリが Mac 上で動作している場合のデバイスモデル報告を修正し、ホスト Mac のモデルを使用するようにしました。
- Session Replay の遅延起動時の RUM コンテキスト関連付けを修正し、録画開始時に既存のセッションとページを関連付けられるようにしました。
- 起動初期にクラッシュが発生した場合、次回起動時の初回自動アップロードの待機時間を短縮し、クラッシュ履歴の永続化とアップロードスケジューリングの信頼性を向上しました。
- 自動収集時の Swizzle 診断シンボル照会を削除し、SDK Debug ビルド時の起動オーバーヘッドを低減しました。Swizzle デバッグログはデフォルトで無効で、
[FTLog enableSwizzleLog:YES]による明示的な有効化と、SDK Debug ログの同時有効化が必要です。 - カスタムの起動プレウォーム識別設定
launchPrewarmInterval(デフォルト無効)と手動検出インターフェースを追加し、プレウォーム起動の所要時間補正とタイムライン調整を改善しました。詳細は起動プレウォームの識別を参照してください。 - SDK shutdown 後に再初期化した際に初回起動が重複報告される問題を修正し、同一プロセスでは初回起動 Action を 1 回だけ報告し、再初期化後も以降のホットスタートの監視を継続するようにしました。
1.6.8 (2026/10/22)¶
- 非互換変更(Breaking):サポートする最小バージョンを iOS 15、tvOS 15、macOS 12 に引き上げました。iOS/tvOS の最小サポートバージョンは Xcode 26 のデプロイメントターゲット範囲に合わせています。Apple の提出要件によると、2026 年 4 月 28 日以降、App Store Connect にアップロードする iOS/tvOS アプリは、Xcode 26 以降および対応する iOS 26/tvOS 26 SDK でビルドする必要があります。Xcode 26 がサポートする最小デプロイメントターゲットは iOS 15、tvOS 15 です。アップグレード手順は1.6.8 アップグレード要件を参照してください。
- 任意で有効化できる SDK 管理のビジター ID 機能を追加しました。
FTRumConfig.visitorIDConfigで設定でき、カスタム TTL、一致する URLSession リクエストへのリクエストヘッダー自動注入、ネイティブ RUM との関連付け、手動リセット、ホストホワイトリストに基づく WebView 間のビジター ID 連携をサポートします。 - RUM ビューメトリクス
interaction_to_next_view_timeとnetwork_settled_timeを追加しました。それぞれ、クリックインタラクションから次のビュー起動までの所要時間、ビュー起動後に最初のネットワークリクエスト群が完了するまでの所要時間を集計します。FTRumConfig.nextViewActionPredicateとnetworkSettledResourcePredicateでマッチングルールを設定できます。 - NSURLConnection の RUM リソースの自動収集と分散型トレーシングの関連付けを追加しました。スイッチは
FTRumConfig.enableTraceURLConnectionResourceとFTTraceConfig.enableAutoTraceURLConnectionで、いずれもデフォルトは無効です。 - WebView ログブリッジ機能
FTLoggerConfig.enableWebViewLogを追加しました。Browser Logger API、コンソールログ、JS エラーログの収集をサポートし、ホストホワイトリストを再利用し、リモート設定にも対応します。 - macOS Electron の RUM とセッションリプレイの接続を追加しました。フルモード、ネイティブ管理のハイブリッドモード、マルチプロセス分離を含み、Universal アーキテクチャのネイティブパッケージを配布します。
FTSDKAgent.shutDown呼び出し時にセッションリプレイを自動的に停止します:録画と報告を停止します。- RUM / Log / Trace / Session Replay のサンプリング API を統一し、小数パーセントのサンプリングをサポートしました。非推奨インターフェースおよび旧バージョンのリモート設定ロジックと互換性があります。
- View、Resource、LongTask に、イベント発生区間に基づく
app_stateを追加し、ネイティブ RUM イベントにsession_start_reasonを追加しました。遅延して完了したリクエスト、キャッシュデータ、および過去の ANR が所属セッションの起動理由を保持できるようにします。この情報がない旧キャッシュはunknownを使用します。アプリのフォアグラウンド/バックグラウンド切り替え時の View と Action の処理ロジックを最適化しました。 - RUM リソースの時系列、WebSocket ハンドシェイク失敗の分類問題を修正しました。リクエスト送信が非同期の分散型トレーシング保存処理でブロックされることを回避します。
- 遅延スケジューリング時のロングタスク検出を最適化し、RunLoop 状態更新時にメインスレッドのブロックを回避しました。セッション更新後に ANR が重複報告される問題を修正しました。
- データの継続的な書き込みにより自動アップロードが無限に遅延する問題を修正し、ネットワーク接続状態の更新ロジックを修正しました。
- 汎用の外部 Session Replay 接続インターフェースを追加し、フレームワークやエンジンのレコーダーが RUM コンテキスト、シャードストレージ、画像リソース、リプレイメタデータを再利用できるようにし、ネイティブレコーダーの一時停止と再開を調整します。
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と Log のsourceタグを統一しました。 - Session Replay のリソースチェックとアップロードで RUM コンテキストの関連付けをサポートしました。
FTSessionReplayConfig.enableLinkRUMKeysで伝達する RUM globalContext フィールドを選択し、同じリソースが異なる関連コンテキストで正しくルーティングされ、個別に保持され、重複排除されることを保証します。 - フォールバック View、アプリ起動、初回フレーム追跡、遅延した初期 Action、セッション期限切れなどのシナリオにおける 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 のプライバシー上書き継承、unsupported placeholder のトリミングが含まれます
- RUM View の時間とアップロードパッケージの整合性問題を修正し、イベント時刻を保持したうえで package ID 生成前に View データを重複排除するようにしました
1.6.4 (2026/05/21)¶
- SwiftUI ビューの Session Replay サポートを追加しました
- RUM の SwiftUI ビュー追跡と手動クリック Action 追跡のサポートを追加しました
- コールドスタート Action に
app_launch_typeフィールドを追加し、フォアグラウンド起動とバックグラウンド起動を区別できるようにしました - ブラックリストフィルタ機能を追加し、ローカルキャッシュへの書き込み前に Log と RUM データをフィルタできるようにしました。ルールは
FTMobileConfig.dataFiltersでアプリ内で設定でき、Guance ワークスペースのブラックリストから自動的に取得することもでき、両方の方式が同時に有効になります。この機能はデフォルトで有効で、FTMobileConfig.enableDataFilter = NOにより SDK 側のフィルタを無効化できます。フィルタルールは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 終了操作のスレッドセーフティ問題を修正しました
- Long task 監視時にメインスレッドの名前を変更することで発生するクラッシュ問題を修正しました
FTRumConfig.h/.mファイルを追加し、FTRumConfigをFTMobileConfig.hから独立したファイルに分割しました
1.5.17 (2025/06/11)¶
-
FTRUMConfig.enableTraceWebViewを追加し、SDK による webview データ収集を有効化するかどうかを設定できるようにしました。FTRUMConfig.allowWebViewHostでフィルタ対象の host アドレスを制御できます -
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 をインターセプトして Trace をカスタマイズできるようにし、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 のネットワークリクエストに remote 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 の参照を弱参照に変更しました