dart create în Dart

Comanda dart Dart 2.10

Creează un proiect Dart nou dintr-un șablon: aplicație de consolă, pachet, server sau aplicație web.

Sintaxă
dart create nume_proiect
dart create -t package nume_pachet
dart create -t cli|console|package|server-shelf|web nume
dart create --no-pub nume      # fără dart pub get

Ce face dart create

dart create magazin creează folderul magazin cu structura standard a unui proiect: pubspec.yaml (numele și dependențele), bin/ (programul principal), lib/ (codul reutilizabil), test/ (testele), analysis_options.yaml (regulile analizorului, cu pachetul lints) și un .gitignore. Apoi rulează dart pub get ca să descarce dependențele.

Opțiunea -t alege șablonul: console (implicit), cli (aplicație de consolă cu argumente, prin pachetul args), package (bibliotecă de publicat), server-shelf (server HTTP) și web.

Numele proiectului trebuie să fie scris cu litere mici și _ (de exemplu magazin_online), pentru că devine numele pachetului din importurile package:.

Parametri

Parametru Descriere
-t, --template Șablonul: console, cli, package, server-shelf, web.
--no-pub Nu rulează dart pub get după creare.
--force Creează proiectul chiar dacă folderul există deja.

Exemple

Exemplul 1: Un proiect de consolă

Proiectul creat se rulează imediat; programul generat afișează „Hello world: 42!”.

dart create magazin
cd magazin
dart run

Rezultat în terminal

Creating magazin using template console...

  .gitignore
  analysis_options.yaml
  CHANGELOG.md
  pubspec.yaml
  README.md
  bin/magazin.dart
  lib/magazin.dart
  test/magazin_test.dart

Running pub get...
  Resolving dependencies...
  Downloading packages...
  Changed 50 dependencies!

Created project magazin in magazin! In order to get started, run the following commands:

  cd magazin
  dart run

Hello world: 42!

Exemplul 2: Fișierul pubspec.yaml generat

Numele, versiunea SDK-ului cerută și dependențele inițiale.

cat pubspec.yaml

Rezultat în terminal

name: magazin
description: A sample command-line application.
version: 1.0.0
# repository: https://github.com/my_org/my_repo

environment:
  sdk: ^3.13.5

# Add regular dependencies here.
dependencies:
  path: ^1.9.0

dev_dependencies:
  lints: ^6.0.0
  test: ^1.25.6

Exemplul 3: Un pachet (bibliotecă)

Șablonul package are în loc de bin/ un folder example/ și codul în lib/src/.

dart create -t package catalog

Rezultat în terminal

Creating catalog using template package...

  .gitignore
  analysis_options.yaml
  CHANGELOG.md
  pubspec.yaml
  README.md
  example/catalog_example.dart
  lib/catalog.dart
  lib/src/catalog_base.dart
  test/catalog_test.dart

Running pub get...
  Resolving dependencies...
  Downloading packages...
  Changed 49 dependencies!

Created project catalog in catalog! In order to get started, run the following commands:

  cd catalog
  dart run example/catalog_example.dart

Greșeli frecvente

  • Nume cu majuscule sau cratimă (dart create Magazin-Online): eroare, numele trebuie să fie un identificator Dart valid, cu litere mici și _.
  • dart create într-un folder existent: comanda refuză, ca să nu suprascrie fișiere; folosește --force doar dacă știi ce faci.
  • Pentru o aplicație Flutter se folosește flutter create, nu dart create.

Comenzi înrudite

  • dart run: Rulează un program Dart: un fișier, programul principal al proiectului sau un executabil dintr-un pachet.
  • dart pub: Managerul de pachete Dart: adaugă, descarcă și actualizează dependențele de pe pub.dev.
  • dart analyze: Verifică codul fără să-l ruleze și raportează erori, avertismente și sfaturi de stil (infos).
  • import: Face disponibile în fișierul curent numele publice ale altei biblioteci: din SDK, dintr-un pachet sau din proiect.