Si te ha ocurrido que descargas un proyecto Flutter desde GitHub y al ejecutarlo no funciona, no estás solo. Esto suele pasar muy seguido, especialmente cuando sigues cursos como “Flutter – Móvil de cero a experto” de Udemy, donde muchos estudiantes se encuentran con errores al intentar correr los ejercicios.
En esta guía te explico cómo hacer funcionar un proyecto Flutter descargado de GitHub, incluso cuando te aparecen errores de dependencias, imports obsoletos o archivos faltantes.
🧱 1. Crea un proyecto Flutter nuevo (base limpia)
En lugar de ejecutar directamente el proyecto descargado, lo ideal es:
- Abre Visual Studio Code
- Crea un nuevo proyecto con el mismo nombre que aparece en el archivo
pubspec.yamloriginal:
name: nombreproyecto- Ejecuta ese proyecto en un dispositivo físico o virtual para confirmar que funciona correctamente.
Esto te asegura que la estructura base esté actualizada a la versión actual de Flutter.
📦 2. Instala las dependencias desde cero (una por una)
Nunca copies y pegues todo el pubspec.yaml sin verificar.
En VS Code utiliza Pubspec Assist para instalar cada dependencia:
Ejemplos comunes:
animate_docard_swiperflutter_riverpodflutter_riverpod/legacy
Esto fuerza a que las dependencias se instalen en versiones compatibles con tu versión de Flutter actual.
🗂️ 3. Activa los assets en pubspec.yaml
Si el proyecto usa archivos como .env o imágenes, debes habilitarlos manualmente. Por ejemplo:
assets: - .env⚠️ Si no activas los assets, la app no leerá imágenes, configuraciones ni archivos externos.
🔐 4. Copia los archivos .env del proyecto original
Muchos proyectos no funcionan porque falta el archivo .env, donde se guardan:
- API Keys
- URLs de backend
- Variables de entorno
Cópialo tal cual del proyecto original al nuevo.
📁 5. Copia los assets y el directorio lib
Ahora sí, reemplaza:
- Carpeta
/lib - Carpeta
/assets - Archivos
.env
Esto te permite mantener una base limpia y actual, pero con el código del proyecto descargado.
🔧 6. Corrige dependencias o imports desactualizados
Muchos proyectos antiguos usan imports como:
import 'package:flutter_riverpod/flutter_riverpod.dart'; import 'package:flutter_riverpod/legacy.dart';Si una dependencia cambió de versión, es normal que dé errores.
Solución:
- Usa los imports correctos según la versión instalada.
- Ajusta el código a las nuevas APIs si es necesario.
✔️ Conclusión
Descargar un proyecto Flutter desde GitHub y hacerlo funcionar no siempre es sencillo, especialmente si el código está desactualizado. Sin embargo, con esta metodología:
- Proyecto limpio
- Dependencias instaladas correctamente
- Assets activados
- Archivos .env copiados
- Imports corregidos
…cualquier ejercicio, demo o aplicación que descargues funcionará sin problemas.
Si quieres, puedo ayudarte a revisar tu proyecto, corregir errores específicos o adaptar el código a la versión actual de Flutter. ¿Deseas que revisemos tu proyecto?
