Panoramica
Dartastic le mostra cosa fanno davvero le sue app Dart e Flutter nelle mani dei suoi utenti, e la aiuta a correggere ciò che non va. Questa pagina è la mappa. La legga una volta, poi segua Primi passi passo dopo passo.
La piattaforma
Ogni pagina della Guida mostra questa stessa immagine, con evidenziate le parti di cui tratta, così sa sempre dove si trova.
- Sviluppa sul suo computer e nella sua CI. La sua app riceve i pacchetti Dartastic da Dartastic Pub, nello stesso modo in cui riceve i pacchetti da pub.dev.
- La sua app viene eseguita su telefoni e desktop, nei browser e come server Dart. I pacchetti Dartastic OTel al suo interno registrano ciò che accade e lo inviano all’Observatory.
- Quando qualcosa si rompe, il Symbolizer riporta il crash al suo file e alla sua riga, usando i simboli che ha pubblicato su Pub insieme all’app.
- Quando vuole sapere perché, chiede a Dartastic AI. Legge la telemetria e il suo codice sorgente su Pub, e risponde con la causa e una correzione.
- La Control Room è dove configura tutto questo: crea i token che aprono ogni freccia del diagramma.
I componenti
| Componente | Cosa fa | Dove lo trova |
|---|---|---|
| Control Room | Il suo account. Qui crea i token, invita i colleghi, sceglie il piano e scarica la Reference Demo. | dartastic.io/control-room, dopo l’accesso |
| Dartastic Pub | Un registro privato di pacchetti che funziona come pub.dev. Da qui riceve i pacchetti Dartastic, vi conserva i suoi pacchetti privati e vi pubblica il codice sorgente della sua app. | dart pub get, dart pub publish |
| Dartastic OTel | I pacchetti che aggiunge alla sua app. Registrano ciò che vi accade (schermate, tap, chiamate di rete, errori, crash, prestazioni) come OpenTelemetry e lo inviano. | Il suo pubspec.yaml e il suo main() |
| Observatory | Dove guarda. Sessioni con replay, tracce, log, metriche, crash, dashboard e avvisi per tutto ciò che inviano le sue app. | Si apre dalla Control Room |
| Symbolizer | Riporta gli stack trace illeggibili di una build di release offuscata ai nomi dei suoi file e ai numeri di riga. Funziona da solo, man mano che arrivano i crash. | Nulla da chiamare: legge i simboli che pubblica su Pub |
| Dartastic AI | Risponde in linguaggio naturale alle domande sulla sua app. Legge la sua telemetria e il suo codice sorgente su Pub, trova la causa e propone la correzione. | Il pulsante « Ask » nell’Observatory e nella Control Room |
Cosa vedrà
Ecco l’Observatory. Ogni sessione dei suoi utenti è elencata con le sue schermate, i tap, gli errori e i segnali di frustrazione:

Ne apra una e la riproduca. Sotto l’indicatore di riproduzione vede la traccia, i log e l’errore in quel momento, e può passare direttamente alla riga di codice:

I token collegano i componenti
Ogni freccia del diagramma richiede un proprio tipo di token. Li crea nella Control Room, e ognuno le viene mostrato una sola volta, quindi lo copi quando lo crea. La maggior parte degli sviluppatori non ha mai usato un token con dart pub; la pagina Pub la guida passo passo.
| Token | Da | A | Consente |
|---|---|---|---|
| Token Pub | Il suo computer | Dartastic Pub | dart pub get può scaricare i pacchetti Dartastic e quelli privati; dart pub publish può caricarli. |
| Scambio CI | La sua CI | Dartastic Pub | La sua CI legge e pubblica pacchetti senza alcun token memorizzato. |
| Token OTLP | La sua app su telefono o desktop, il suo server Dart | Observatory | La sua app può inviare telemetria. |
| Token Browser OTLP | La sua app Flutter web | Observatory | La sua app web può inviare telemetria, solo dai siti web che elenca. |
Ogni token in suo possesso è elencato in un’unica schermata. Token spiega ogni tipo, e come revocarne o sostituirne uno.
Dove funziona: il suo piano
- Cloud funziona su un’infrastruttura che Dartastic condivide tra i clienti. Il suo Pub è
pub.dartastic.io. - Dedicated dà alla sua organizzazione un server proprio, su un sottodominio a sua scelta: il suo Pub è
pub.<subdomain>.dartastic.io. - Self-Hosted esegue l’intera piattaforma all’interno della sua rete.
I passaggi sono gli stessi con ogni piano. Dove un URL cambia, queste pagine li mostrano entrambi. Confrontare i piani.
Cosa serve
- Flutter 3.44 e Dart 3.12 o successivi per tutte le funzionalità; Flutter 3.22 e Dart 3.4 per tutto tranne le metriche Flutter. Quali versioni richiede ogni pacchetto.
- Un account Dartastic: la registrazione è gratuita. Con la registrazione, la sua organizzazione parte su Cloud Free, senza carta.
- Solo per il backend meteo della Reference Demo: Docker.
Come imparare
Scelga il modo che preferisce; trattano gli stessi argomenti.
- Legga queste pagine in ordine. « Precedente » e « Successiva » in fondo a ogni pagina la guidano nel percorso.
- Esegua la Dartastic OTel Reference Demo. È la versione commerciale avanzata della Dart OTel Reference Demo open source: molte più demo, app Flutter funzionanti che mostrano come usare ogni funzionalità di Dartastic, con la configurazione già fatta. Ne legga il codice, lo copi, o lo indichi al suo assistente di programmazione IA. Ottenere la Reference Demo.
- Chieda: il supporto risponde alle domande.
Termini usati in queste pagine
- OpenTelemetry (OTel)
- Lo standard aperto per registrare ciò che fa il software. Dartastic lo parla da un capo all’altro, quindi nulla di ciò che scrive è legato a Dartastic.
- OTLP
- Il formato di trasmissione di OpenTelemetry: il modo in cui la sua app invia ciò che ha registrato.
- Traccia e span
- Uno span è un singolo lavoro cronometrato (un tap, una chiamata di rete, una query al database). Una traccia è l’albero degli span di una singola operazione, anche tra la sua app e il suo server.
- Log
- Una riga di testo scritta dalla sua app, legata alla traccia in cui è avvenuta.
- Metrica
- Un numero misurato nel tempo: tempi dei frame, memoria, numero di richieste.
- Sessione
- La visita di una persona alla sua app, dall’avvio all’uscita, con ogni schermata, tap, errore e traccia.
- Replay
- Rivedere una sessione. Sceglie lei quanto catturare: una timeline di eventi, un wireframe o i pixel reali.
- RUM
- Real User Monitoring, monitoraggio degli utenti reali: la telemetria delle persone che usano davvero la sua app, a differenza dei test.
- Offuscamento e simboli
- Una build di release può rendere illeggibili i suoi nomi (flutter build --obfuscate). Il file dei simboli che produce (--split-debug-info) è la chiave per renderli di nuovo leggibili.
- Token
- Una lunga stringa segreta che permette a una cosa di comunicare con un’altra. Ogni tipo apre un percorso nel diagramma qui sopra.