Skip to content

2. Configuração do ambiente de desenvolvimento

Nota: nas etapas a seguir, usaremos a ferramenta VSCode para testar os scripts Dart. Abra duas janelas do VSCode e use [File / Open Folder] para abrir as pastas dos dois projetos.

O curso de TypeScript instala Node.js, um projeto npm ([package.json]), o próprio TypeScript e seu verificador de tipos ([tsc]), um executor de scripts que dispensa compilação prévia ([tsx]) e, por fim, o ESLint. O equivalente Dart de toda essa cadeia de ferramentas consiste em um único componente a instalar: o [Dart SDK] — que pode ser baixado em [dart.dev] ou, de forma mais simples, instalado por um gerenciador de pacotes do sistema ([choco install dart-sdk] no Windows, [brew install dart] no macOS ou o repositório APT oficial no Linux/Debian/Ubuntu).

Enquanto o TypeScript exige três ferramentas distintas (o compilador [tsc] para verificar os tipos, o [tsx] para executar um script sem compilá-lo antes e o ESLint para a análise de estilo), o SDK do Dart oferece tudo isso em um único comando, [dart], que inclui os seguintes subcomandos: [dart run] (executa um script), [dart analyze] (verifica o estilo — o equivalente combinado de [tsc] e ESLint), [dart pub] (gerencia as dependências, equivalente a [npm]), [dart format] (reformata o código, equivalente ao Prettier) e [dart test] (executa os testes).

2.1. Verificação das ferramentas instaladas

Depois de instalar o SDK, verifique a instalação em um terminal do VSCode:

PS C:\Data\st-2026\dev\dart\dart-sept-2026-scripts\dart-fundamentals> dart --version
Dart SDK version: 3.12.2 (stable) (Tue Jun 9 01:11:39 2026 -0700) on "windows_x64"

que exibe a versão do SDK (por exemplo, [Dart SDK version: 3.12.2 (stable)]). Ao contrário de Node.js e TypeScript, que são instalados separadamente (uma versão do Node, uma versão do TypeScript), o número de versão do Dart SDK abrange a linguagem, o compilador e todas as ferramentas controladas por [dart]: há uma única versão a acompanhar.

2.2. Configuração do projeto VSCode

Como no TypeScript, crie uma pasta de projeto e abra-a no VSCode. Enquanto um projeto TypeScript é declarado com dois arquivos ([package.json] para as dependências, [tsconfig.json] para as opções do compilador), um projeto Dart exige apenas um: [pubspec.yaml].

2.2.1. O arquivo pubspec.yaml

[pubspec.yaml] cumpre ao mesmo tempo o papel do [package.json] (nome do projeto, dependências) e, em menor grau, o do [tsconfig.json] (a chave [environment: sdk:] define o intervalo de versões do Dart SDK aceitas, de forma semelhante a como [target]/[lib] definem a versão do ECMAScript visada pelo [tsc]):

1
2
3
4
5
6
7
8
9
name: dart_fundamentals
description: Scripts of the course "Introduction to the Dart language by example"
publish_to: 'none'
environment:
  sdk: '>=3.3.0 <4.0.0'

dependencies:
  http: ^1.2.0
  dio: ^5.4.0

Ao contrário do [package.json] (em formato JSON), o [pubspec.yaml] é, a rigor, um arquivo YAML — nele a indentação é significativa, assim como em Python.

Depois que esse arquivo é escrito, o comando [dart pub get] (equivalente a [npm install]) baixa as dependências declaradas e gera um arquivo [pubspec.lock] (equivalente ao [package-lock.json]), que fixa as versões exatas a instalar.

2.3. Primeiro script

Um script Dart mínimo, [hello.dart]:

1
2
3
void main() {
  print('Hello Dart!');
}

é executado com:

dart run hello.dart

Duas diferenças imediatas em relação ao primeiro script TypeScript do curso: a função [main] é aqui OBRIGATÓRIA (um script Dart executável deve definir uma função chamada [main] no nível do arquivo — ao contrário de TypeScript/[tsx], em que o código de nível superior do arquivo é executado diretamente, sem exigir a definição de uma função); e [dart run] compila e executa o script em uma única etapa, sem uma etapa de transpilação separada visível (como o [tsx], mas sem necessidade de instalar nenhuma ferramenta adicional: [dart run] faz parte do próprio SDK).

2.4. Segundo script: análise estática

Enquanto o curso de TypeScript distingue uma etapa de “verificação de tipos” ([tsc --noEmit]) e uma etapa separada do ESLint, Dart reúne as duas em um único comando:

dart analyze

Quando executado sem argumentos na raiz de um projeto que contém um arquivo [pubspec.yaml], ele analisa todos os arquivos [.dart] do projeto: sinaliza tanto os erros de tipo (o equivalente de [tsc]) quanto os problemas de estilo cobertos pelas regras de lint habilitadas (o equivalente do ESLint) — veja a seção seguinte para saber como habilitar essas regras.

2.5. O linter

O ESLint é uma ferramenta externa que precisa ser instalada e configurada separadamente (arquivo [eslint.config.js], escolha de um preset etc.). Dart integra seu próprio linter diretamente ao [dart analyze]: basta adicionar o pacote oficial [package:lints] às [dev_dependencies] do [pubspec.yaml] e, depois, criar um arquivo [analysis_options.yaml] na raiz do projeto:

include: package:lints/recommended.yaml

Esse único arquivo cumpre a mesma função do [eslint.config.js] do curso de TypeScript: ele ativa um conjunto de regras recomendadas pela equipe do Dart (variáveis não usadas, comparações suspeitas, preferência por [const] etc.), que o [dart analyze] aplica automaticamente.

2.6. Extensão Dart do VSCode

A extensão oficial [Dart] (publicador: Dart Code), instalada pelo marketplace de extensões do VSCode, cumpre exatamente a mesma função da extensão ESLint do curso de TypeScript, mas é mais completa: realce de sintaxe, autocompletar, exibição dos erros do [dart analyze] diretamente no editor e execução dos scripts (o botão [Run]/[Debug] acima de cada função [main]) sem sair do VSCode. Instalar essa única extensão basta para cobrir o que o curso de TypeScript distribui por várias extensões.