Przegląd
Dartastic pokazuje, co aplikacje Dart i Flutter naprawdę robią w rękach użytkowników, i pomaga naprawić to, co nie działa. Ta strona jest mapą. Wystarczy przeczytać ją raz, a potem przejść krok po kroku przez stronę Pierwsze kroki.
Platforma
Każda strona Pomocy pokazuje ten sam schemat z podświetlonymi częściami, których dotyczy, więc zawsze wiadomo, o którym miejscu platformy mowa.
- Budowanie odbywa się na komputerze i w CI. Aplikacja pobiera pakiety Dartastic z Dartastic Pub tak samo, jak pobiera pakiety z pub.dev.
- Aplikacja działa na telefonach i komputerach, w przeglądarkach i jako serwery Dart. Pakiety Dartastic OTel w aplikacji rejestrują, co się dzieje, i wysyłają to do Observatory.
- Gdy coś się psuje, Symbolizer przekłada awarię z powrotem na plik i linię kodu, korzystając z symboli opublikowanych w Dartastic Pub razem z aplikacją.
- Gdy trzeba wiedzieć, dlaczego, wystarczy zapytać Dartastic AI. Analizuje telemetrię i kod źródłowy w Dartastic Pub, a potem podaje przyczynę i poprawkę.
- Control Room to miejsce, w którym konfiguruje się to wszystko: tworzy tokeny, które otwierają każdą strzałkę na schemacie.
Elementy
| Element | Do czego służy | Gdzie go znaleźć |
|---|---|---|
| Control Room | Konto. Tu tworzy się tokeny, zaprasza członków zespołu, wybiera plan i pobiera Reference Demo. | dartastic.io/control-room, po zalogowaniu |
| Dartastic Pub | Prywatne repozytorium pakietów działające jak pub.dev. Pobiera się z niego pakiety Dartastic, przechowuje w nim własne prywatne pakiety i publikuje w nim kod źródłowy aplikacji. | dart pub get, dart pub publish |
| Dartastic OTel | Pakiety dodawane do aplikacji. Rejestrują, co się w niej dzieje (ekrany, stuknięcia, wywołania sieciowe, błędy, awarie, wydajność), w formacie OpenTelemetry i wysyłają te dane. | pubspec.yaml i main() |
| Observatory | Miejsce, w którym ogląda się dane. Sesje z odtwarzaniem, trasy, logi, metryki, awarie, dashboardy i alerty dla wszystkiego, co wysyłają aplikacje. | Otwierane z Control Room |
| Symbolizer | Przekłada nieczytelne stosy wywołań z obfuskowanego buildu release z powrotem na nazwy plików i numery linii. Działa samodzielnie, gdy tylko docierają awarie. | Nie trzeba niczego wywoływać: odczytuje symbole publikowane w Dartastic Pub |
| Dartastic AI | Odpowiada zwykłym językiem na pytania o aplikację. Analizuje telemetrię i kod źródłowy w Dartastic Pub, znajduje przyczynę i proponuje poprawkę. | Przycisk „Ask” w Observatory i w Control Room |
Co widać
Oto Observatory. Każda sesja użytkowników jest na liście razem z ekranami, stuknięciami, błędami i sygnałami frustracji:

Wystarczy otworzyć sesję i ją odtworzyć. Pod znacznikiem odtwarzania widać trasę, logi i błąd z danej chwili, a stamtąd można przejść prosto do linii kodu:

