CLI (Command Line Interface)

Angular CLI est un outil d'interface de ligne de commande que vous utilisez pour initialiser, développer, échafauder et gérer des applications Angular. Vous pouvez utiliser l'outil directement dans un interpréteur de commande ou indirectement via une interface utilisateur interactive telle que la console Angular.

Installation du CLI (Command Line Interface) Angular.

Installez la CLI à l'aide du gestionnaire de packages npm :
Pour plus d'informations sur les modifications entre les versions et sur la mise à jour à partir de versions précédentes, voir l'onglet Communiqués sur GitHub : https://github.com/angular/angular-cli/releases

Workflow de base

Appelez l'outil depuis la ligne de commande via l'exécutable ng. L'aide en ligne est disponible sur la ligne de commande. Entrez ce qui suit pour répertorier les commandes ou les options d'une commande donnée (telle que generate) avec une courte description.
Pour créer, construire et servir un nouveau projet Angular de base sur un serveur de développement, accédez au répertoire parent de votre nouvel espace de travail à l'aide des commandes suivantes :
Dans votre navigateur, ouvrez http://localhost:4200/ pour voir la nouvelle application s'exécuter. Lorsque vous utilisez la commande ng serve pour créer une application et la servir localement, le serveur reconstruit automatiquement l'application et recharge la page lorsque vous modifiez l'un des fichiers source.

Dossier et espace de travail

La commande ng new crée un dossier espace de travail Angular et génère un nouveau squelette d'application. Un espace de travail peut contenir plusieurs applications et bibliothèques. L'application initiale créée par la commande ng new se situe au niveau supérieur de l'espace de travail. Lorsque vous générez une application ou une bibliothèque supplémentaire dans un espace de travail, celle-ci est placée dans un dossier/sous-dossier.

Une application nouvellement générée contient les fichiers source d'un module racine, avec un composant racine et un modèle. Chaque application possède un dossier src contenant la logique, les données et les actifs.

Vous pouvez modifier directement les fichiers générés, ou les ajouter et les modifier à l'aide de commandes CLI. Utilisez la commande ng generate pour ajouter de nouveaux fichiers pour des composants et services supplémentaires, ainsi que du code pour les nouveaux pipes, directives, etc...

Les commandes telles que add et generate, qui créent ou exploitent des applications et des bibliothèques, doivent être exécutées à partir d'un dossier de travail ou d'un espace de travail.

Configuration du dossier et de l'espace de travail

Un seul fichier de configuration d'espace de travail, angular.json, est créé au niveau supérieur de l'espace de travail. C'est ici que vous pouvez définir des valeurs par défaut et par projet pour les options de commande CLI et spécifier les configurations à utiliser lorsque la CLI crée un projet pour différentes cibles.

La commande ng config vous permet de définir et de récupérer les valeurs de configuration à partir de la ligne de commande. Vous pouvez également modifier le fichier angular.json directement. Notez que les noms d'option dans le fichier de configuration doivent utiliser la camelCase, alors que les noms d'option fournis aux commandes peuvent utiliser camelCase ou dash-case.

• En savoir plus sur la configuration de l'espace de travail.
• Voir le schéma complet pour angular.json.

Command Language Syntax / CLI (Command Line Interface)

La syntaxe de la commande est la suivante : ng commandNameOrAlias requiredArg [optionalArg] [options]

• La plupart des commandes et certaines options ont des alias. Les alias sont indiqués dans l'instruction de syntaxe pour chaque commande.
• Les noms d'options sont précédés d'un double tiret (--). Les alias d'option sont précédés d'un seul tiret (-). Les arguments ne sont pas préfixés. Par exemple: ng build MonPremierProjet -c production.
• Généralement, le nom d'un artefact généré peut être donné en tant qu'argument de la commande ou spécifié avec l'option --name.
• Les noms d'argument et d'option peuvent être donnés en camelCase ou dash-case. --myOptionName est équivalent à --my-option-name.

Options booléennes et énumérées.

Les options booléennes ont deux formes : --thisOption active le flag, --noThisOption l'efface. Si aucune option n'est fournie, l'indicateur reste dans son état par défaut, comme indiqué dans la documentation de référence.
Les valeurs autorisées sont fournies avec chaque description d'option énumérée, avec la valeur par défaut en gras.

Chemins relatifs

Les options spécifiant des fichiers peuvent être définies en tant que chemins absolus ou en tant que chemins relatifs au répertoire de travail actuel, qui correspond généralement à l'espace de travail ou à la racine du projet.

Schémas

Les commandes ng generate et ng add prennent comme argument l'artefact ou la bibliothèque à générer ou à ajouter au projet en cours. En plus des options générales, chaque artefact ou bibliothèque définit ses propres options dans un schéma. Les options schématiques sont fournies à la commande dans le même format que les options de commande immédiates.

Commandes du CLI (Command Line Interface)

Command	Alias	Description
ng add		Ajoute le support pour une bibliothèque externe à votre projet.
ng build	b	Compile une application angulaire dans un répertoire de sortie nommé dist / sur le chemin de sortie donné. Doit être exécuté depuis un répertoire d'espace de travail.
ng config		Récupère ou définit les valeurs de configuration angulaire dans le fichier angular.json pour l'espace de travail.
ng doc	d	Ouvre la documentation angulaire officielle (angular.io) dans un navigateur et recherche un mot clé donné.
ng e2e	e	Construit et sert une application angulaire, puis exécute des tests de bout en bout à l'aide de Protractor.
ng generate	g	Génère et / ou modifie des fichiers basés sur un schéma.
ng help		Répertorie les commandes disponibles et leur brève description.
ng lint	l	Exécute des outils de linting sur le code d'application angulaire dans un dossier de projet donné.
ng new	n	Crée un nouvel espace de travail et une application angulaire initiale.
ng run		Crée un nouvel espace de travail et une application angulaire initiale.
ng serve	s	Construit et sert votre application, reconstruisant sur les modifications de fichiers.
ng test	t	Exécute des tests unitaires dans un projet.
ng update		Met à jour votre application et ses dépendances. Voir https://update.angular.io/
ng version	v	Affiche la version CLI angulaire.
ng xi18n		Extrait les messages i18n du code source.