Trabajo práctico integrador - Laboratorio 1

Fecha de entrega para el laboratoratorio 1: 11 de Septiembre 2020

Objetivos

Tareas a desarrollar

1. Crear el proyecto

  1. Abrir android studio y seleccionar la opcion para comenzar un nuevo proyecto.
  2. Seleccionar Empty Activity como template

  3. En la sección de configuración de proyecto seleccione.

    • Seleccione JAVA como lenguaje
    • Nombre de la aplicacion Send Meal
    • Nombre del paquete (Puede utilizar un nombre que identifique a su grupo)
    • Seleccionar el Minimun SDK (Se recomienda API 23, como mínimo elija el API correspondiente a su dispositivo para poder ejecutar la aplicación)

    Asegúrese de haber seleccionado Java como lenguaje ya que Android Studio en sus versiones más recientes pre-selecciona Kotlin.

2. Configurar GIT

  1. Es necesario tener una cuenta de Github, en caso de no tenerla puede registra una en https://github.com
  2. Desde Android Studio, en la barra superior de tareas seleccione la opcion VCS → Import into Version Control → Share Project on Github

  3. Asignamos el nombre de nuestro repositorio en Github bajo Repository Name asegurandonos que la opcion Private se encuentre des-marcada y presionamos Share.

    Es necesario que el repositorio sea publico para poder realizar la correción de los trabajos prácticos. Para usos personales puede utilizar repositorios privados, los cuales solo pueden ser visualizados con la autorización del creador.

    El campo Remote es el nombre con el cual git identificará localmente a este nuevo repositorio remoto en Github, es recomendado dejar el nombre origin ya que es la convención para los casos con un único repositorio remoto como el nuestro.

  4. Para finalizar con la creación de nuestro repositorio debemos inicializarlo con un primer commit, la siguiente ventana de Android Studio nos presenta la opcion de agregar todos los archivos al seguimiento de GIT. Colocamos como mensaje para nuestro primer commit

    Iniciación del laboratorio 1

    Y luego presionamos Add

    Recordemos que git solo realiza seguimiento de los archivos que le nosotros le indicamos o tracked, los que no, apareceran como untracked.

    Apretar el boton Add en Android Studio para inicializar el repositorio realizo 2 acciones, primero realizo un commit a nuestro repositorio local y luego realizo un push al repositorio remoto en Github.

  5. Verificar información en Github. La url del repositorio suele seguir la forma 
    https://github.com/{USUARIO}/{NOMBRE_REPOSITORIO}

  6. Crear la rama/branch develop, haciendo click con el IDE (Android Studio) en la barra inferior del margen derecho.

  7. Crear una nueva rama con el nombre lab01.

    Asegurarse de que se encuentre trabajando en la rama lab01 para la realizacion del laboratorio 1.

3. Configurar UI - (LinearLayout)

  1. Para asegurarse que todo se encuentre funcionando correctamente probemos correr la aplicación generada presionando el boton verde con una flecha. Una vez que cargue deberíamos ver el mensaje ‘Hello World’ en pantalla
  2. El mensaje ‘Hello World!’ que podemos observar se encuentra en la carpeta ‘res’ → ‘layout’ → ‘activity_main.xml’. Para la realizacion del laboratorio utilizaremos un LinearLayout de orientación vertical pero el archivo ‘activity_main.xml’ fue autogenerado utilizando un ConstrainLayout por lo que tendremos que cambiarlo
    1. Abra ‘activity_main.xml’ y asegurese de tener seleccionada la opción design.
    2. Seleccione la ContraintLayout en el arbol de componentes y presione ‘Convert view…’ y seleccione LinearLayout
    3. Por default el LinearLayout coloca los elementos de forma horizontal. Para cambiar este comportamiento realizamos click → LinearLayout → Convert orientation to vertical

4. UI Propuesta

Se plantea realizar la pantalla de registro de usuarios la app, esta pantalla cuenta con gran cantidad de inputs y deberá reaccionar al estado de los inputs (ej: no dejar registrar al usuario si faltan campos por completar)

Consideraciones

Elementos

Validaciones

  1. Los siguientes datos son obligatorios:
    • Correo electrónico
    • Clave
    • Tarjeta
    • Tipo de tarjeta
    • CCV
    • Fecha de vencimiento de tarjeta
  2. Si se activo ‘Realizar una carga inicial’ el monto del slider debe ser mayor a 0 pesos
  3. Verificar si coinciden las claves
  4. Verificar que el correo electrónico tenga al menos una @ y 3 letras luego de la arroba
  5. Verificar que si ingresó una tarjeta de crédito la fecha de vencimiento por lo menos sea superior a los próximos 3 meses
  6. Cualquier condición de las anteriores que no se cumpla deberá mostrar un mensaje con el toast notificando al usuario. Si todas las validaciones son cumplidas notificar al usuario utilizando un toast con un mensaje de exito.

