Le pack Unity Pipeline et Unity CLI: Guide d'installation et pas à pas

Aug 13, 2026

Engine Programming and DevOps Programming

Points principaux à retenir

Le paquet Unity Pipeline s'exécute à l'intérieur de l'éditeur Unity et expose les commandes via une API HTTP et JSON.
L'Unity CLI est un client autonome qui permet aux terminaux, agents et scripts d'automatisation d'exécuter ces commandes.
Les commandes intégrées et personnalisées prennent en charge les flux de travail répétables, tels que la configuration de projet, la recompilation, les tests et le contrôle d'exécution.
Le même contrat de commande peut alimenter l'Unity CLI, les workflows d'agents et les interfaces personnalisées.

Présentation

Unity CLI est gratuit et en version bêta. Associez-le au package Unity Pipeline pour piloter votre Editeur à partir du terminal pour les agents CI, scripts et IA.

Le package Unity Pipeline ajoute un serveur léger à l'intérieur de votre Unity Editor, lui permettant de communiquer directement avec votre terminal ou d'autres outils via des protocoles web standard. Vous pouvez déclencher des commandes telles que des vérifications d'état, des compilations ou des tests depuis l'extérieur. Ces opérations étant gérées de manière asynchrone, elles restent actives même lorsque l'éditeur se recharge après un changement de script. Cette configuration rend votre automatisation cohérente, prévisible et facile à scripter.

Composants

Unité CLI : Unity CLI, un binaire autonome installé séparément de l'éditeur, se connecte à un éditeur en cours d'exécution et le pilote à partir du terminal. Le pack Pipeline nécessite Unity 6.0 ou version ultérieure.
Paquet Unity Pipeline: celui-ci est installé dans un projet (com.unity.pipeline) via la CLI. Le package s'exécute à l'intérieur de l'éditeur et démarre automatiquement un serveur local lorsque l'éditeur se charge.
Commandes : Chaque commande est une fonction du projet, étiquetée afin qu'Unity l'enregistre automatiquement. Les commandes intégrées couvrent le mode Lecture, l'état, la recompilation et l'exécution de tests, avec la possibilité d'ajouter vos propres commandes.
Eval: Cela exécute C# directement à l'intérieur d'une instance Unity live (l'éditeur ou une compilation en cours d'exécution) pour des actions ponctuelles. Il exécute du C# arbitraire et est fermé par un jeton de sécurité; traitez-le comme une exécution de code à distance et gardez-le au développement local.

Architecture

