Crie seu primeiro aplicativo
Crie, execute e faça sua primeira alteração em um programa de linha de comando Dart.
Bem-vindo ao Dart! Neste capítulo, você vai garantir que sua configuração está completa e depois criar seu primeiro programa Dart. Este capítulo começa simples, mas avança rápido!
O que você vai realizar
Pré-requisitos
#Antes de começar este capítulo, certifique-se de:
- Ter instalado o Dart SDK.
- Ter lido a visão geral do Dart (se você é novo no Dart).
Tarefas
#Crie o clássico Hello World em Dart para começar seu projeto.
Tarefa 1: Confirme sua configuração do Dart
#Primeiro, certifique-se de que o Dart está pronto para uso no seu sistema seguindo estes passos.
Abra um terminal (ou prompt de comando).
-
Execute o seguinte comando para verificar a versão do seu Dart SDK:
bashdart --version -
Verifique se você vê uma saída parecida com esta (os números da versão podem ser diferentes):
bashDart SDK version: 3.9.2 (stable) (Wed Aug 27 03:49:40 2025 -0700) on "linux_x64"Se você vir um erro como "command not found", consulte o guia de instalação do Dart para configurar seu ambiente.
Tarefa 2: Crie um novo projeto Dart
#Agora, crie seu primeiro aplicativo de linha de comando em Dart.
-
No mesmo terminal, crie um diretório chamado
dartpediapara guardar seu projeto. Depois, entre nesse diretório.bashmkdir dartpedia cd dartpedia -
Execute o seguinte comando:
bashdart create cliO comando
dart creategera um projeto Dart básico chamado "cli" (de Command Line Interface, ou interface de linha de comando). Ele cria os arquivos e diretórios essenciais de que você precisa. -
Você deve ver uma saída parecida com esta, confirmando a criação do projeto:
bashCreating cli using template console... .gitignore analysis_options.yaml CHANGELOG.md pubspec.yaml README.md bin/cli.dart lib/cli.dart test/cli_test.dart Running pub get... 1.2s Resolving dependencies... Downloading packages... Changed 49 dependencies! Created project cli in cli! In order to get started, run the following commands: cd cli dart run
Tarefa 3: Execute seu primeiro programa Dart
#Agora, execute seu programa para testá-lo.
-
No terminal, entre no diretório do seu novo projeto:
bashcd cli -
Execute o aplicativo padrão:
bashdart runEste comando diz ao Dart para executar seu programa.
-
Você deve ver a seguinte saída:
bashBuilding package executable... Built cli:cli. Hello world: 42!Parabéns! Você executou com sucesso seu primeiro programa Dart!
Tarefa 4: Faça sua primeira alteração de código
#Agora, modifique o código que gera Hello world: 42!.
-
Em um editor de código, abra o arquivo
bin/cli.dart.O diretório
bin/é onde fica o seu código executável.cli.darté o ponto de entrada da sua aplicação.Dentro dele, você verá a função
main. Todo programa Dart começa a executar a partir da sua funçãomain. -
Verifique se o seu
bin/cli.dartse parece com isto:bin/cli.dartdartimport 'package:cli/cli.dart' as cli; void main(List<String> arguments) { print('Hello world: ${cli.calculate()}!'); } -
Simplifique a saída por enquanto. Apague a primeira linha (você não precisa desta instrução import) e altere a instrução
printpara exibir uma saudação simples:bin/cli.dartdartimport 'package:cli/cli.dart' as cli; // Delete this entire line void main(List<String> arguments) { print('Hello, Dart!'); // Change this line } -
Salve seu arquivo. Depois, no terminal, execute o programa novamente:
bashdart run -
Verifique se você vê o seguinte:
bashBuilding package executable... Built cli:cli. Hello, Dart!Você modificou e executou novamente seu primeiro programa Dart com sucesso!
Revisão
#O que você realizou
Veja um resumo do que você construiu e aprendeu nesta lição.Verificou a instalação do Dart SDK
Você executou dart --version para confirmar que o Dart está instalado corretamente e acessível pelo terminal.
Criou seu primeiro projeto CLI
Você usou dart create para gerar um novo aplicativo de linha de comando. Esse comando monta um projeto básico com arquivos essenciais como
pubspec.yaml. Ele também gera um arquivo bin/cli.dart com uma função main
que atua como ponto de entrada do seu programa.
Executou e modificou seu programa
Você executou seu app com dart run e viu a saída "Hello world". Depois, modificou a função
main para imprimir uma saudação personalizada, experimentando na prática o ciclo de editar e executar do Dart.
Quiz
#Aqui vai um quiz rápido para fixar o que você aprendeu.
Confira seu entendimento
1 / 3-
dart createIsso mesmo!
dart createcria e gera a estrutura inicial de um novo projeto. Você também pode usar-tpara especificar um template, como emdart create -t console nome_do_projeto. -
dart newNão exatamente.
Não existe um comando
dart newno Dart. Pense em qual ação você quer executar ao começar um projeto do zero. -
dart initNão exatamente.
Algumas outras ferramentas usam
initpara isso, mas o Dart usa outro comando. Revise a lição para ver qual comando foi usado. -
dart buildNão exatamente.
dart buildserve para compilar aplicativos Dart existentes para implantação, não para gerar a estrutura de novos projetos.
-
A função
main. É o ponto de entrada em que a execução do programa começa.Isso mesmo!
A função
mainé obrigatória em programas Dart executáveis. Sem ela, o Dart não saberia por onde começar a executar seu código. -
A função
start. Ela inicializa o ambiente de runtime.Não exatamente.
O Dart não tem uma função
start. O runtime do Dart é inicializado automaticamente antes de o seu código rodar. -
A função
run. Ela é chamada pelo comandodart run.Não exatamente.
Não existe uma função
runobrigatória. O comandodart runprocura e executa a função de entrada padrão. -
A função
init. Ela configura as variáveis antes de o programa começar.Não exatamente.
O Dart não exige uma função
init. Variáveis podem ser definidas e inicializadas em qualquer função.
main?
-
No diretório
bin/, porque é o local padrão dos pontos de entrada de CLIs em Dart.Isso mesmo!
O diretório
bin/contém os pontos de entrada em Dart de um programa. Ao executardart run, o Dart procura aqui o ponto de entrada do seu pacote. -
No diretório
lib/, porque é onde todo código Dart deve ficar.Não exatamente.
O diretório
lib/é para código de biblioteca que pode ser importado por outros pacotes. Observe que, enquanto aplicativos Flutter usamlib/main.dartcomo ponto de entrada, aplicativos CLI padrão em Dart usam o diretóriobin/. -
No diretório
src/, porque é a pasta de código-fonte padrão.Não exatamente.
Projetos Dart geralmente usam
lib/src/para detalhes de implementação, e não para pontos de entrada executáveis. -
Na raiz do projeto, ao lado do
pubspec.yaml.Não exatamente.
Embora seja tecnicamente possível, projetos Dart têm um diretório convencional para executáveis. Veja onde o
dart createcolocou o arquivo de entrada.
Próxima lição
#
Na próxima lição, você vai aprender como
fazer seu programa responder a comandos específicos,
apresentando argumentos de linha de comando e a keyword const.
Salvo indicação em contrário, a documentação neste site reflete Dart 3.13.7. Página atualizada pela última vez em 2026-11-12. Ver código-fonte ou relatar um problema.
Encontrou essa página sem tradução ou que precisa de correção? Abra uma issue e nos ajude a manter esse site em PT-BR para ajudar pessoas como você.