Installation de l'Encore CLI

Instructions

Suivez les étapes dans l'ordre.

1. Vérifier si elle est installée

encore version

Affiche encore version v... : installée. Allez à l'étape 4.
Commande non trouvée : exécutez ~/.encore/bin/encore version. Si cela affiche une version, Encore est installé mais pas sur le PATH : allez à l'étape 3. Sinon allez à l'étape 2.

2. Installer

Demandez d'abord à l'utilisateur, sauf s'il vous a demandé d'installer Encore. Exécutez la commande pour le système d'exploitation. Aucune d'elles ne demande d'entrée.

# macOS
brew install encoredev/tap/encore

# Linux, WSL, ou macOS sans Homebrew
curl -L https://encore.dev/install.sh | bash

# Windows (PowerShell)
iwr https://encore.dev/install.ps1 | iex

Exécutez encore version à nouveau. Si elle n'est toujours pas trouvée, allez à l'étape 3. Sur Windows, ouvrez un nouveau shell à la place : l'installeur ajoute %USERPROFILE%\.encore\bin au PATH, mais les shells déjà ouverts ne le voient pas.

3. L'ajouter au PATH

install.sh installe dans ~/.encore/bin et n'édite pas les profils de shell. Ajoutez-le au PATH :

export ENCORE_INSTALL="$HOME/.encore"
export PATH="$ENCORE_INSTALL/bin:$PATH"

Les shells d'agent perdent souvent les variables d'environnement entre les commandes. Préfixez chaque commande encore avec ces exports, ou appelez ~/.encore/bin/encore par son chemin complet. Pour le rendre permanent, demandez à l'utilisateur, puis ajoutez les deux lignes à son profil de shell (~/.zshrc pour zsh, ~/.bashrc pour bash).

4. Vérifier ce dont l'app a besoin

Outil	Nécessaire pour	Vérifier	En cas d'échec
Docker	Apps avec bases de données SQL (`encore run`, `encore test`)	`docker info`	Non installé : demandez à l'utilisateur d'installer Docker. Non en cours d'exécution : démarrez-le (macOS : `open -a Docker`) et attendez jusqu'à ce que `docker info` réussisse
Node.js et npm	Apps Encore.ts	`node --version`	Demandez à l'utilisateur d'installer Node.js
git	Créer des apps et déployer	`git --version`	Demandez à l'utilisateur d'installer git

Encore.go n'a besoin d'aucune installation Go séparée : la CLI inclut la toolchain Go avec laquelle elle compile. Autres infrastructures locales (Pub/Sub, caches, buckets, cron) s'exécutent sans Docker.

Mise à jour

encore version update

Cela utilise Homebrew si Encore a été installé avec lui, et le script d'installation sinon. Puis mettez à jour le package encore.dev de l'app : npm install encore.dev@latest (Encore.ts) ou go get encore.dev@latest (Encore.go).

Directives

Quand encore n'est pas trouvé juste après l'installation, corrigez le PATH (étape 3). Ne réinstallez pas.
Demandez avant d'installer un logiciel ou d'éditer des profils de shell, sauf si l'utilisateur vous l'a demandé.
Ensuite : se connecter (encore-login), créer une app (encore-create-app), et l'exécuter (encore-run).
Docs : https://encore.dev/docs/quick-start

encore-install