5. Instalando o Dart SDK

O que é o Dart SDK

O Dart SDK (Software Development Kit) é o pacote oficial do Google que traz tudo necessário pra escrever, rodar e empacotar programas Dart. Inclui:

• O compilador (dart compile) - traduz código Dart para executável ou JavaScript
• O CLI principal (dart run) - roda um arquivo Dart direto, sem compilar primeiro
• O gerenciador de pacotes (dart pub) - instala bibliotecas de terceiros
• O analisador estático (dart analyze) - aponta erros enquanto você programa, sem rodar
• O formatador (dart format) - alinha indentação e espaçamento automaticamente
• O runtime de testes (dart test) - executa testes automáticos do seu código

Tudo numa instalação. Você não precisa decidir entre alternativas - o SDK oficial cobre tudo bem.

macOS - passo a passo

Caminho recomendado: Homebrew. Se você ainda não tem o Homebrew, instale primeiro - é o gerenciador de pacotes padrão do macOS, e vai ser útil para muita coisa além de Dart. Site oficial: brew.sh, copie o comando que aparece na home e cole no Terminal.

Com Homebrew instalado:

brew tap dart-lang/dart
brew install dart

Aguarde a instalação (1-2 minutos). Verifique:

dart --version

Deve mostrar algo como Dart SDK version: 3.5.0 (stable). Se aparecer, está pronto. Pode ir para a próxima seção.

Alternativa sem Homebrew: baixe o instalador .zip direto do site dart.dev/get-dart, extraia em /Applications/dart-sdk, e adicione /Applications/dart-sdk/bin ao PATH (edite ~/.zshrc ou ~/.bash_profile, dependendo do shell). Reinicie o Terminal.

Linux - passo a passo

Ubuntu, Debian e derivadas. Adicione o repositório APT do Google e instale via gerenciador padrão:

sudo apt-get update
sudo apt-get install apt-transport-https
wget -qO- https://dl-ssl.google.com/linux/linux_signing_key.pub | sudo gpg --dearmor -o /usr/share/keyrings/dart.gpg
echo 'deb [signed-by=/usr/share/keyrings/dart.gpg arch=amd64] https://storage.googleapis.com/download.dartlang.org/linux/debian stable main' | sudo tee /etc/apt/sources.list.d/dart_stable.list
sudo apt-get update
sudo apt-get install dart

Não memorize. Copie e cole.

Outras distros (Fedora, Arch, etc). Use o gerenciador de pacotes da sua distribuição (dnf, pacman), ou baixe o tarball do site dart.dev/get-dart e extraia em /opt/dart-sdk. Adicione /opt/dart-sdk/bin ao PATH.

Verificação universal:

dart --version

Windows - passo a passo

Você tem três opções, em ordem de preferência:

1. WSL (Windows Subsystem for Linux) - recomendado. Permite rodar Linux dentro do Windows. Microsoft tem tutorial oficial em learn.microsoft.com/wsl. Depois de instalado, abra o terminal WSL e siga o tutorial de Linux acima. Vantagem: o ecossistema de desenvolvimento moderno é nativo de Linux, e qualquer tutorial online vai funcionar do mesmo jeito que para usuários macOS/Linux.

2. Chocolatey. Se você prefere ficar em Windows puro, instale primeiro o Chocolatey (chocolatey.org/install). Depois, no PowerShell como administrador:

choco install dart-sdk

3. Instalador MSI direto. Baixe do site dart.dev/get-dart, execute o .msi. Pode precisar adicionar manualmente ao PATH (Configurações > Sistema > Sobre > Configurações avançadas > Variáveis de ambiente). Esse caminho é o mais frágil; só recomendo se as opções 1 e 2 falharem por algum motivo de política corporativa.

Verificação no PowerShell:

dart --version

Checagem final

Antes de fechar este capítulo, garanta que estes três comandos funcionam:

dart --version
dart create teste
dart run teste

O primeiro deve imprimir a versão. O segundo cria uma pasta teste/ com um projeto Dart mínimo. O terceiro roda o programa de exemplo do template, que deveria imprimir Hello world: 42! na tela.

Se tudo isso funciona, você está pronto para o capítulo 6 deste guia (Seu primeiro programa). Se não funciona, vá para a seção Quando algo der errado abaixo.

Editor recomendado

VS Code com a extensão Dart. Gratuito, multiplataforma, leve, e tem a melhor integração com Dart depois das ferramentas oficiais.

Instalação:

1. Baixe VS Code de code.visualstudio.com. Instale normalmente.
2. Abra VS Code, vá em Extensions (Cmd/Ctrl+Shift+X), pesquise “Dart”. Instale a extensão oficial (publisher: Dart Code).
3. Pronto. Quando você abrir um arquivo .dart, VS Code vai colorir a sintaxe, mostrar erros enquanto você digita, sugerir auto-completar, e mostrar documentação ao passar o mouse sobre uma função.

Alternativas se você preferir:

• IntelliJ IDEA Community Edition + plugin Dart. Mais pesado, mas tem refatorações poderosas.
• Android Studio + plugin Dart. Mesmo plugin do IntelliJ; útil se você já tem Android Studio instalado.
• Vim/Neovim + plugin de Dart LSP. Para os que já vivem no terminal.

Quando algo der errado

Os cinco problemas mais comuns na instalação, e como resolver cada um:

1. dart: command not found. O Dart instalou, mas o terminal não sabe onde encontrar. Solução: adicionar ao PATH. No macOS/Linux, edite ~/.zshrc ou ~/.bashrc e adicione uma linha tipo export PATH="$PATH:/usr/lib/dart/bin" (ajuste o caminho conforme onde o Dart foi instalado). Reinicie o terminal.

2. Permission denied. Você não tem permissão para executar. No macOS/Linux: chmod +x /caminho/para/dart. No Windows: rodar o terminal como administrador.

3. Versão incompatível com algum tutorial online. Tutoriais antigos podem assumir Dart 2.x; o livro principal usa Dart 3+. Sempre instale a versão stable mais recente. Se precisar atualizar: brew upgrade dart (macOS), sudo apt-get upgrade dart (Linux), choco upgrade dart-sdk (Windows).

4. Proxy corporativo bloqueando. Em redes de empresa, o dart pub pode falhar ao baixar pacotes. Configure as variáveis de ambiente HTTP_PROXY e HTTPS_PROXY apontando para o proxy da empresa.

5. Antivírus bloqueando execução. Alguns antivírus marcam compiladores como suspeitos. Adicione a pasta do Dart SDK à lista de exceções.

Se nada disso funciona, o livro principal tem comunidade ativa - poste o erro com a versão do seu SO e alguém vai te ajudar. Não desista na instalação - é o degrau menos divertido e o que tem mais cara de obstáculo.