Skip to Content
その他のツールとアダプター診断ツール

診断ツールと電源管理

バックグラウンドの地理位置情報のデバッグは、特に積極的なバッテリー セーバーを備えた断片化された Android デバイスでは難しいことで知られています。 Tracelet は、エンジンの動作を視覚化し、OEM の制限を軽減するのに役立つ一連のツールを提供します。

トレーレットドクター

Tracelet Doctor (tracelet_doctor) は、Tracelet エンジンの内部状態をリアルタイムで視覚化するドロップイン UI ダッシュボードです。フィールドテストには必須です。

🩺

Tracelet Doctor を実稼働環境の通常のエンドユーザーに展開しないでください。非表示の開発者メニューでエントリ ポイントを保護します (バージョン番号を 7 回タップするなど)。

インストール

Tracelet Doctor は デバッグ ツールであるため、開発依存関係として追加します。 定期的な依存関係。 Flutter は開発依存パッケージをリリース ビルドから除外します。 Doctor は、ユーザーに配布するものから自動的に除外されます。

flutter pub add dev:tracelet_doctor

これにより、pubspec.yaml の dev_dependencies に追加されます。

dev_dependencies:
  tracelet_doctor: ^3.6.6

統合

これは開発依存関係であるため、それへのすべての参照を kDebugMode の背後で保護してください。 import is tree-shaken out of release builds and your app still compiles in release mode:

import 'package:flutter/foundation.dart' show kDebugMode;
import 'package:tracelet_doctor/tracelet_doctor.dart';
 
// Show the interactive diagnostic overlay — debug builds only:
if (kDebugMode) {
  TraceletDoctor.show(context);
}

コア機能

ダッシュボードには、デバッグ用に 5 つの重要なタブが用意されています。

  1. 概要ダッシュボード リアルタイムの isMoving 状態、現在の GPS 座標、精度 (メートル単位)、バッテリー レベル、およびアクティブな TraceletProfile を表示します。エンジンが STATIONARY 状態にある場合、この画面には GPS ハードウェアの電源がオフであることが明示的に表示されます。

  2. ジオフェンス ライブ マップ 現在の場所、stationaryRadius 境界、および登録されているすべてのジオフェンス (円形および複雑なポリゴン ゾーンの両方) をレンダリングするビジュアル マップ。重要なのは、geofenceProximityRadius を視覚化することで、移動に応じてジオフェンスが動的にロードおよびアンロードされていることを確認できることです。

  3. データベースインスペクター 生の SQLite 行を直接検査します。 HTTP 同期のためにキューに入れられているロケーションの数を確認し、デルタ圧縮ロジックが座標を正常に縮小したかどうかを確認し、手動でフラッシュをトリガーすることができます。

  4. ログコンソール 色分けされたネイティブ SDK ログのライブ ストリーム (トレース、デバッグ、情報、警告、エラー)。ここでは、エンジンが次のような決定を行っていることがわかります: 「時速 100 マイルを検出、距離フィルターを 50 メートルに延長」。

  5. 構成インスペクター JSON ツリー ビューアには、現在ネイティブ エンジンに挿入されている正確な Config オブジェクトが表示され、Dart 設定がプラットフォーム チャネルを正常に通過していることが確認されます。

OEM 電源マネージャー (設定の健全性)

中国の OEM (Xiaomi、Huawei、Oppo、Vivo、OnePlus) は、標準の Android フォアグラウンド サービス ルールを完全に無視する、非常に攻撃的な独自のバッテリー マネージャーを出荷しています。

Tracelet がこれらのデバイスをどのように処理するか、およびどのメーカーがサポートされているかを確認するには、専用の OEM 電源管理 📖 ガイドをお読みください。

APIリファレンススーパーベース