Pular para o conteúdo principal

Crie seu primeiro aplicativo

Crie, execute e faça sua primeira alteração em um programa de linha de comando Dart.

Assistir no YouTube em uma nova aba: "O que é 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

Verificar a instalação do Dart SDK
Criar um projeto CLI com dart create
Executar e modificar seu primeiro programa

Pré-requisitos

#

Antes de começar este capítulo, certifique-se de:

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.

  1. Abra um terminal (ou prompt de comando).

  2. Execute o seguinte comando para verificar a versão do seu Dart SDK:

    bash
    dart --version
    
  3. Verifique se você vê uma saída parecida com esta (os números da versão podem ser diferentes):

    bash
    Dart 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.

  1. No mesmo terminal, crie um diretório chamado dartpedia para guardar seu projeto. Depois, entre nesse diretório.

    bash
    mkdir dartpedia
    cd dartpedia
    
  2. Execute o seguinte comando:

    bash
    dart create cli
    

    O comando dart create gera 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.

  3. Você deve ver uma saída parecida com esta, confirmando a criação do projeto:

    bash
    Creating 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.

  1. No terminal, entre no diretório do seu novo projeto:

    bash
    cd cli
    
  2. Execute o aplicativo padrão:

    bash
    dart run
    

    Este comando diz ao Dart para executar seu programa.

  3. Você deve ver a seguinte saída:

    bash
    Building 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!.

  1. 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ção main.

  2. Verifique se o seu bin/cli.dart se parece com isto:

    bin/cli.dart
    dart
    import 'package:cli/cli.dart' as cli;
    ​
    void main(List<String> arguments) {
      print('Hello world: ${cli.calculate()}!');
    }
    
  3. Simplifique a saída por enquanto. Apague a primeira linha (você não precisa desta instrução import) e altere a instrução print para exibir uma saudação simples:

    bin/cli.dart
    dart
    import 'package:cli/cli.dart' as cli; // Delete this entire line
    ​
    void main(List<String> arguments) {
      print('Hello, Dart!'); // Change this line
    }
    
  4. Salve seu arquivo. Depois, no terminal, execute o programa novamente:

    bash
    dart run
    
  5. Verifique se você vê o seguinte:

    bash
    Building 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
Qual comando gera um novo projeto Dart com os arquivos necessários e a estrutura de diretórios?
  1. dart create

    Isso mesmo!

    dart create cria e gera a estrutura inicial de um novo projeto. Você também pode usar -t para especificar um template, como em dart create -t console nome_do_projeto.

  2. dart new

    Não exatamente.

    Não existe um comando dart new no Dart. Pense em qual ação você quer executar ao começar um projeto do zero.

  3. dart init

    Não exatamente.

    Algumas outras ferramentas usam init para isso, mas o Dart usa outro comando. Revise a lição para ver qual comando foi usado.

  4. dart build

    Não exatamente.

    dart build serve para compilar aplicativos Dart existentes para implantação, não para gerar a estrutura de novos projetos.

Todo programa Dart começa a execução a partir de uma função específica. Como se chama essa função e por que ela é importante?
  1. 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.

  2. 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.

  3. A função run. Ela é chamada pelo comando dart run.

    Não exatamente.

    Não existe uma função run obrigatória. O comando dart run procura e executa a função de entrada padrão.

  4. 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.

Em um projeto CLI em Dart, onde você deve colocar o arquivo que contém a função main?
  1. 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 executar dart run, o Dart procura aqui o ponto de entrada do seu pacote.

  2. 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 usam lib/main.dart como ponto de entrada, aplicativos CLI padrão em Dart usam o diretório bin/.

  3. 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.

  4. 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 create colocou 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.

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ê.