dart run

O comando dart run permite executar, a partir da linha de comando, um programa Dart localizado em um arquivo, no pacote atual ou em uma das dependências do pacote atual. Este comando oferece funcionalidades que antes estavam no pub run e na ferramenta da Dart VM.

dart run [options] [<DART_FILE> | <PACKAGE_TARGET>] [args]

Aqui está um exemplo de criação de um novo aplicativo e sua execução:

$ dart create myapp
$ cd myapp
$ dart run

Para executar um executável de um pacote remoto sem adicioná-lo como dependência ou instalá-lo, especifique o nome do pacote seguido do símbolo @.

Por exemplo:

$ dart run dhttpd@

O Dart resolve o pacote no pub.dev, baixa-o se necessário, e compila e executa o executável padrão dele.

Use esta forma para ferramentas pontuais e utilitários temporários.

A sintaxe completa é:

dart run <PACKAGE>[:<EXECUTABLE>]@[<DESCRIPTOR>] [args]

A parte :<EXECUTABLE> especifica o executável a ser executado. A parte @[<DESCRIPTOR>] especifica a versão do pacote ou a restrição de versão. As duas partes são opcionais.

ia-translate: true

Você pode executar um arquivo Dart passando o caminho relativo dele:

$ dart run tool/debug.dart

As instruções desta seção supõem que você está executando o comando dart run a partir do diretório que fica no topo de um pacote Dart (o pacote atual). Para informações sobre a estrutura de diretórios dos pacotes Dart, consulte convenções de layout de pacote.

Você pode executar programas distribuídos no diretório bin de qualquer pacote do qual o pacote atual depende. Para executar esse tipo de programa, especifique o nome do pacote do qual você depende e o nome do programa. Você pode omitir o nome do programa se ele for igual ao nome do pacote.

Por exemplo, suponha que você esteja no diretório superior de um pacote que depende do pacote bar. Para executar o programa principal que está no pacote bar (bin/bar.dart), você pode usar este comando:

$ dart run bar

Se o nome do programa não corresponder ao nome do pacote, use a forma <package name>:<program name>. Por exemplo, para executar o programa bin/baz.dart que está no pacote bar, use este comando:

$ dart run bar:baz

O diretório bin é o único lugar com programas visíveis. Todos os outros diretórios do pacote do qual você depende são privados.

Quando o diretório atual corresponde ao nome do pacote (ou seja, você está no diretório que corresponde à propriedade name no pubspec), você pode omitir o nome do pacote. Se o nome do programa corresponder ao nome do pacote (ou seja, se for o programa principal), você também pode omitir o nome do programa.

Aqui está a forma mais curta de dart run, que executa o programa principal do pacote atual. Por exemplo, se você estiver no diretório superior do pacote foo, este comando executa bin/foo.dart:

$ dart run

Se o nome do programa não corresponder ao nome do pacote, adicione dois-pontos e o nome do programa. Por exemplo, este comando executa bin/baz.dart no pacote atual:

$ dart run :baz

Para executar um programa que está no pacote atual, mas não no diretório bin, passe um caminho relativo (como mostrado antes):

$ dart run tool/debug.dart

Para passar argumentos para a função main(), coloque-os no final do comando:

$ dart run tool/debug.dart arg1 arg2

Quando você executa o programa principal do pacote atual, adicione o nome do pacote. Aqui está um exemplo de execução de bin/foo.dart com argumentos enquanto você está no diretório superior do pacote foo:

$ dart run foo arg1 arg2

Para habilitar a depuração, adicione uma ou mais destas opções comuns de depuração ao seu comando dart run:

• Para habilitar as instruções assert, adicione a flag --enable-asserts:

  $ dart run --enable-asserts tool/debug.dart
  

  content_copy

• Para habilitar a depuração e a análise de desempenho pelo Dart DevTools, adicione a flag --observe:

  $ dart run --observe tool/debug.dart
  

  content_copy

  Para saber mais sobre depuração com o Dart DevTools, consulte Usando o DevTools com uma aplicação de linha de comando.

Para saber mais sobre outras opções de depuração, execute dart run --help.

Para habilitar novos recursos e melhorias que estão em desenvolvimento, use as experiment flags.