Finch CLI

De Finch CLI is een opdrachtregeltool voor het aanmaken van projecten, het uitvoeren van de ontwikkelserver, het bouwen, het uitvoeren van tests en het beheren van databasemigraties. Het omhult veelgebruikte Dart-opdrachten en voegt Finch-specifieke taken toe.

Installatie

dart pub global activate finch

Opdrachten

Voer finch -h uit om alle beschikbare opdrachten te zien:

finch -h

✔ templates
        Toon de lijst met beschikbare sjablonen
✔ create
        Maak een nieuw project aan
        -p, --path       Pad van het project
        -n, --name       Naam van het project
        -d, --docker     Docker gebruiken
        -t, --template   Projectsjabloon [simple, example,...]
✔ get
        Pakketten ophalen (dart pub get)
✔ runner
        Build runner uitvoeren (dart pub run build_runner build)
✔ run
        Project uitvoeren (dart run)
        -p, --path       Pad naar het app-bestand
        -a, --args       Argumenten voor het app-bestand
✔ serve
        Project serveren met bestandswatcher
        -p, --path       Pad naar het app-bestand
        -a, --args       Argumenten voor het app-bestand
✔ build
        Project bouwen (dart compile exe)
        -c, --cli        Bouwen voor CLI
        -a, --appPath    Pad naar het app-bestand
        -l, --langPath   Pad naar talenbestanden
        -p, --publicPath Publiek pad
        -w, --widgetPath Widget-pad
        -e, --envPath    Pad naar omgevingsbestand (.env)
        -o, --output     Uitvoerpad
        -t, --type       Bouwtype (zip, exe)
✔ migrate
        MySQL- en SQLite-migraties beheren
        -c, --create     Nieuw migratiebestand aanmaken
        -n, --name       Naam van het migratiebestand (alleen met --create)
        -s, --sqlite     SQLite gebruiken in plaats van MySQL
✔ test
        Unit-tests uitvoeren (dart test)
        -r, --reporter   Weergave van testresultaten instellen

        -h, --help       Help weergeven
        -v, --version    Finch-versie weergeven
        -u, --update     Finch CLI bijwerken

Veelgebruikte voorbeelden

Een nieuw project aanmaken met het example-sjabloon

finch create -n my_app -t example

De ontwikkelserver starten met bestandswatcher

Het serve-commando bewaakt widget- en taalbestanden en herlaadt ze automatisch zonder de server opnieuw te starten:

finch serve

Of geef het beginpunt op:

finch serve -p lib/serve.dart

Een productiebinary bouwen

finch build -a lib/app.dart -o ./build/app

Databasemigraties uitvoeren

# Alle openstaande MySQL-migraties toepassen
finch migrate --init

# Een nieuw MySQL-migratiebestand aanmaken
finch migrate --create --name add_users_table

# SQLite-migraties toepassen
finch migrate --init --sqlite

Het migrate-commando delegeert naar het ingebouwde migratiesysteem van de draaiende app. Zie Database Migration voor details.