Mejores prácticas de Flutter

Esta sección presentará las mejores prácticas y los estándares de codificación en el desarrollo de Flutter.


Estándares de código

Convenciones de nomenclatura

TipoReglaEjemplo
Nombre de claseUpperCamelCaseMyHomePage
Función/VariablelowerCamelCaseuserName, getData
ConstanteUpperCamelCase + prefijo kkMaxCount
ArchivoMinúsculas + guion bajomy_home_page.dart

Ejemplo: nomenclatura correcta

// Nombre de clase - UpperCamelCase
class UserProfilePage extends StatelessWidget {}

// Función - lowerCamelCase
void fetchUserData() {}

// Variable - lowerCamelCase
String userName = 'Zhang San';

// Constante - prefijo k
const int kMaxRetryCount = 3;
const String kAppName = 'Mi aplicación';

// Enum - UpperCamelCase
enum AppState { loading, success, error }

// Nombre de archivo - minúsculas con guion bajo
// user_profile_page.dart

Optimización del rendimiento

1. Evita rebuilds innecesarios

Ejemplo: uso del constructor const

// Recomendado: usa const para reducir rebuilds
const Text('Hello')              // No se reconstruirá
const SizedBox(width: 10)

// Evitar: cada build crea un nuevo objeto
Text('Hello')                   // Se reconstruirá

// Usa const en una lista
ListView(
  children: const [
    Text('A'),
    Text('B'),
    Text('C'),
  ],
)

2. Usa keys para optimizar el rendimiento de las listas

Ejemplo: uso correcto de keys

// Añade una key única a cada elemento de la lista
ListView.builder(
  itemCount: items.length,
  itemBuilder: (context, index) {
    return ListTile(
      key: ValueKey(items[index].id),  // Usa un identificador único como key
      title: Text(items[index].name),
    );
  },
)

3. Carga diferida de los elementos de la lista

Ejemplo: uso de ListView.builder

// Recomendado: usa builder para carga diferida
ListView.builder(
  itemCount: 1000,  // Debe usarse en listas grandes
  itemBuilder: (context, index) {
    return ListTile(title: Text('Item $index'));
  },
)

// Evitar: usar children para construir listas grandes
ListView(
  children: List.generate(1000, (i) => Text('Item $i')),
)

Estructura del proyecto

Ejemplo: estructura de proyecto recomendada

// lib/
// ├── main.dart # Archivo de entrada
// ├── app.dart # Configuración de la aplicación
// ├── core/ # Funcionalidades principales
// │ ├── constants/ # Constantes
// │ ├── theme/ # Tema
// │ ├── utils/ # Clases de utilidades
// │ └── extensions/ # Extensiones
// ├── data/ # Capa de datos
// │ ├── models/ # Modelos de datos
// │ ├── repositories/ # Repositorios
// │ └── services/ # Servicios de red
// ├── domain/ # Capa de dominio
// │ └── entities/ # Entidades
// ├── presentation/ # Capa de presentación
// │ ├── pages/ # Páginas
// │ ├── widgets/ # Widgets
// │ └── providers/ # Gestión de estado
// └── routes/ # Rutas

Manejo de errores

Ejemplo: manejo global de errores

void main() {
  // Captura global de excepciones
  FlutterError.onError = (details) {
    // Registrar el error
    print('Flutter Error: ${details.exception}');
    // Enviar el error al servidor
    reportError(details.exception);
  };

  // Captura de excepciones con Zone
  runZonedGuarded(() {
    runApp(const MyApp());
  }, (error, stackTrace) {
    print('Zone Error: $error');
    reportError(error);
  });
}

Seguir las mejores prácticas hace que el código sea más fácil de mantener, tenga un mejor rendimiento y reduzca los bugs en el entorno de producción.

Otras extensiones