# Installation

Trois commandes suffisent pour passer d'un dossier vide à une application Flutter opérationnelle, avec le routage, le réseau, les thèmes et la génération de code déjà configurés.

Avant de commencer SDK Flutter installé Dart 3 Configuration requise →

## Installer Exécutez ces commandes dans l'ordre. Chacune peut être relancée sans risque.

Installer la CLI Nylo globalement

Installe la commande `nylo` sur votre système. ``` bash dart pub global activate nylo_installer ```

Creer un nouveau projet

Cette commande clone le template Nylo, configure le projet avec le nom de votre application et installe automatiquement toutes les dependances. ``` bash nylo new my_app ```

Configurer l'alias Metro

Cela configure la commande `metro` pour votre projet, vous permettant d'utiliser les commandes Metro CLI sans la syntaxe complete `dart run`. ``` bash cd my_app nylo init ``` Redémarrez ensuite votre terminal, ou exécutez la commande `source` que `nylo init` affiche.

Ce que vous obtenez

Routage et navigation pre-configures

Boilerplate de service API

Configuration du theme et de la localisation

Metro CLI pour la generation de code

## Lancer le projet Les projets Nylo s'executent comme toute application Flutter standard.

``` bash flutter run ``` Si la compilation reussit, l'application affichera l'ecran d'accueil par defaut de Nylo.

Ouvrez le dossier du projet, choisissez un appareil dans le sélecteur de cible, puis appuyez sur **Run**. Documentation Flutter : exécution et débogage ↗

Ouvrez le dossier du projet, puis exécutez **Debug: Start Without Debugging** depuis la palette de commandes. Documentation Flutter : exécuter sans point d'arrêt ↗

## Metro CLI Metro génère les fichiers du projet pour vous. Lancez-le sans argument pour afficher le menu, ou appelez directement une commande. ``` plaintext $ metro Metro - Nylo's Companion to Build Flutter apps by Anthony Gordon Usage: command [options] [arguments] Options -h All commands: [Widget Commands] make:page make:stateful_widget make:stateless_widget make:state_managed_widget make:navigation_hub make:journey_widget make:bottom_sheet_modal make:button make:form [Helper Commands] make:model make:provider make:api_service make:controller make:event make:route_guard make:config make:interceptor make:command make:env ``` ### Référence des commandes Chaque commande reçoit un nom, par exemple `metro make:page settings_page`

Commandes de widgets

metro make:page Creer une nouvelle page

metro make:stateful_widget Creer un widget avec etat

metro make:stateless_widget Creer un widget sans etat

metro make:state_managed_widget Creer un widget a etat gere

metro make:navigation_hub Creer un hub de navigation (navigation inferieure)

metro make:journey_widget Creer un widget de parcours pour le hub de navigation

metro make:bottom_sheet_modal Creer une feuille modale inferieure

metro make:button Creer un widget bouton personnalise

metro make:form Creer un formulaire avec validation

Commandes utilitaires

metro make:model Creer une classe de modele

metro make:provider Creer un provider

metro make:api_service Creer un service API

metro make:controller Creer un controleur

metro make:event Creer un evenement

metro make:route_guard Creer un garde de route

metro make:config Creer un fichier de configuration

metro make:interceptor Creer un intercepteur reseau

metro make:command Creer une commande Metro personnalisee

metro make:env Generer la configuration d'environnement a partir de .env

### Exemples d'utilisation ``` bash # Create a new page metro make:page settings_page # Create a model metro make:model User # Create an API service metro make:api_service user_api_service ```

## Nylo CLI

Nécessite nylo_installer 1.8.0+ Mettre à jour la CLI →

La commande `nylo` de l'étape 1 fait plus que créer des projets. Exécutez-la depuis le répertoire de votre projet pour nettoyer les builds, actualiser les pods iOS, exécuter les tests et vérifier vos traductions.

Commandes de projet

nylo new Créer un nouveau projet

nylo init Configurer l'alias metro dans votre shell

nylo clean Exécuter flutter clean et flutter pub get

nylo ios:pod-refresh Réinstaller vos pods iOS

nylo metro Exécuter une commande Metro sans l'alias

Tests et traductions

nylo test Formater et exécuter vos tests

nylo locale:find-untranslated Trouver le texte qui n'est pas encapsulé dans .tr()

nylo locale:check-missing-keys Trouver les clés manquantes dans vos fichiers de langue

La CLI elle-même

nylo self-update Mettre à jour nylo vers la dernière version

nylo --version Afficher la version installée

Les commandes qui acceptent des options les listent avec `-h`, par exemple `nylo test -h`. Les tests sont couverts dans [Exécuter les tests](/docs/7.x/testing#running-tests), et les commandes `locale:` dans [Auditer les traductions](/docs/7.x/localization#auditing-translations).

### Nettoyer un projet `nylo clean` exécute `flutter clean` puis `flutter pub get`. Ajoutez un flag de plateforme lorsqu'un nettoyage normal ne suffit pas : ``` bash # flutter clean, puis flutter pub get nylo clean # Supprime aussi ios/Pods, ios/.symlinks et ios/Podfile.lock, puis exécute pod install --repo-update nylo clean --ios # Exécute aussi gradlew clean dans android/ nylo clean --android # Les deux à la fois nylo clean --all ``` Si un projet n'a pas de dossier `ios/` ou `android/`, cette plateforme est ignorée avec un avertissement. `pod install` ne s'exécute que sur macOS.

### Actualiser les pods iOS Lorsque CocoaPods se désynchronise, `nylo ios:pod-refresh` supprime `ios/Pods`, `ios/.symlinks` et `ios/Podfile.lock`, puis exécute `pod install --repo-update` dans le dossier `ios/` : ``` bash nylo ios:pod-refresh ``` Exécutez-la depuis la racine de votre projet sur macOS. Contrairement à `nylo clean --ios`, elle n'exécute ni `flutter clean` ni `flutter pub get`.

### Exécuter Metro sans l'alias `nylo metro` transmet tout ce qui suit à Metro (`dart run nylo_framework:main`). Utilisez-la avant d'avoir exécuté `nylo init`, ou sur Windows, où `nylo init` ne peut pas ajouter l'alias `metro` pour vous : ``` bash nylo metro make:page settings_page nylo metro make:model User ```

### Mettre à jour la CLI ``` bash nylo self-update ``` Cela vérifie pub.dev et réinstalle `nylo_installer` si une version plus récente est disponible. Une fois une commande terminée, `nylo` vous indique également si une mise à jour est disponible. Elle reste silencieuse lorsque la sortie ne va pas vers un terminal, afin que l'avis ne se retrouve jamais dans les logs CI ou les rapports redirigés. Pour voir quelle version vous avez installée : ``` bash nylo --version ```