Primera aplicación Flutter
En esta sección se explicará cómo usar Flutter CLI para crear un nuevo proyecto de Flutter, ejecutar la aplicación y comprender la estructura de código más básica.
Crear un proyecto con Flutter CLI
Flutter CLI es la herramienta de línea de comandos de Flutter, utilizada para crear, gestionar y compilar proyectos de Flutter.
Crear un nuevo proyecto
Ejecuta el siguiente comando en la terminal para crear un nuevo proyecto de Flutter:
$ flutter create my_first_app
Dondemy_first_appes el nombre de tu proyecto. Flutter creará las carpetas y archivos correspondientes según este nombre.
El nombre del proyecto debe usar letras minúsculas y guiones bajos, no puede contener espacios ni caracteres especiales.
Parámetros del comando
flutter createEl comando admite varios parámetros:
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| --org | Especificar el identificador de organización (formato de dominio inverso) | --org com.example |
| --platforms | Especificar las plataformas compatibles | --platforms ios,android |
| --empty | Crear el proyecto con una plantilla mínima | --empty |
$ flutter create hello_world
Creating project "hello_world"...
.gitignore 2026-04-01 10:30:22
.metadata 2026-04-01 10:30:22
analysis_options.yaml 2026-04-01 10:01:15
pubspec.yaml 2026-04-01 10:30:22
README.md 2026-04-01 10:30:22
lib/
main.dart 2026-04-01 10:30:22
test/
widget_test.dart 2026-04-01 10:22:34
android/
ios/
web/
...
Running "flutter pub get"... 13.2s
Running "flutter analyze"... 3.2s
Ejecutar la aplicación Flutter
Iniciar el servidor de desarrollo
Una vez creado el proyecto, entra en el directorio del proyecto y ejecuta la aplicación:
$ cd hello_world $ flutter run
La primera ejecución puede tardar un poco, porque Flutter necesita compilar el código Dart e iniciar la aplicación.
Especificar el dispositivo de ejecución
Si tu computadora tiene varios dispositivos (o emuladores) conectados, puedes usar-dparámetro para especificar el dispositivo de ejecución:
| Dispositivo | Comando |
|---|---|
| Emulador de Android | flutter run -d android |
| Simulador de iOS | flutter run -d iphone |
| Navegador Chrome | flutter run -d chrome |
| Escritorio de Windows | flutter run -d windows |
Ver los dispositivos disponibles
Ejecuta el siguiente comando para ver todos los dispositivos de ejecución disponibles:
$ flutter devices
Ejemplo de salida:
2 connected devices: Chrome (web) • chrome • web-javascript • Chrome • web Windows (windows) • windows • windows • x64 • Windows 10.0.0
Función de recarga en caliente
Una de las funciones más potentes de Flutter es la recarga en caliente (Hot Reload). Cuando estás ejecutando la aplicación:
- Modifica el código y guarda
- En la terminal, pulsa
rTecla - La aplicación se recargará y podrás ver los últimos cambios
La recarga en caliente es muy rápida, normalmente solo toma uno o dos segundos. Esto mejora enormemente la eficiencia del desarrollo, permitiéndote previsualizar los efectos de la interfaz en tiempo real.
La recarga en caliente no pierde el estado de la aplicación, lo que significa que puedes iterar rápidamente el diseño de la UI sin reiniciar la aplicación.
Análisis del archivo main.dart
Cada proyecto de Flutter tiene un archivo de entradalib/main.dart. Veamos el contenido generado por defecto:
Ejemplo: código de main.dart
// Archivo de entrada de la aplicación Flutter
// Importar la biblioteca de componentes Material Design
import 'package:flutter/material.dart';
// Función de entrada de la aplicación
void main() {
// runApp es la función de inicio de Flutter
// Recibe un Widget como widget raíz
runApp(const MyApp());
}
// Widget raíz (componente sin estado)
class MyApp extends StatelessWidget {
const MyApp({super.key});
@override
Widget build(BuildContext context) {
// MaterialApp es el componente raíz de estilo Material Design
return MaterialApp(
// Establecer el título de la aplicación
title: 'Flutter Demo',
// Establecer el color del tema
theme: ThemeData(
colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
// Usar Material 3
useMaterial3: true,
),
// Página principal de la aplicación
home: const MyHomePage(title: 'Página de inicio de Flutter'),
);
}
}
// Componente con estado (puede tener estado interno)
class MyHomePage extends StatefulWidget {
const MyHomePage({super.key, required this.title});
// Título de la página (inmutable)
final String title;
@override
State<MyHomePage> createState() => _MyHomePageState();
}
class _MyHomePageState extends State<MyHomePage> {
// Estado del contador
int _counter = 0;
// Método para incrementar el contador
void _incrementCounter() {
// setState notifica a Flutter que el estado ha cambiado y necesita reconstruir la UI
setState(() {
_counter++;
});
}
@override
Widget build(BuildContext context) {
// Scaffold es el andamiaje de página de Material Design
return Scaffold(
// AppBar es la barra de aplicación superior
appBar: AppBar(
backgroundColor: Theme.of(context).colorScheme.inversePrimary,
// Mostrar el título de la página
title: Text(widget.title),
),
// Contenido principal de la página
body: Center(
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
children: [
const Text('Veces que has hecho clic en el botón:'),
// Mostrar el valor del contador
Text(
'$_counter',
style: Theme.of(context).textTheme.headlineMedium,
),
],
),
),
// Botón flotante
floatingActionButton: FloatingActionButton(
onPressed: _incrementCounter,
tooltip: 'Incrementar',
child: const Icon(Icons.add),
),
);
}
}
Explicación de la estructura del código
| Parte | Descripción |
|---|---|
| Sentencia import | Importa los paquetes necesarios; aquí se importa la biblioteca de componentes Material Design |
| Función main | Punto de entrada del programa Dart, llama a runApp para iniciar la aplicación |
| Función runApp | Función de inicio de Flutter, recibe el Widget raíz como parámetro |
| StatelessWidget | Componente sin estado, la UI no cambia con el tiempo |
| StatefulWidget | Componente con estado, la UI puede responder a cambios de datos |
| Método build | Método que todo Widget debe implementar para construir la UI |