Samouczek narzędzia dart (CLI)

Ten samouczek opisuje narzędzie wiersza poleceń dart dostarczane wraz z Dart SDK — jego opcje globalne oraz wszystkie komendy i podkomendy.

Wersja SDK: Wszystkie komendy, flagi i przykłady wyjścia w tym samouczku odnoszą się do Dart SDK 3.13 (zweryfikowano na wersji 3.13.1). Jeśli zainstalowana u Ciebie wersja dart różni się od 3.13, wyświetlane wyjście może odbiegać od pokazanego w samouczku (inne numery wersji, dodatkowe lub brakujące komendy albo flagi).

Spis treści

1. Wprowadzenie i opcje globalne

• 1.1 Wprowadzenie i opcje globalne — beginner — Ogólna składnia wywołań narzędzia dart, sześć opcji globalnych oraz komendy dart --version i dart help z podziałem komend na cztery kategorie.

2. Zarządzanie projektami

• 2.1 Tworzenie projektów — dart create — beginner — Komenda dart create: składnia, struktura generowanego projektu, flagi -t/--template, --[no-]pub, --force oraz pięć dostępnych szablonów.
• 2.2 Budowanie aplikacji — dart build — intermediate — Komenda dart build i podkomenda cli: budowanie uruchamialnego artefaktu oraz różnice względem dart compile z przypisaniem do scenariuszy.

3. Uruchamianie i kompilacja

• 3.1 dart run — uruchamianie programów — intermediate — Uruchamianie pliku Dart, lokalnego i zdalnego executable pakietu, flagi --observe, --[no-]enable-asserts, --verbosity oraz składnia @<descriptor>.
• 3.2 dart compile — kompilacja do różnych formatów — intermediate — Kompilacja AOT i sześć podkomend (exe, aot-snapshot, jit-snapshot, kernel, js, wasm) z tabelą porównawczą formatów wyjściowych.

4. Narzędzia jakości kodu

• 4.1 dart analyze — analiza statyczna kodu — intermediate — Statyczna analiza kodu, flagi --fatal-infos i --[no-]fatal-warnings, konfiguracja w analysis_options.yaml oraz interpretacja kodów wyjścia.
• 4.2 dart format — formatowanie kodu — intermediate — Automatyczne formatowanie kodu, flagi -o/--output (write/show/json/none), --set-exit-if-changed do użycia w CI oraz tryb podglądu.
• 4.3 dart fix — automatyczne poprawki — intermediate — Automatyczne stosowanie poprawek do diagnostyki, flagi -n/--dry-run, --apply i --code oraz bezpieczny podgląd zmian przed zapisem.
• 4.4 dart test — uruchamianie testów — intermediate — Uruchamianie testów opartych na package:test: wybór po nazwie, filtrowanie po tagach, sterowanie współbieżnością i reporterami oraz obsługa braku zależności.

5. Zarządzanie pakietami

• 5.1 dart pub — podstawy zarządzania pakietami — intermediate — Podstawy dart pub: role pubspec.yaml i pubspec.lock oraz podkomendy get/add/remove/upgrade/downgrade/outdated/deps z czterema kategoriami outdated.
• 5.2 dart pub — zaawansowane podkomendy — advanced — Zaawansowane podkomendy dart pub: cache, publish (z --dry-run), bump, unpack oraz uwierzytelnianie login/logout/token dla pub.dev i repozytoriów prywatnych.
• 5.3 Globalne narzędzia — dart pub global, install, installed, uninstall — advanced — Globalne pakiety CLI: pub global (activate/deactivate/list/run) oraz install/installed/uninstall, składnia deskryptora i wymóg pub cache bin w PATH.

6. Dodatkowe narzędzia deweloperskie

• 6.1 dart doc — generowanie dokumentacji API — intermediate — Generowanie dokumentacji API z komentarzy dokumentacyjnych, flagi -o/--output (domyślnie doc/api), --validate-links, --dry-run oraz dartdoc_options.yaml.
• 6.2 Narzędzia diagnostyczne — dart info i dart devtools — intermediate — Diagnostyka narzędzi: dart info (dump, record-performance) z ostrzeżeniem o redakcji oraz dart devtools z flagami --host, --port (domyślnie 9100) i innymi.