Anatomia pubspec.yaml
Deklarowanie metadanych, zależności i ograniczeń
Anatomia pubspec.yaml to bezpłatna lekcja Dart Academy na CoddyKit. To lekcja 1 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Dart Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Dart Academy zawiera 4 lekcji w sumie.
Poznaj pubspec.yaml
Każdy projekt Dart ma w katalogu głównym plik pubspec.yaml. Jest to manifest opisujący projekt i zawierający listę wszystkich jego zależności. 📄
Dlaczego YAML
Dart używa tutaj YAML, ponieważ ten format jest czytelny dla człowieka: wcięcia pokazują strukturę, a klucze zapisuje się przed dwukropkiem i wartością. Nawiasy klamrowe nie są potrzebne.
name: my_app
version: 1.0.0Pole name
Pole name jest wymagane. Musi zawierać małe litery i podkreślenia, a jego wartość staje się identyfikatorem używanym przez inny kod do importowania pakietu.
name: weather_clientOpis i wersja
Dodaj krótki description, aby użytkownicy wiedzieli, do czego służy pakiet, oraz version zgodną z formatem major.minor.patch, na przykład 1.2.0.
description: A tiny weather client.
version: 1.2.0Klucz environment
Klucz environment określa, które wersje Dart SDK obsługuje projekt. Narzędzia odmówią działania, jeśli SDK będzie poza tym zakresem.
environment:
sdk: ^3.0.0Zależności uruchomieniowe
Sekcja dependencies zawiera listę pakietów potrzebnych kodowi w czasie działania. Każdy wpis to nazwa pakietu przypisana do ograniczenia wersji.
dependencies:
http: ^1.2.0dev_dependencies
Użyj dev_dependencies dla narzędzi potrzebnych tylko podczas tworzenia, takich jak pakiety do testów lub lintowania. Nie są one dostarczane osobom korzystającym z pakietu.
dev_dependencies:
test: ^1.24.0Ograniczenia wersji z karetką
caret, na przykład ^1.2.0, oznacza dowolną wersję od 1.2.0 do wersji niższej niż 2.0.0. Pozwala akceptować bezpieczne, zgodne aktualizacje.
http: ^1.2.0Wcięcia mają znaczenie
YAML używa spacji, nigdy tabulatorów, do oznaczania zagnieżdżenia. Nieprawidłowo wyrównany klucz uszkadza plik, dlatego wszędzie zachowuj spójne dwuspacjowe indentation.
dependencies:
http: ^1.2.0Inne przydatne pola
Możesz również dodać pola homepage, repository i publish_to. Udostępniają one użytkownikom odnośniki i pozwalają w razie potrzeby zachować pakiet jako prywatny.
homepage: https://example.com
publish_to: noneGdzie pub odczytuje konfigurację
Po uruchomieniu poleceń pub narzędzie najpierw odczytuje pubspec.yaml, aby poznać zależności, a następnie pobiera je wszystkie i rozwiązuje zależności za Ciebie. 🔧
Szybkie sprawdzenie
Gdzie umieszczasz pakiety potrzebne tylko podczas tworzenia?
Podsumowanie
Dowiedziałeś się, że pubspec.yaml nadaje nazwę projektowi, określa zakres SDK oraz zawiera zależności uruchomieniowe i deweloperskie. To najważniejszy plik każdego projektu Dart. 🎉
Często zadawane pytania
Czy lekcja „Anatomia pubspec.yaml” jest bezpłatna?
Tak — pełny tekst „Anatomia pubspec.yaml” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Dart Academy, przejdź na CoddyKit PRO. Kurs Dart Academy zawiera 4 lekcji w sumie.
Co nauczysz się w „Anatomia pubspec.yaml”?
Deklarowanie metadanych, zależności i ograniczeń Ćwiczysz Dart Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć Dart Academy?
Nie wymagamy żadnego doświadczenia. Dart Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 1 z 4.
Ile czasu zajmuje lekcja „Anatomia pubspec.yaml”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji Dart Academy?
Tak. Każda lekcja Dart Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.
Wszystkie lekcje w tym kursie
- Anatomia pubspec.yaml
- Dodawanie zależności za pomocą dart pub
- Importy, eksporty i biblioteki
- Ograniczenia wersji i plik blokady