Aller au contenu principal

Prise en main

Installez Hew et écrivez votre premier programme.

Installation rapide

La façon la plus rapide d'installer Hew est avec le script d'installation :

v0.9.3 · Version

Terminal
curl -fsSL https://hew.sh/install | bash -s -- --version 0.9.3

L’installateur ajoute hew, qui comprend le compilateur et le gestionnaire de paquets.

Ajoutez l’installation par défaut au PATH de ce terminal. Pour les futurs terminaux, exécutez les commandes de configuration permanente affichées pour votre shell. Avec un autre répertoire, utilisez sa commande PATH.

Terminal
export PATH="$HOME/.hew/bin:$PATH"

Ces commandes sélectionnent la version du compilateur utilisée par les leçons. Exécutez hew version pour vérifier votre installation.

Terminal
hew version

Bonjour le monde

Créez un fichier appelé hello.hew :

hello.hew
fn main() {
    println("Hello, world!");
}

Compilation et exécution

Compilez avec hew build et exécutez le binaire résultant :

La compilation native nécessite un compilateur C et les outils de développement du système. Utilisez les outils de ligne de commande Xcode sur macOS, Clang ou GCC sur Linux, et LLVM avec les outils de compilation C++ de Visual Studio sur Windows. Si la vérification réussit, mais que l’édition de liens échoue, consultez le guide de dépannage (en anglais).

Terminal
hew check hello.hew
hew build hello.hew -o hello
./hello
Sortie
Hello, world!

La commande hew build exécute le frontend Rust, abaisse le programme vérifié en HIR puis en MIR, et produit un binaire natif avec LLVM.

Configurer votre éditeur

Dans VS Code, installez Hew Language (hew-lang.hew-lang) à partir des extensions. Si la commande code se trouve dans le PATH, vous pouvez aussi exécuter :

Terminal
code --install-extension hew-lang.hew-lang

Ouvrez hello.hew. Le mode de langage devrait être Hew, avec la coloration syntaxique et les diagnostics du serveur de langage. L’extension publiée inclut hew-lsp pour les plateformes prises en charge.

Pour utiliser une installation précise, définissez hew.lsp.serverPath et hew.formatterPath dans les paramètres de VS Code avec les chemins complets vers hew-lsp et hew. Utilisez des chemins absolus, sans ~ ni variables. Redémarrez VS Code après avoir modifié le PATH.

Vim, Neovim, Emacs et autres éditeurs (en anglais)

Poursuivre avec la visite du langage

La visite ajoute les fonctions, les records, le pattern matching, les appels d’acteurs et les opérations concurrentes dans de courts exemples.

Ouvrir la visite du langage →

Aide-mémoire

La fiche recto verso imprimable couvre la syntaxe courante, les acteurs, la concurrence, les types Wire et les machines.

Télécharger le PDF

Autres méthodes d’installation

Pour examiner l’installateur avant de l’exécuter, téléchargez-le dans un fichier local et lisez-le.

Terminal
curl -fsSLo hew-install.sh https://hew.sh/install
less hew-install.sh
bash hew-install.sh --version 0.9.3

Téléchargez la version indiquée ci-dessus et vérifiez son archive avec le fichier de sommes SHA-256 correspondant.

Terminal
tag=v0.9.3
asset=hew-v0.9.3-linux-x86_64.tar.gz # choose the asset for your Linux host
base="https://github.com/hew-lang/hew/releases/download/$tag"
curl -fLO "$base/$asset"
curl -fLO "$base/hew-$tag-checksums.txt"
grep "  $asset$" "hew-$tag-checksums.txt" | sha256sum -c -

Vous pouvez aussi compiler la version indiquée depuis les sources avec les prérequis ci-dessous.

Using the mobile apps? Follow the illustrated iPhone/iPad guide or Android beta guide for examples, editing, running and saving code. These guides are in English.

Prérequis

La compilation depuis les sources nécessite aussi GNU Make et Python 3.12 ou une version plus récente. Consultez tous les prérequis (en anglais).

Pour construire le compilateur Hew depuis les sources, vous avez besoin de LLVM 22 et d’une toolchain Rust. Sur Ubuntu/Debian :

Terminal
# Install LLVM 22 (required by Inkwell)
wget https://apt.llvm.org/llvm.sh && chmod +x llvm.sh && sudo ./llvm.sh 22

# Install build tools
sudo apt install cmake ninja-build

Construire depuis les sources

Clonez le dépôt et construisez le compilateur :

Terminal
git clone --branch v0.9.3 https://github.com/hew-lang/hew.git
cd hew
make hew-native

Le pilote du compilateur se trouve à target/debug/hew. Ajoutez-le à votre PATH :

Terminal
export PATH="$PWD/target/debug:$PATH"