Construye tu primera aplicación

Crea, ejecuta y realiza tu primer cambio en un programa de línea de comandos en Dart.

Ver en YouTube en una nueva pestaña: "What is Dart?"

¡Te damos la bienvenida a Dart! En este capítulo, te asegurarás de que tu configuración esté completa y luego trabajarás en la creación de tu primer programa en Dart. ¡Este capítulo comienza de forma sencilla pero avanza rápido!

Qué lograrás

Verificar tu instalación del SDK de Dart

Crear un proyecto de CLI con dart create

Ejecutar y modificar tu primer programa

Antes de comenzar este capítulo, asegúrate de:

Instalado el SDK de Dart.
Haber revisado la información general de Dart (si eres nuevo en Dart).

Crea el clásico Hello World en Dart para iniciar tu proyecto.

Primero, asegúrate de que Dart esté listo en tu sistema siguiendo estos pasos.

Abre una terminal (o símbolo del sistema).
Ejecuta el siguiente comando para verificar la versión de tu SDK de Dart:
bash
```
dart --version
```
Asegúrate de ver una salida similar a esta (los números de versión pueden ser diferentes):
bash
```
Dart SDK version: 3.9.2 (stable) (Wed Aug 27 03:49:40 2025 -0700) on "linux_x64"
```
Si ves un error como "command not found" (comando no encontrado), consulta la guía de instalación de Dart para configurar tu entorno.

Ahora, crea tu primera aplicación de línea de comandos en Dart.

En la misma terminal, crea un nuevo directorio llamado dartpedia para albergar tu proyecto. Luego cámbiate a ese directorio.
bash
```
mkdir dartpedia
cd dartpedia
```
Ejecuta el siguiente comando:
bash
```
dart create cli
```
El comando dart create genera un proyecto Dart básico llamado "cli" (por Interfaz de Línea de Comandos). Configura los archivos y directorios esenciales que necesitas.

Deberías ver una salida similar a esta, confirmando la creación del proyecto:

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

A continuación, ejecuta tu programa para probarlo.

En la terminal, navega al directorio de tu nuevo proyecto:
bash
```
cd cli
```
Ejecuta la aplicación predeterminada:
bash
```
dart run
```
Este comando le indica a Dart que ejecute tu programa.
Deberías ver la siguiente salida:
bash
```
Building package executable...
Built cli:cli.
Hello world: 42!
```
¡Felicitaciones! ¡Has ejecutado con éxito tu primer programa Dart!

A continuación, modifica el código que generó Hello world: 42!.

En un editor de código, abre el archivo bin/cli.dart.
El directorio bin/ es donde vive tu código ejecutable. cli.dart es el punto de entrada de tu aplicación.
Adentro, verás la función main. Todo programa en Dart comienza a ejecutarse desde su función main.

Asegúrate de que tu bin/cli.dart se vea así:

bin/cli.dart

dart

import 'package:cli/cli.dart' as cli;

void main(List<String> arguments) {
  print('Hello world: ${cli.calculate()}!');
}

Simplifica la salida por ahora. Elimina la primera línea (no necesitas esta sentencia de importación) y cambia la sentencia print para mostrar un saludo simple:
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
}
```
Guarda tu archivo. Luego en la terminal, ejecuta tu programa de nuevo:
bash
```
dart run
```
Verifica para asegurarte de que ves lo siguiente:
bash
```
Building package executable...
Built cli:cli.
Hello, Dart!
```
¡Has modificado y vuelto a ejecutar con éxito tu primer programa Dart!

Qué lograste

Aquí tienes un resumen de lo que construiste y aprendiste en esta lección.

Verificaste la instalación de tu SDK de Dart

Ejecutaste dart --version para confirmar que Dart está correctamente instalado y accesible desde tu terminal.

Creaste tu primer proyecto de CLI

Usaste dart create para generar una nueva aplicación de línea de comandos. Este comando estructura un proyecto básico con archivos esenciales como pubspec.yaml. También genera un archivo bin/cli.dart con una función main que actúa como el punto de entrada para tu programa.

Ejecutaste y modificaste tu programa

Ejecutaste tu aplicación con dart run y viste la salida de "Hello world". Luego modificaste la función main para imprimir un saludo personalizado, experimentando de primera mano el ciclo de edición y ejecución de Dart.

Aquí tienes un cuestionario rápido para consolidar tu aprendizaje.

Pon a prueba tu comprensión

1 / 3

Which command generates a new Dart project with the necessary files and directory structure?

dart new
No exactamente.
No existe el comando dart new en Dart. Piensa en qué acción deseas realizar al comenzar un proyecto desde cero.
dart create
¡Correcto!
dart create crea y estructura un nuevo proyecto. También puedes usar -t para especificar una plantilla, como dart create -t console nombre_del_proyecto.
dart init
No exactamente.
Aunque algunas otras herramientas utilizan init para este propósito, Dart utiliza un comando diferente. Revisa la lección para ver qué comando se utilizó.
dart build
No exactamente.
dart build se utiliza para construir aplicaciones de Dart existentes para su despliegue, no para estructurar nuevos proyectos.

Every Dart program starts executing from a specific function. What is this function called and why is it important?

La función main. Es el punto de entrada donde comienza la ejecución del programa.
¡Correcto!
La función main es obligatoria en los programas ejecutables de Dart. Sin ella, Dart no sabría por dónde empezar a ejecutar tu código.
La función init. Configura variables antes de que comience el programa.
No exactamente.
Dart no requiere una función init. Las variables se pueden definir e inicializar en cualquier función.
La función start. Inicializa el entorno de ejecución.
No exactamente.
Dart no tiene una función start. El entorno de ejecución de Dart se inicializa automáticamente antes de que se ejecute tu código.
La función run. Es llamada por el comando dart run.
No exactamente.
No hay una función run obligatoria. El comando dart run busca y ejecuta la función de punto de entrada estándar.

In a Dart CLI project, where should you place the file containing your main function?

En el directorio bin/, porque esa es la ubicación estándar para los puntos de entrada de CLI de Dart.
¡Correcto!
El directorio bin/ contiene los puntos de entrada de Dart de un programa. Cuando ejecutas dart run, Dart busca aquí el punto de entrada de tu paquete.
En el directorio src/, porque esa es la carpeta de origen estándar.
No exactamente.
Los proyectos Dart suelen utilizar lib/src/ para detalles de implementación, no para puntos de entrada ejecutables.
En la raíz del proyecto, junto a pubspec.yaml.
No exactamente.
Aunque técnicamente es posible, los proyectos Dart tienen un directorio convencional para los ejecutables. Verifica dónde colocó el archivo del punto de entrada dart create.
En el directorio lib/, porque allí es donde pertenece todo el código Dart.
No exactamente.
El directorio lib/ es para el código de librería que puede ser importado por otros paquetes.

En la siguiente lección, aprenderás a hacer que tu programa responda a comandos específicos introduciendo argumentos de línea de comandos y la palabra clave const.

¿Fue útil el contenido de esta página?

A menos que se indique lo contrario, la documentación de este sitio refleja Dart 3.12.2. Página actualizada por última vez el 22-01-2026. Ver fuente oreportar un problema.

Construye tu primera aplicación

Qué lograrás

Prerrequisitos

Tareas

Tarea 1: Confirmar tu configuración de Dart

Tarea 2: Crear un nuevo proyecto Dart

Tarea 3: Ejecutar tu primer programa Dart

Tarea 4: Realizar tu primer cambio de código

Revisión

Qué lograste

Cuestionario

Pon a prueba tu comprensión

Siguiente lección