Skip to content

Monroy2DAM/android-feed-reader

Repository files navigation

Reproductor de listas podcasts remotas

Aplicación Android que lee, muestra y reproduce listas m3u, RSS de blogs y podcasts extraídos de feeds de internet.

Implementa funcionalidades para leer y reproducir los recursos que contienen dichos feeds.


Navegación


:octocat: Repositorio GitHub
📜 Mapa de versiones
⬇️ Releases
📝 Tareas y mejoras propuestas
📘 Guía de Git


¿Cómo colaborar?

Instrucciones

  1. ✌️ Haz un fork del repositorio y posteriormente descárgalo git clone <url>.
  2. 📂 Navega a la carpeta del proyecto cd <carpeta>.
  3. 📝 Crea una nueva rama git checkout -b <nombre-rama> y luego haz tus cambios.
  4. ✨ Añade los cambios git add * y haz el commit: git commit -am "Resumen de cambios".
  5. ⬆️ Sube la nueva rama: git push origin <nombre-rama>.
  6. 📧 Inicia un pull request en el repositorio :D

:octocat: Si deseas aprender Git, visita mi guía sobre Git.


Índice




1. Funcionamiento de la aplicación

  1. La aplicación carga y muestra al usuario un selector de feeds guardados.
  2. Cuando el usuario selecciona un feed, se carga una lista mostrando la información básica de cada entrada.
  3. Cuando el usuario selecciona una entrada, se muestra la información detallada de esa entrada en una nueva pantalla.
  4. También mostrará las imágenes que contenga y botones para reproducir su stream y navegar a la fuente.

2. Documentación

El proyecto se estructura en varios paquetes:

📂 feedreader/

Paquete con las activities e hilos.

📂 feedreader/adaptadores/

Paquete con parseadores y adaptadores de pantalla y datos.

📂 feedreader/modelo/

Paquete con las clases modelo de los objetos empleados.

  • Se ha empleado un buen estilo de programación para que el código sea legible y escalable:
    • Uso de comentarios explicativos y todo/fixme.
    • Uso de expresiones Lambda.
    • Modularización: métodos y clases simples.
  • Se ha pensado en el usuario:
    • Capturación de errores.
    • Se ha pensado en posibles errores de otros feeds para que la app no se cierre.
    • Se ha intentado capturar toda la casuística de posibles formato de XML y M3U.

3. Fallos conocidos

Errores conocidos y sus causas o soluciones

Cannot resolve AppCompActivity

Las siguientes opciones pueden solucionarlo:

  • Clean/Build/Rebuild project.
  • File -> Invalidate Caches / Restart
  • En gradle, cambiar el compile de AppCompActivity a otro, sincronizar y volver a ponerlo como originalmente estaba

"Please select SDK"

Posible solución:

File -> Project structure... -> Project -> Cambia JDK location al directorio de instalación de Java JDK

4. Colaboradores

Colaborador Aporte
Ismael Núñez Mayoría de la app
Francisco Rodríguez SaxParser