Homebrew sur macOS : installer brew, formules et casks
macOS n'a pas de gestionnaire de paquets en ligne de commande. Homebrew comble le trou, avec 2 catalogues distincts : les formules (des outils CLI compilés ou en binaire pré-construit) et les casks (de vraies applications .app, Chrome, VLC, Rectangle).
Installation
Homebrew a besoin des Command Line Tools de Xcode, pas de Xcode entier. Le script d'installation les propose tout seul, mais autant les poser avant :
Puis l'installeur officiel, en bash. Les instructions en ruby -e qu'on trouve encore partout datent d'avant 2019 et l'URL qu'elles utilisent n'existe plus :
L'étape que le script ne fait pas pour vous
Sur Apple Silicon, Homebrew s'installe dans /opt/homebrew, qui n'est pas dans le PATH par défaut. C'est la raison n°1 du zsh: command not found: brew juste après une installation réussie. Le script l'affiche en fin de sortie, dans un pavé que personne ne lit :
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
Sur un Mac Intel, le préfixe est /usr/local, déjà dans le PATH, et rien de tout ça n'est nécessaire. brew --prefix dit dans quel cas on est, ce qui est utile dans un script de bootstrap qui doit marcher sur les deux.
Les commandes du quotidien
brew install htop # une formule (CLI)
brew install --cask rectangle # un cask (application)
brew search postgres # chercher, accepte les regex
brew info htop # version, dépendances, options
brew list # ce qui est installé
brew uninstall htop
brew cask install a été supprimé en 2020 : la syntaxe est brew install --cask. Les vieux tutos avec brew cask search renvoient aujourd'hui une erreur.
Mettre à jour
Les 2 commandes se confondent facilement et ne font pas du tout la même chose :
brew update # met à jour le catalogue de formules, pas les paquets
brew upgrade # met à jour les paquets installés
brew upgrade seul ne touche pas les casks sur les versions récentes ; il faut le demander, et --greedy inclut les applications qui se mettent à jour toutes seules (à éviter, elles gèrent déjà leur propre update) :
Pour figer un paquet dont on ne veut pas la dernière version :
Brewfile : réinstaller un Mac en une commande
brew bundle sérialise tout ce qui est installé dans un fichier versionnable, formules, casks et taps compris. C'est le seul moyen propre de reconstruire un poste à l'identique :
brew bundle dump --describe --file=~/Brewfile # générer
brew bundle install --file=~/Brewfile # restaurer
brew bundle check --file=~/Brewfile # que manque-t-il ?
brew bundle cleanup --file=~/Brewfile # lister ce qui n'y est pas
--describe ajoute un commentaire de description devant chaque ligne, ce qui rend le fichier relisible 6 mois plus tard. Mon Brewfile est dans mes dotfiles.
Faire de la place
Homebrew garde les anciennes versions et les archives téléchargées. Sur une machine de plusieurs années, le cache dépasse facilement les 10 Go :
brew autoremove retire les dépendances devenues orphelines, et brew leaves liste ce qu'on a installé explicitement, par opposition à ce qui est venu en dépendance. Utile pour reprendre un Brewfile à zéro sur une machine encrassée.
Dépannage
brew doctor est le premier réflexe devant un comportement bizarre. Il est bavard et signale des choses parfaitement bénignes, donc on ne cherche pas à obtenir un sans-faute : on y cherche les liens symboliques cassés et les dylib d'autres gestionnaires (MacPorts, conda) qui entrent en conflit.
Le brew update qui se déclenche tout seul à chaque brew install et ajoute 30 secondes se coupe par variable d'environnement :
Après une mise à jour majeure de macOS, les Command Line Tools sont souvent cassés et les compilations échouent sur des en-têtes introuvables. La réinstallation les remet en état :