Skip to content

About

Android (Java) contacts agenda with CRUD on SQLite using a single Activity and Fragments.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Actividad 3 — Aplicación CRUD con SQLite y Fragments

Aplicación Android que administra una agenda de contactos (tema: Información Personal) sobre la base de datos interna del dispositivo, usando SQLiteOpenHelper y una arquitectura de una Activity + Fragments.


1. Base de datos

Elemento Valor
Archivo contactos_umb.db
Tabla CONTACTOS
Versión 1
Columna Tipo Obligatorio
_id INTEGER PRIMARY KEY AUTOINCREMENT sí
nombre TEXT sí
documento TEXT no (no se puede repetir)
telefono TEXT sí
email TEXT no
direccion TEXT no
ciudad TEXT no
notas TEXT no

La creación y actualización de la tabla las administra DatabaseHelper (onCreate / onUpgrade).

2. Estructura del código

com.umb.sqlite02
├── MainActivity.java                  Activity anfitriona (Toolbar + fragments)
├── db
│   ├── DatabaseHelper.java            SQLiteOpenHelper: crea y actualiza la BD
│   └── DBManager.java                 CRUD: insertar, listar, buscar, actualizar, eliminar
├── model
│   └── Contacto.java                  Modelo de un registro de la tabla
└── ui
    ├── ContactoListaFragment.java     Consulta (lista + búsqueda + ordenamiento)
    ├── ContactoFormularioFragment.java Insertar / Modificar con validaciones
    ├── ContactoDetalleFragment.java   Ficha del contacto y eliminación
    ├── ContactoAdapter.java           Adaptador del RecyclerView
    └── UiUtils.java                   Utilidades de interfaz (teclado, llamar, correo)

3. Operaciones del CRUD y dónde se acceden

Operación Método de DBManager Cómo se llega desde la app
Insertar insertar(Contacto) Botón flotante Nuevo contacto, menú de opciones → Nuevo contacto, o el botón del estado vacío
Consultar listar(filtro, orden) Pantalla principal; menú de opciones → Buscar y Ordenar por
Consultar uno buscarPorId(id) Al tocar un registro se abre su ficha
Modificar actualizar(Contacto) Ficha → Editar, menú de la ficha, o menú del registro en la lista
Eliminar eliminar(id) Menú del registro en la lista, o menú de la ficha
Eliminar todo eliminarTodos() Menú de opciones → Eliminar todo

4. Decisiones de usabilidad

  1. Botón de volver siempre disponible. La flecha de la barra superior aparece automáticamente en cualquier pantalla distinta de la lista y usa el mismo comportamiento que el gesto/botón atrás del sistema.
  2. Confirmación antes de borrar y opción de Deshacer durante unos segundos, para que un toque accidental no destruya un registro.
  3. Validación en el formulario (nombre, teléfono, formato de correo y documento no repetido) con el mensaje sobre el campo y el foco puesto en el primer error.
  4. Aviso de cambios sin guardar al salir del formulario.
  5. Estados vacíos con acción: la lista vacía y la búsqueda sin resultados explican qué pasó y ofrecen el siguiente paso.
  6. Búsqueda en vivo por nombre, teléfono, documento o ciudad.
  7. Confirmaciones visibles (Snackbar) después de guardar, actualizar o eliminar.
  8. Teclado adecuado a cada campo (teléfono, correo, numérico) y avance con la tecla siguiente.
  9. Acciones útiles desde la ficha: llamar, enviar mensaje o escribir correo con los datos guardados.
  10. Accesibilidad: descripciones de contenido, áreas táctiles de 44 dp o más y contraste suficiente en modo claro y oscuro.

5. Compilar y generar el APK

Desde Android Studio: Build → Build Bundle(s) / APK(s) → Build APK(s).

Desde la línea de comandos:

./gradlew assembleDebug
# el APK queda en app/build/outputs/apk/debug/app-debug.apk

Requisitos: JDK 17, Android SDK 34, Gradle 8.7 (incluido en el wrapper).

About

Android (Java) contacts agenda with CRUD on SQLite using a single Activity and Fragments.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages