Skip to Content
Otras herramientas y adaptadoresHerramientas de diagnóstico

Herramientas de diagnóstico y administración de energía

Depurar la geolocalización en segundo plano es muy difícil, especialmente en dispositivos Android fragmentados con ahorros de batería agresivos. Tracelet proporciona un conjunto de herramientas para ayudarle a visualizar lo que está haciendo el motor y mitigar las restricciones del OEM.

Médico de trazas

Tracelet Doctor (tracelet_doctor) es un panel de interfaz de usuario directo que visualiza el estado interno del motor Tracelet en tiempo real. Es esencial para las pruebas de campo.

🩺

Nunca implemente Tracelet Doctor para usuarios finales habituales en producción. Proteja el punto de entrada con un menú de desarrollador oculto (por ejemplo, tocando el número de versión 7 veces).

Instalación

Tracelet Doctor es una herramienta de depuración, así que agréguela como una dependencia de desarrollo, no una dependencia regular. Flutter excluye los paquetes de dependencia de desarrollo de las versiones de lanzamiento, por lo que El Doctor se mantiene automáticamente fuera de lo que usted envía a los usuarios:

flutter pub add dev:tracelet_doctor

Esto lo agrega bajo dev_dependencies en su pubspec.yaml:

dev_dependencies:
  tracelet_doctor: ^3.6.6

Integración

Debido a que es una dependencia de desarrollo, guarde cada referencia detrás de kDebugMode para que 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);
}

Características principales

El panel proporciona 5 pestañas cruciales para la depuración:

  1. Panel de descripción general Muestra el estado de isMoving en tiempo real, las coordenadas GPS actuales, la precisión (en metros), el nivel de la batería y el TraceletProfile activo. Si el motor está en el estado STATIONARY, esta pantalla mostrará explícitamente que el hardware del GPS está apagado.

  2. Mapa en vivo de geocerca Un mapa visual que representa su ubicación actual, los límites de stationaryRadius y todas las Geocercas registradas (tanto zonas circulares como poligonales complejas). Fundamentalmente, visualiza geofenceProximityRadius para que pueda verificar que las geocercas se cargan y descargan dinámicamente a medida que se mueve.

  3. Inspector de bases de datos Inspeccione directamente las filas SQLite sin procesar. Puede ver cuántas ubicaciones están en cola para la sincronización HTTP, verificar si la lógica de compresión delta redujo correctamente las coordenadas y activar manualmente una descarga.

  4. Consola de registro Una secuencia en vivo codificada por colores de los registros nativos del SDK (rastreo, depuración, información, advertencia, error). Aquí es donde puedes ver el motor tomando decisiones: “Detectado 65 mph, ampliando el filtro de distancia a 50 m”.

  5. Inspector de configuración Un visor de árbol JSON que muestra el objeto Config exacto actualmente inyectado en el motor nativo, lo que garantiza que su configuración de Dart cruzó con éxito el canal de la plataforma.

OEM Power Manager (Estado de la configuración)

Los fabricantes de equipos originales chinos (Xiaomi, Huawei, Oppo, Vivo, OnePlus) vienen con administradores de batería patentados y muy agresivos que ignoran por completo las reglas estándar de servicio en primer plano de Android.

Para ver cómo Tracelet maneja estos dispositivos y qué fabricantes son compatibles, lea nuestra guía dedicada OEM Power Management 📖.

Referencia de APISupabase