Clients : L'appelant, comme un terminal, un agent, une configuration CI/CD ou une interface utilisateur personnalisée
Unity CLI: Le client principal qui transforme les commandes en appels API; une interface utilisateur personnalisée peut aussi parler directement le protocole
Protocole: HTTP + JSON et le contrat entre le client et Unity
- Tout client capable de faire une requête HTTP peut piloter Unity, dans n'importe quelle langue. Par défaut, le serveur se lie à localhost, de sorte que les clients s'exécutent sur la même machine que l'éditeur; les appelants distants l'atteignent par n'importe quel chemin réseau que vous exposez.
Ensemble Unity Pipeline: Installé dans le projet, démarrage automatique avec l'éditeur
- Le package Pipeline héberge deux serveurs: le serveur Editeur (mode Lecture, statut, recompilation, tests d'exécution, configuration de projet) et le serveur Exécution (éditions en direct dans une compilation en cours via le gestionnaire de pipelines Exécution).

Configuration

Étape 1 : Installer l'Unity CLI

L'Unity CLI est un binaire autonome (expérimental). Installez-le avec le script ou via le gestionnaire de paquets, puis vérifiez. Pour des instructions complètes, voir Unity CLI Documentation.

# macOS / Linux — install script

curl -fsSL https://public-cdn.cloud.unity3d.com/hub/prod/cli/install.sh | UNITY_CLI_CHANNEL=beta bash

# macOS / Linux — Homebrew (keeps it current)

brew install --cask unity-cli

# Windows — PowerShell install script

$env:UNITY_CLI_CHANNEL='beta'; irm https://public-cdn.cloud.unity3d.com/hub/prod/cli/install.ps1 | iex
unity --version          # verify it's on your PATH

Étape 2 : Se connecter

Contrôler un éditeur nécessite une session authentifiée:

unity auth login         # opens a browser sign-in flow

unity auth status        # confirm you're signed in

Étape 3 : Ajouter le package Unity Pipeline au projet

Le package Unity Pipeline s'exécute à l'intérieur de l'éditeur et se connecte à l'Unity CLI. Si vous l'installez à partir du terminal, assurez-vous d'être à la racine du projet Unity dans lequel vous souhaitez vous installer. Lancez Unity pipeline install et par défaut il cible le répertoire courant ou l'éditeur en cours d'exécution. Vous pouvez également ajouter com.unity.pipeline via le gestionnaire de paquets. Voir les docs du paquet Unity Pipeline.

unity pipeline install

Une fois installé, l'éditeur démarre automatiquement le serveur. Vérifiez le nouveau menu Pipeline pour confirmer.

Étape 4 : Connecter et lister les commandes

Une fois le paquet installé, connectez-vous à un éditeur en cours d'exécution et listez ce qui est scriptable :

unity command            # list this project's commands

La liste comprend les éléments intégrés (mode Lecture, statut, recompilation, exécution des tests) plus les commandes personnalisées. Ils fonctionnent avec n'importe quel agent sans configuration supplémentaire.

Piloter l'éditeur à partir du terminal

Entrez en mode Lecture, exécutez des tests, listez des cibles de construction ou saisissez une capture d'écran.

unity command editor_play

unity command run_tests

unity command list_build_targets

unity command screenshot

Les exécutions sont déterministes, et ce qui précède n'est qu'une infime tranche ; la liste Unity montre toute la surface intégrée (scènes, préfabriqués, matériaux, animation, éclairage/NavMesh cuit, builds, captures d'écran, paquets, et plus encore).

Commandes personnalisées

Les commandes personnalisées enchaînent une série d'actions en un seul appel en ligne de commande. Une commande est une fonction balisée dans le projet. Exemples :

Lancer des tests + notifier: Exécutez la suite et affichez les résultats à l'équipe en un seul appel.
Déclarer les actifs inutilisés : Analysez le projet et listez les actifs sans références, à supprimer avant une compilation.

Une commande écrite est déterministe et répétable: même appel, même résultat, ce qui la rend aussi simple à remettre à un agent.

Contrôle d'exécution

Le serveur Runtime pilote une compilation en cours d'exécution. Activez-le en ajoutant un GameObject vide, en ajoutant le composant Runtime Pipeline Manager et en cochant Activer dans les builds. Avec une compilation en cours d'exécution, depuis le terminal:

Temps de ralentissement, de pause ou de redémarrage.
Modifiez les valeurs à la volée, et mettez à l'échelle ou déplacez la transformation d'un GameObject en cours d'exécution.
Échanger les actifs et les effets à l'exécution.

Pour les actions répétées, écrivez des commandes d'exécution (modifier les valeurs de gameplay, remplacer les modes de jeu). Il est déterministe, répétable et appelable par un agent.

Agents et eval

Chaque commande est disponible pour n'importe quel agent via la CLI ou son mode MCP : commandes intégrées, commandes personnalisées et eval. Un agent a deux vitesses:

Commandes nommées déterministes pour les étapes répétables
eval pour C# ponctuel quand aucune commande n'existe encore

Un cas d'utilisation peut être qu'un agent utilise eval pour construire ou changer quelque chose, exécute une commande déterministe pour l'exercer, prend une capture d'écran et vérifie l'image par rapport à l'invite, itérant jusqu'à ce qu'elle corresponde. eval est C# arbitraire avec jeton, donc étendez ce que l'agent peut toucher.

Sécurité

Le pack Unity CLI et Pipeline sont construits pour le développement local, pas pour les jeux expédiés. Par défaut, tout reste sur votre machine ; il ne s'exécute que pendant que vous développez, et l'exécution du code live (eval) est fermée par une clé d'accès par projet, de sorte qu'un agent ne peut pas exécuter du C# arbitraire contre votre éditeur sans lui. Remettre le CLI à un agent d'IA revient à donner à n'importe quel assistant accès à votre ordinateur : il peut faire ce que vous pouvez, donc décider ce que vous le laissez toucher, et garder la commande eval au travail local.

Plus de ressources

Documentation Unity CLI

Ensemble Unity Pipeline Documentation