Tokeny łączą elementy
Każda strzałka na schemacie wymaga własnego rodzaju tokenu. Tworzy się je w Control Room, a każdy jest pokazywany tylko raz, więc należy go skopiować od razu po utworzeniu. Większość programistów nigdy nie używała tokenu z dart pub; strona Pub przeprowadza przez to krok po kroku.
| Token | Skąd | Dokąd | Umożliwia |
|---|---|---|---|
| Token Pub | Komputer | Dartastic Pub | dart pub get może pobierać pakiety Dartastic i prywatne pakiety; dart pub publish może je wysyłać. |
| Wymiana w CI | CI | Dartastic Pub | CI odczytuje i publikuje pakiety bez żadnego przechowywanego tokenu. |
| Token OTLP | Aplikacja na telefonie lub komputerze, serwer Dart | Observatory | Aplikacja może wysyłać telemetrię. |
| Token Browser OTLP | Aplikacja Flutter Web | Observatory | Aplikacja webowa może wysyłać telemetrię, wyłącznie z wymienionych witryn. |
Wszystkie posiadane tokeny są na jednym ekranie. Strona Tokeny opisuje każdy rodzaj oraz sposób odwołania lub zastąpienia tokenu.
Gdzie to działa: plan
- Cloud działa na infrastrukturze, którą Dartastic współdzieli między klientami. Dartastic Pub działa pod adresem
pub.dartastic.io. - Dedicated daje organizacji własny serwer pod wybraną subdomeną: Dartastic Pub działa pod adresem
pub.<subdomain>.dartastic.io. - Self-Hosted uruchamia całą platformę we własnej sieci.
Kroki są takie same w każdym planie. Tam, gdzie adres URL się różni, te strony podają oba. Porównaj plany.
Co jest potrzebne
- Flutter 3.44 i Dart 3.12 lub nowsze dla wszystkich funkcji; Flutter 3.22 i Dart 3.4 dla wszystkiego poza metrykami Fluttera. Wersje wymagane przez poszczególne pakiety.
- Konto Dartastic: rejestracja jest bezpłatna. Rejestracja uruchamia organizację w Cloud Free, bez karty.
- Tylko dla serwera pogodowego w Reference Demo: Docker.
Jak się tego nauczyć
Można wybrać dowolny sposób; wszystkie obejmują ten sam zakres.
- Lektura: te strony po kolei. Linki na dole każdej strony prowadzą do poprzedniej i następnej.
- Uruchomienie Dartastic OTel Reference Demo. To rozszerzona komercyjna wersja otwartoźródłowego projektu Dart OTel Reference Demo: znacznie więcej dem, czyli działających aplikacji Flutter, które pokazują, jak używać każdej funkcji Dartastic, z gotową konfiguracją. Można czytać jego kod, kopiować z niego albo wskazać go asystentowi AI do programowania. Pobierz Reference Demo.
- Kontakt: Wsparcie odpowiada na pytania.
Pojęcia używane na tych stronach
- OpenTelemetry (OTel)
- Otwarty standard rejestrowania tego, co robi oprogramowanie. Dartastic posługuje się nim od początku do końca, więc nic, co się napisze, nie jest uzależnione od Dartastic.
- OTLP
- Format przesyłu OpenTelemetry: sposób, w jaki aplikacja wysyła zarejestrowane dane.
- Trasa i span
- Span to jeden mierzony w czasie fragment pracy (stuknięcie, wywołanie sieciowe, zapytanie do bazy danych). Trasa to drzewo spanów jednej operacji, nawet gdy obejmuje aplikację i serwer.
- Log
- Linia tekstu zapisana przez aplikację, powiązana z trasą, w której powstała.
- Metryka
- Liczba mierzona w czasie: czasy klatek, pamięć, liczba żądań.
- Sesja
- Jedna wizyta jednej osoby w aplikacji, od uruchomienia do wyjścia, z każdym ekranem, stuknięciem, błędem i trasą.
- Odtwarzanie
- Ponowne obejrzenie sesji. Można wybrać, ile jest rejestrowane: oś czasu zdarzeń, wireframe albo prawdziwe piksele.
- RUM
- Real User Monitoring (monitorowanie rzeczywistych użytkowników): telemetria od osób, które naprawdę korzystają z aplikacji, a nie z testów.
- Obfuskacja i symbole
- Build release może obfuskować nazwy (flutter build --obfuscate). Zapisywany przy tym plik symboli (--split-debug-info) jest kluczem do ich odczytania.
- Token
- Długi tajny ciąg znaków, który pozwala jednemu elementowi komunikować się z jednym innym. Każdy rodzaj otwiera jedną ścieżkę na schemacie powyżej.