Instalación y configuración del entorno de ejecución de Dart
Para desarrollar con Dart, necesitas el SDK (Software Development Kit), que es un conjunto de herramientas que incluye el compilador, la máquina virtual y las librerías base para que tu código pueda ejecutarse. No es solo un archivo, sino un entorno completo de trabajo. Tienes tres caminos principales para conseguirlo: usar un gestor de paquetes del sistema operativo (como apt en Linux, brew en macOS o choco en Windows), que es la forma más sencilla de mantenerlo actualizado; realizar una instalación manual descargando el archivo directamente desde dart.dev, lo cual te da control total pero requiere que gestiones las rutas tú mismo; o utilizar el SDK de Flutter, que ya trae una versión de Dart integrada y es ideal si tu objetivo es el desarrollo de aplicaciones móviles.
Si optas por la instalación manual, notarás que el SDK se organiza en carpetas clave: la carpeta bin/ contiene los ejecutables (como el comando dart), lib/ guarda las librerías esenciales del lenguaje y include/ se utiliza para la interoperabilidad con otros lenguajes. Un punto crítico es la variable de entorno PATH. El PATH es una lista de rutas que el sistema operativo consulta cada vez que escribes un comando en la terminal. Si la ruta de la carpeta bin/ de tu SDK no está en el PATH, tu sistema operativo no sabrá dónde encontrar el comando dart y te devolverá un error de “comando no encontrado”.
Puedes elegir entre diferentes canales de release: el canal stable es el recomendado para producción por su estabilidad; el canal beta es para probar funciones que están próximas; y el canal dev es el más experimental. Si configuras mal el PATH o mezclas versiones de forma inconsistente, podrías terminar con conflictos de dependencias o comandos que simplemente no responden.
import 'dart:io';
void main() {
// Usamos la librería dart:io para interactuar con el sistema
final sistema = Platform.operatingSystem;
final version = Platform.version;
print('--- Diagnóstico del entorno Dart ---');
print('Sistema operativo detectado: $sistema');
print('Versión de la VM y canal: $version');
print('-----------------------------------');
// Verificamos si el canal de la versión instalada es el estable
if (version.contains('stable')) {
print('Resultado: Estás usando un canal estable. Estás listo para producir.');
} else {
print('Resultado: Estás en un canal experimental/beta. Úsalo con precaución.');
}
}
En el código que acabas de ver, estamos utilizando la clase Platform de la librería dart:io. La propiedad Platform.operatingSystem nos devuelve una cadena que nos indica qué sistema operativo está detectando el SDK, algo vital para saber si la instalación de Windows, macOS o Linux se ha realizado correctamente. La propiedad Platform.version es fundamental porque nos indica exactamente qué versión de Dart se está ejecutando y, muy importante, en qué canal se encuentra (si la cadena contiene stable, beta o dev). Esto te permite verificar si la configuración que hiciste mediante apt, brew o la descarga manual ha sido exitosa y si estás trabajando en el canal de release adecuado para tu proyecto.
El error frecuente
El error más común para un principiante es instalar el SDK pero recibir el mensaje command not found: dart al intentar usarlo en la terminal. Esto ocurre porque, aunque los archivos estén en tu disco, la carpeta bin/ del SDK no ha sido añadida a la variable de entorno PATH. Para solucionarlo, debes localizar la ruta completa de tu carpeta bin y agregarla a los archivos de configuración de tu terminal, como .bashrc o .zshrc en Linux/macOS, o en las Variables de Entorno en el Panel de Control de Windows.
Para asegurarte de que el cambio surtió efecto, cierra la terminal y abre una nueva tras modificar tu archivo de configuración.
N° 4