dart run

El comando dart run permite ejecutar un programa Dart —ubicado en un archivo, en el paquete actual o en una de las dependencias del paquete actual— desde la línea de comandos. Este comando proporciona funcionalidad que anteriormente estaba en pub run y en la herramienta Dart VM. Para ejecutar un programa desde una ubicación arbitraria, usa el comando pub global.

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

Aquí tienes un ejemplo de cómo crear una nueva aplicación y ejecutarla:

$ dart create myapp
$ cd myapp
$ dart run

Puedes ejecutar un archivo Dart pasando su ruta relativa:

$ dart run tool/debug.dart

Las instrucciones de esta sección asumen que estás ejecutando el comando dart run desde el directorio raíz de un paquete Dart (el paquete actual). Para más información sobre la estructura de directorios de los paquetes Dart, consulta convenciones de diseño de paquetes.

Puedes ejecutar programas que se distribuyen en el directorio bin de cualquier paquete del cual dependa el paquete actual. Para ejecutar dicho programa, especifica el nombre del paquete del que se depende y el nombre del programa. Puedes omitir el nombre del programa si es el mismo que el del paquete.

Por ejemplo, supongamos que estás en el directorio superior de un paquete que depende del paquete bar. Para ejecutar el programa principal que está en el paquete bar (bin/bar.dart), puedes usar este comando:

$ dart run bar

Si el nombre del programa no coincide con el nombre del paquete, usa el formato <package name>:<program name>. Por ejemplo, la ejecución del programa bin/baz.dart que está en el paquete bar, se hace con este comando:

$ dart run bar:baz

El directorio bin es el único lugar con programas visibles. Todos los demás directorios en el paquete del que se depende son privados.

Cuando el directorio actual coincide con el nombre del paquete (es decir, estás en el directorio que coincide con la propiedad name en el pubspec), entonces puedes omitir el nombre del paquete. Si el nombre del programa coincide con el nombre del paquete (es decir, es el programa principal), entonces también puedes omitir el nombre del programa.

Aquí tienes la forma más corta de dart run, que ejecuta el programa principal para el paquete actual. Por ejemplo, si estás en el directorio raíz del paquete foo, este comando ejecuta bin/foo.dart:

$ dart run

Si el nombre del programa no coincide con el nombre del paquete, añade dos puntos y el nombre del programa. Por ejemplo, este comando ejecuta bin/baz.dart en el paquete actual:

$ dart run :baz

Para ejecutar un programa que está en el paquete actual pero no en el directorio bin, pasa una ruta relativa (como se mostró anteriormente):

$ dart run tool/debug.dart

Para proporcionar argumentos a la función main(), colócalos al final del comando:

$ dart run tool/debug.dart arg1 arg2

Cuando estés ejecutando el programa principal para el paquete actual, añade el nombre del paquete. Aquí tienes un ejemplo de cómo ejecutar bin/foo.dart con argumentos mientras estás en el directorio raíz del paquete foo:

$ dart run foo arg1 arg2

Para habilitar la depuración, añade una o más de estas opciones de depuración comunes a tu comando dart run:

• Para habilitar las sentencias assert, añade la bandera --enable-asserts:

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

  content_copy

• Para habilitar la depuración y el análisis de rendimiento a través de Dart DevTools, añade la bandera --observe:

  $ dart run --observe tool/debug.dart
  

  content_copy

  Para aprender más sobre la depuración con Dart DevTools, consulta Uso de DevTools con una aplicación de línea de comandos.

Para aprender más sobre otras opciones de depuración, ejecuta dart run --help.

Para habilitar nuevas características y mejoras que están actualmente en desarrollo, usa banderas de experimentos.