Começando

Instalação rápida

O jeito mais rápido de instalar Hew é com o script de instalação:

v0.9.3 · Versão

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

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

Invoke-WebRequest https://hew.sh/install.ps1 -OutFile install.ps1
.\install.ps1 -Version 0.9.3

O instalador adiciona hew, que inclui o compilador e o gerenciador de pacotes.

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

Estes comandos selecionam a versão do compilador usada nas lições. Confira a instalação com hew version.

hew version

Olá, mundo

Crie um arquivo chamado hello.hew:

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

Compilar e executar

Compile com hew build e execute o binário resultante:

Compilações nativas precisam de um compilador C e das ferramentas de desenvolvimento do sistema. Use Xcode Command Line Tools no macOS, Clang ou GCC no Linux, e LLVM com Visual Studio C++ Build Tools no Windows. Se a verificação funcionar, mas a vinculação falhar, consulte o guia de solução de problemas (em inglês).

hew check hello.hew
hew build hello.hew -o hello
./hello

Hello, world!

hew check hello.hew
hew build hello.hew -o hello.exe
.\hello.exe

Hello, world!

O comando hew build executa o frontend Rust, baixa o programa verificado por HIR e MIR e emite um binário nativo por LLVM.

Configure seu editor

No VS Code, instale Hew Language (hew-lang.hew-lang) em Extensões. Se o comando code estiver no PATH, você também pode executar:

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

Abra hello.hew. O modo de linguagem deve ser Hew, com destaque de sintaxe e diagnósticos do servidor de linguagem. A extensão publicada inclui hew-lsp para as plataformas compatíveis.

Para usar uma instalação específica, defina hew.lsp.serverPath e hew.formatterPath nas configurações do VS Code com os caminhos completos de hew-lsp e hew. Use caminhos absolutos, sem ~ nem variáveis. Reinicie o VS Code após alterar o PATH.

Vim, Neovim, Emacs e outros editores (em inglês)

Outras formas de instalação

Para examinar o instalador antes de executá-lo, baixe-o como arquivo local e leia-o.

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

Invoke-WebRequest https://hew.sh/install.ps1 -OutFile install.ps1
Get-Content .\install.ps1
.\install.ps1 -Version 0.9.3

Baixe a versão indicada acima e confira o arquivo da sua plataforma com o arquivo SHA-256 correspondente.

tag=v0.9.3
asset=hew-v0.9.3-darwin-aarch64.tar.gz # choose the asset for your Mac
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" | shasum -a 256 -c -

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 -

$tag = "v0.9.3"
$asset = "hew-v0.9.3-windows-x86_64.zip"
$base = "https://github.com/hew-lang/hew/releases/download/$tag"
Invoke-WebRequest "$base/$asset" -OutFile $asset
Invoke-WebRequest "$base/hew-$tag-checksums.txt" -OutFile checksums.txt
$expected = (Select-String -Path checksums.txt -Pattern " $asset$").Line.Split(" ")[0]
$actual = (Get-FileHash -Algorithm SHA256 $asset).Hash.ToLower()
if ($actual -ne $expected) { throw "checksum mismatch" }

Você também pode compilar a versão indicada a partir do código-fonte com os pré-requisitos abaixo.

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é-requisitos

Compilações a partir do código-fonte também precisam de GNU Make e Python 3.12 ou posterior. Veja todos os requisitos (em inglês).

brew install llvm cmake ninja

# 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

Build a partir do código-fonte

Clone o repositório e compile o compilador:

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

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

$env:PATH = "$PWD\target\debug;$env:PATH"