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
| Tipo | Regla | Ejemplo |
|---|---|---|
| Nombre de clase | UpperCamelCase | MyHomePage |
| Función/Variable | lowerCamelCase | userName, getData |
| Constante | UpperCamelCase + prefijo k | kMaxCount |
| Archivo | Minúsculas + guion bajo | my_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
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'),
],
)
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),
);
},
)
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')),
)
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
// ├── 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);
});
}
// 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);
});
}
Otras extensionesSeguir 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.