Tutorial Para Desarrollar Una App Android Para Productos, Clientes Y Pedidos (Nivel #1) El título es claro. En esta serie de tutoriales te mostraré como crear una aplicación que administre productos, clientes y pedidos basados en una base de datos en un servidor. ¿Qué significa Nivel #1?
Qué el actual tutorial que estás leyendo tiene el siguiente alcance: Vamos a ver crear una REST API para leer los productos que tienes en tu servidor y ponerlos en una lista (RecyclerView). Te mostraré los pasos, herramientas, y conceptos para desarrollar esta característica de una forma sencilla, limpia, mantenible y sobre todo entendible. El código completo de la app y el servicio REST puedes encontrarlo en la misma carpeta de este tutorial.
App Productos Al igual que en todos los tutoriales que he creado sobre Desarrollo Android, este también trae una app de ejemplo llamada “App Productos”. App Products es una aplicación administrativa para una farmacia de gran tamaño, cuyo fin es “movilizar” su proceso de toma de pedidos y consulta de productos por
parte de los vendedores. Nuestro objetivo es repasar su reconstrucción con todo nivel de detalle. ¿Qué te parece? Puede que su contenido o contexto pueda diferir un poco a tus necesidades, ya que no todos los problemas son iguales.
Pero he aquí la parte buena:
Te he creado una plantilla con la ruta óptima para que superes las adversidades particulares de tu proyecto. ¿Quieres verla? ¡Bien!
Checklist Para Desarrollar Tu App De Productos Lo primero que vamos a escudriñar, son los pasos precisos que daremos para ejecutar exitosamente nuestra aplicación. Esto puedo variar de programador a programador (de equipo a equipo, si es tu caso). A mí en particular me gusta seguir un orden predefinido de lo que voy a realizar. Definiendo el orden, las condiciones de uso, las herramientas y las prácticas que usaré. A la suma de estos factores se le llama Metodología. Independientemente de que profesión tengas o que proyecto vayas a realizar, siempre tendrás una metodología. Ya sea una copiada, improvisada, propia, o hibrida. ¿Qué tal te va con la tuya?
Si no tienes. Te recomiendo que comiences con esta: 1. Definir el propósito general de la app 2. Recolectar requerimientos 3. Determinar quién usará la app 4. Crear wireframe de pantallas 5. Determinar fuentes de datos y sincronización 6. Seleccionar recursos y herramientas
7. Desarrollar versión “cascaron” de la app 8. Crear servicio REST 9. Implementar cliente HTTP con Retrofit Quedas en libertad de mover, eliminar y agregar pasos que se ajusten a tu carácter y conocimientos. Eres tú quien eliges tu ruta. Yo solo te mostraré cómo ponerla en marcha en este instante…
Paso #1. Definir El propósito De La App El propósito es el objetivo general que deseas alcanzar con tu app. Una simple frase de no más de 3 renglones que resuma tu futuro perfecto. Por ejemplo: “La App reducirá los tiempos del análisis de mitigación de 4 horas a 1 hora” “La App incrementará los tiempos de toma de pedidos de nuestros meseros en un 30%”
¿Ves el formato? Usamos una métrica que evidencie la mejora de una situación. Simple. En el caso de “App Productos” tenemos: “Encontrar productos solicitados por un cliente en menos de 2 segundos y tomar pedidos digitalmente”
El Contexto de App Products Esta aplicación es solo una de las características que tendría una app que tome las órdenes de un negocio. La proyección futura es que sincronice los pedidos con un servidor remoto. Sin embargo, por el momento, llamaremos a este tutorial como el “Nivel 1”.
Paso #2. Recolectar Necesidades Esta etapa es muy conocida por la mayoría de ingenieros de sistemas asociados al análisis de software. Básicamente aquí debes crear una lista con las funcionalidades que tendrá el sistema basado en los objetivos del usuario. En las metodologías tradicionales a la necesidad se le califica como “Requerimiento”. En metodologías ágiles se le llama “Historia de usuario”. (No entraré a explicar los alcances de ambos por cuestiones de simplicidad). Ahora, aplicando este paso, supondremos que el usuario (administrador del negocio, supervisor, tú mismo, etc.) necesita:
Una lista de todos los productos del negocio
Un filtro de productos según sus atributos
La búsqueda de productos por nombre
Ver detalle del producto
El login de sus vendedores
Añadir pedido
Modificar pedido
Eliminar pedido
Ver detalle de pedido
Administrar clientes. Detalle, inserción, modificación y eliminación (OPCIONAL)
Imprimir factura de pedido
Sincronizar pedidos locales con el servidor
Necesidades de bases de datos : En este punto también puedes capturar las
entidades, relaciones y atributos que requieren persistencia. Para ello puedes usar varios artefactos. Dos de los más populares son: diagramas entidad-relación y un diccionario de datos . El uso de ambos lo defino muy bien en mi ebook “8 Pasos para diseñar tus bases de datos”. En él verás estrategias para capturar dichas necesidades. Ahora bien: En el estado actual, App Products solo tiene la entidad Producto. ¿Qué propiedades posee?
Código
Nombre
Descripción
Marca
Precio
Unidades en stock
Imagen(es) de producto
Paso #3. Determinar Quién Usará La App Al principio habíamos dicho que la app es para los vendedores que toman los pedidos en la farmacia. Y esta es la clara respuesta: Vendedores de la farmacia. Identifica el o los usuarios para los cuales desees crear la app. Por ejemplo, podría que también debas desarrollar un módulo para los supervisores de los vendedores. Suponiendo que ellos monitorearán la actividad de cada vendedor.
O tal vez un panel de administración que muestre el resumen de las ventas y productividad de los empleados.
Paso #4. Crear Bocetos A continuación vamos a crear mocks de la aplicación según nuestra experiencia con los patrones de diseño en Android. ¿Qué herramientas puedes usar?
Papel + Lapiz + Cámara para capturas
Ninjamock
Pothoshop
Mockplus
balsamiq
Pidoco
Lucidchart
Proto.io
¿Cuál de todas elegir? En mi caso me gusta mucho ninjamock porque es gratuita y muy intuitiva de usar. Además permite una fácil comunicación con clientes que tengan algún conocimiento de desarrollo. Pero si mi cliente no tiene ni idea, entonces uso proto.io para mostrarle interacciones e interfaz de alto nivel. Es solo mi punto de vista. Ya tú irás probando que te va mejor. Retomando…
El estado actual de este tutorial solo tiene una pantalla: la lista de productos .
Y basada en ella, estos son los puntos de interacción del usuario: Tap en botón “búsqueda” > Abre pantalla de búsqueda
Tap en producto > Abre pantalla de detalle
Long tap en producto > Ripple Effect + Aparición de Contextual Action Bar (opcional)
Swipe to refresh > Refrescar
Endless scroll > Se cargan elementos adicionales a la lista
También anotemos los estados adversos:
Estado sin productos > Mensaje de ausencia de productos
Estado de error > Toast con mensajes de error
Paso #5. Determinar Fuentes De Datos Y Estrategias De Sincronización Ojo aquí:
Debes definir muy bien qué pasará con la información de tus usuarios. Unas buenas preguntas que te propongo a responder son: “¿En qué lugares se guardarán datos?” R/ Por el momento (nivel 1), en App Products tendremos una base de datos remota
(servidor) para persistencia. También usaremos la memoria del dispositivo como caché al mostrar elementos. “¿Habrá sincronización de datos?... ¿Si es así, que estrategias usarás?” R/ Sí.
Las entidades se comportarán de esta forma:
Productos: predominan los cambios del servidor, ya que desde el cliente
Android no se modificarán. Además:
El usuario sincronizará manualmente la app con el gesto “Swipe to refresh”
Se enviarán modificaciones inmediatamente la persistencia local cambie (futuro) Se notificarán cambios del servidor con notificaciones push (futuro) Si no hay conexión disponible para sincronizar, se programará una actualización a penas se detecte el restablecimiento de la red (futuro).
¿Qué políticas usarás para tomar datos? R/
Se consultará al servidor remoto por defecto cuando no haya datos en la base de datos local. Luego de obtener datos de la nube, la fuente de datos local se actualiza con dichos datos. Luego se pone en la caché y se muestra en la vista.
Paso #6. Elegir Recursos Y Herramientas ¿Cómo llevas tu diagnostico hasta aquí? Al llegar a este punto, debes tener definido al menos un 70% de lo que hará tu app. Con todo y lo anterior… ¿Qué tal si definimos las herramientas, recursos y tecnologías que necesitamos? Comencemos por el lado del cliente:
Manejo de colecciones y precondiciones > Librería Guava
Carga eficiente y caché en disco de imágenes > Librería Glide
Base de datos local (futuro) > SQLiteOpenHelper + ContentProvider
Ejecutor de peticiones HTTP hacia la API: Retrofit
Ahora, el lado del servidor:
Lenguaje: PHP 5.6
Gestor de bases de datos: MySQL
Proveedor del servicio de hosting: Localhost (nuestro PC local). En el nivel #2 consideraremos usar opciones como: Google Cloud Platform, Amazon web services, Rackspace, DigitalOcean, Microsoft Azure, Heroku, …
Formato de intercambio: JSON
Paso #7. Crear Cascarón ¡Por fin! Nos ha llegado el momento de codificar. En esta etapa crearemos una primera entrega a la que yo llamo el “cascarón”.
¿Por qué este nombre? La razón es sencilla: validar lo más pronto posible tu app. Te olvidarás por un momento de las fuentes de datos y te centrará en crear una app que solo utilice información falsa. Harás que tu usuario pruebe de forma temprana todas las interacciones y flujos, de modo que obtengas el restante de opiniones que solo se dan en la acción real. Esto nos lleva a los siguientes pasos: 1. Definir arquitectura y patrones 2. Determinar tareas de programación ¿Todo claro hasta allí? Si es tu caso, entonces empecemos.
