Documentazione / Collega / Collega le tue app

Dart / Flutter

Il pacchetto closeyourit cattura gli errori delle app Flutter, anche quando il telefono è senza rete.

Cosa raccoglie

Da solo:

le eccezioni non gestite dell'app;
utente, etichette e la cronologia prima dell'errore.

Se lo chiedi tu:

i log, con CloseYourIt.log;
i metodi lenti, con measure();
i problemi di performance: scatti dell'interfaccia, troppi ridisegni, chiamate HTTP lente o ripetute;
la telemetria d'uso.

Un errore capitato senza rete viene salvato sul dispositivo e rispedito al prossimo avvio.

Installa

flutter pub add closeyourit

Configura

await CloseYourIt.init(
  CloseYourItOptions(
    endpointUrl: "https://bugs.example.com",
    publicKey: "<chiave pubblica>",
    projectId: "<id del progetto>",
  ),
  appRunner: () => runApp(const MyApp()),
);

appRunner avvia l’app in una zona protetta per raccogliere eccezioni Dart. Flutter web e mobile rientrano nel piano, entro i limiti documentati. I crash nativi iOS/Android richiedono integrazioni separate ancora in sviluppo; i client desktop restano fuori ambito.

Da sapere

Un’app distribuita usa publicKey, mai un token segreto. Dalla versione 0.9.3 invia errori, log, measure() e i quattro controlli facoltativi delle prestazioni. La 0.8.3 e le precedenti inviano solo gli errori pubblici.

Log e metriche fanno un solo tentativo di invio, senza coda offline né nuovi tentativi automatici. La coda offline esistente riguarda gli errori. La telemetria d’uso resta solo lato server.