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ámetroDescripciónEjemplo
--orgEspecificar el identificador de organización (formato de dominio inverso)--org com.example
--platformsEspecificar las plataformas compatibles--platforms ios,android
--emptyCrear 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:

DispositivoComando
Emulador de Androidflutter run -d android
Simulador de iOSflutter run -d iphone
Navegador Chromeflutter run -d chrome
Escritorio de Windowsflutter 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:

  1. Modifica el código y guarda
  2. En la terminal, pulsarTecla
  3. 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

// lib/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

ParteDescripción
Sentencia importImporta los paquetes necesarios; aquí se importa la biblioteca de componentes Material Design
Función mainPunto de entrada del programa Dart, llama a runApp para iniciar la aplicación
Función runAppFunción de inicio de Flutter, recibe el Widget raíz como parámetro
StatelessWidgetComponente sin estado, la UI no cambia con el tiempo
StatefulWidgetComponente con estado, la UI puede responder a cambios de datos
Método buildMétodo que todo Widget debe implementar para construir la UI
Otras extensiones