5. Modelo de datos de usuario

El objetivo de esta etapa es poder capturar los datos que ingreso el usuario en la interfaz grafica y setearlos, ya cumpliendo las reglas de negocio, en nuestro modelo del dominio.

  1. Dentro de nuestr aplicación crear un nuevo paquete model

  2. Dentro de nuestro model crear las clases Usuario, Tarjeta y CuentaBancaria

    Los constructores y getters de las clases que se pueden ver en el siguiente punto fueron generados automaticamente con herramientas del IDE. Estas herramientas se pueden acceder haciendo click derecho y presionando Generate... o ALT + N (Win y Linux) o CMD + N (Mac)

    • Estructura Tarjeta: 
        import java.util.Date;

  public class Tarjeta {
      private String numero;
      private String ccv;
      private Date vencimiento;
      private boolean esCredito;

      public Tarjeta(String numero, String ccv, Date vencimiento, boolean esCredito) {
          this.numero = numero;
          this.ccv = ccv;
          this.vencimiento = vencimiento;
          this.esCredito = esCredito;
      }

      public String getNumero() {
          return numero;
      }

      public String getCcv() {
          return ccv;
      }

      public Date getVencimiento() {
          return vencimiento;
      }

      public boolean isEsCredito() {
          return esCredito;
      }
  }
    • Estructura CuentaBancaria: 
        public class CuentaBancaria {
      private String cbu;
      private String alias;

      public CuentaBancaria(String cbu, String alias) {
          this.cbu = cbu;
          this.alias = alias;
      }

      public String getCbu() {
          return cbu;
      }

      public String getAlias() {
          return alias;
      }
  }
    • Estructura Usuario: 
        public class Usuario {
      private int id;
      private String nombre;
      private String clave;
      private String email;
      private Double credito;
      private Tarjeta tarjeta;
      private CuentaBancaria cuentaBancaria;

      public Usuario(int id, String nombre, String clave, String email, Double credito, Tarjeta tarjeta, CuentaBancaria cuentaBancaria) {
          this.id = id;
          this.nombre = nombre;
          this.clave = clave;
          this.email = email;
          this.credito = credito;
          this.tarjeta = tarjeta;
          this.cuentaBancaria = cuentaBancaria;
      }

      public int getId() {
          return id;
      }

      public String getNombre() {
          return nombre;
      }

      public String getClave() {
          return clave;
      }

      public String getEmail() {
          return email;
      }

      public Double getCredito() {
          return credito;
      }

      public Tarjeta getTarjeta() {
          return tarjeta;
      }

      public CuentaBancaria getCuentaBancaria() {
          return cuentaBancaria;
      }
  }

6. Persistir en git y compartir en github

  1. Verificar que la app se encuentre funcionando al presionar el botton Play
  2. Desde android studio presionar VCS → Commit o el atajo de teclado CTRL + K (Win y Linux) o CMD + K (Mac)
  3. En la ventana seleccione todos los archivos que desea persistir en el commit y asegurarse de:
    • Escribir un mensaje de commit significativo de los cambios que realizo
    • Completar el nombre del autor en formato userDeGit <correo@electronico.com>
    • Destildar Perform code analysis y Check TODO (No es estrictamente necesario, si no los destildamos nos mostrara un warning con cosas que el ide considera que podrian mejorarse o mensajes marcados como “TO-DO”)

    EJEMPLO:

    Notese que en este ejemplo solo se estan subiendo las clases del model, esto es porque en este caso ya se habian realizado commits previos con otras partes del lab. Ademas, no se esta subiendo el contenido de la carpeta .idea ya que son archivos de configuración del IDE y no es necesario.

  4. Una vez completados los datos del commit presionar el botón Commit para efectuar la acción

  5. Con nuestros cambios commiteados en nuestro repositorio local es momento de persistirlos en github, para esto necesitamos realizar un PUSH a nuestro repositorio remoto (en github), desde el IDE podemos encontrarla presinando VCS → Git → Push o el atajo de teclado CTRL + SHIFT + K (Win y Linux) o CMD + SHIFT + K (Mac)

  6. Luego nos aparecera una ventana de confirmacion con los commits que esten en nuestro repositorio local y no en el remoto, estos son los commits que seran pusheados.

    En la imagen se puede ver que nos indica que la rama lab-01 (local) sera pusheado ( → ) a la rama lab-01 en github (origin, o el nombre que le hayamos asignado al Remote en el paso 3 del item 2 - Configurar GIT)

  7. Si todo esta ok presionamos Push y comenzará a realizar el proceso para pushear nuestros cambios a github (Es posible que nos pida nuestras credenciales de acceso a github si no las habiamos puesto antes).
  8. Comprobar en el sitio
    • Navegar a https://github.com/{usuario}/{nombre-de-repo}/
    • Seleccionar la rama lab-1
    • Comprobar que se vea reflejado el commit que hemos realizado