005 Desarrollo
005.1 Desarrollo

Dart en la línea de comandos

Ahora que tiene instalado el SDK de Dart, utilizará la VM de Dart para ejecutar algunas líneas de código, primero en un solo archivo y luego como un proyecto completo.

Ejecución de un solo archivo Dart

Busca o crea una carpeta conveniente en tu computadora donde puedas guardar los proyectos de Dart que crees en este libro. Crea un nuevo archivo de texto en esa carpeta y nómbralo hello.dart.

Escribiendo el código

A continuación, agregue el siguiente código Dart a ese archivo vacío:

void main() {
    print('Hola, Dart!');
}

main es el nombre de la función con la que se inician todos los programas Dart. Dentro de esa función, se llama a otra función, print, que muestra el texto Hola, Dart! en la pantalla.

Ejecutando el código

Guarde el archivo y luego ejecute el siguiente comando de terminal en la misma carpeta que hello.dart:

dart run hello.dart

La palabra clave run es la herramienta run del SDK de Dart que ya conociste. Ejecuta el código en hello.dart en la máquina virtual de Dart.

Ahora debería ver el siguiente resultado en la consola:

Hola, Dart!

¡Felicitaciones! Has escrito y ejecutado tu primer programa Dart.

Configurar un proyecto de Dart completo

Es bueno poder ejecutar un solo archivo, pero a medida que creas proyectos más grandes, querrás dividir tu código en partes manejables e incluir también archivos de configuración y recursos. Para ello, necesitas crear un proyecto Dart completo. ¿Recuerdas la herramienta create? Ha llegado el momento.

Creando el Proyecto

Vaya a la ubicación donde desea crear su carpeta de proyecto y luego ejecute el siguiente comando en la terminal:

dart create hello_dart

Esto crea un proyecto Dart simple con algún código predeterminado.

Ejecutando el proyecto

Ingresa a la nueva carpeta que acabas de crear de la siguiente manera:

cd hello_dart

Ahora ejecute el proyecto con el siguiente comando:

dart run bin/hello_dart.dart

Verá el texto Hola mundo: 42!, que es la salida del código en el proyecto predeterminado que generó la herramienta crear.

La palabra clave run es opcional. Ejecute el proyecto de nuevo sin ella:

dart bin/hello_dart.dart

Nuevamente, el resultado es Hola mundo: 42!.

La estructura de un proyecto Dart

Eche un vistazo a la estructura y el contenido de la carpeta hello_dart:

Los propósitos de los elementos más importantes de esa carpeta son los siguientes:

  • gitignore: Indica a Git qué archivos relacionados con Dart no necesita guardar en GitHUB o en cualquier otro repositorio de Git que estés usando.

  • analysis_options.yaml: contiene reglas especiales que le ayudarán a detectar problemas con su código, un proceso conocido como linting.

  • bin: Contiene el código ejecutable de Dart.

  • hello_dart.dart: tiene el mismo nombre que la carpeta del proyecto; la herramienta crear generó este archivo para que usted coloque allí su código Dart.

  • CHANGELOG.md: Contiene una lista, editada manualmente y en formato Markdown, de las últimas actualizaciones de tu proyecto. Al publicar una nueva versión de un proyecto Dart, debes informar a los demás desarrolladores sobre los cambios.

  • lib: Significa “biblioteca”. En proyectos más grandes, tendrás muchos archivos .dart que organizarás en la carpeta lib. De forma similar a como una biblioteca normal guarda una colección de libros que puedes pedir prestados, una biblioteca en el mundo de Dart guarda una colección de código que puedes usar en otros lugares.

  • pubspec.yaml: Contiene una lista de las dependencias de terceros de Pub que desea usar en su proyecto. El nombre “pubspec” significa “Especificaciones de Pub”. También puede configurar el número de versión de su proyecto en este archivo.

  • pubspec.lock: Especifica la versión exacta de cada dependencia que utiliza el proyecto. Esto ayuda a los equipos a garantizar que todos usen las mismas dependencias.

  • README.md: Describe la función de tu proyecto y cómo usarlo. Otros desarrolladores lo agradecerán enormemente.

  • prueba: Almacena tus archivos de prueba. Los buenos desarrolladores escriben código para verificar que sus programas se comporten como se espera.

NoteNota:

YAML significa “YAML Ain’t Markup Language”, uno de esos acrónimos recursivos con los que los programadores disfrutan divirtiéndose. YAML es una forma clara y legible de formatear archivos de configuración, y te encontrarás con este tipo de archivo a menudo en tu carrera en Dart.