Preparación para el desafío

Completado

Use Visual Studio Code para desarrollar la actualización de la aplicación de consola de C# de adopción de Contoso Pets. La aplicación ya crea datos de ejemplo sobre las mascotas disponibles para su adopción y puede mostrar la información de descripción de la mascota. La aplicación proporciona una búsqueda con un único término dentro de los datos de descripción de cada perro. La adición principal de características es la búsqueda con varios términos. La mejora secundaria es para la animación de "estado de búsqueda" e incluye agregar una cuenta atrás de búsqueda en la animación.

Introducción a la especificación del proyecto

Actualice la aplicación de inicio Contoso Pets existente para incluir varias características de animación de búsqueda de términos y "estado de búsqueda" mejorada:

Recopilación de la entrada del usuario para la característica de mascota de búsqueda de varios términos

  • Los usuarios deben proporcionar términos de búsqueda separados por comas
  • Almacenar los términos de búsqueda en una matriz y ordenar los términos alfabéticamente

Dentro del bucle de matriz de animales que identifica "perros":

  • Recorrer en iteración los términos de búsqueda para buscar la descripción de cada perro
  • Buscar la descripción combinada de una coincidencia de términos
  • Salida de la descripción de cada perro donde hay uno o varios términos coincidentes

Después de salir del bucle de matriz "buscar animales" que identifica perros:

  • Si ningún perro era una coincidencia para ninguno de los usuarios proporcionaba términos de búsqueda, genera un mensaje sin perros coincidentes .

Adición de mejoras de "estado de búsqueda"

Actualización de la animación

  • Ajuste la searchingIcons matriz para que se parezca a una marcación giratoria
  • Ajuste el bucle de animación para que la animación muestre una cuenta atrás numérica de dos a cero (2.., 1.., 0..)

Código de inicio

El proyecto de código de inicio para este módulo de proyecto de desafío incluye un archivo Program.cs que proporciona las siguientes características de código:

  • El código declara variables usadas para recopilar y procesar datos de mascotas y selecciones de elementos de menú.

  • El código declara la matriz ourAnimals.

  • El código usa un bucle for alrededor de una construcción if-elseif-else para rellenar la matriz ourAnimals con un conjunto de datos de ejemplo.

  • El código muestra las siguientes opciones de menú principal para la selección del usuario:

    1. List all of our current pet information
    2. Display all dogs with a specified characteristic
    
    Enter menu item selection or type "Exit" to exit the program
    
  • El código de menú de la aplicación lee la selección del elemento de menú del usuario y muestra un mensaje que devuelve su selección.

  • Caso 1: "Enumerar toda nuestra información actual de mascotas" muestra los datos de muestra para todos los animales (dos perros y dos gatos)

  • Caso 2: "2. Mostrar todos los perros con una característica especificada" es el área primaria donde se agrega código de nueva funcionalidad

    • En el caso 2, el código de inicio identifica perros y busca un único término de entrada de usuario.
    • Antes de buscar cada perro, la consola muestra una "animación" simple que simula un estado para buscar

El objetivo es actualizar el código existente para desarrollar características clave solicitadas por el equipo:

  • Adición de la búsqueda de varios atributos de perro
  • Actualizar animación de búsqueda

Use Visual Studio Code como entorno de desarrollo y pruebe la aplicación en cada fase del proceso de desarrollo.

Configuración

Siga los pasos que se indican a continuación para prepararse para los ejercicios del proyecto guiado.

  1. Descargue un archivo zip que contenga las carpetas de código para el proyecto de desafío.

    • En un explorador, abra el vínculo Lab Files para descargar el archivo ZIP (Challenge-project-work-variable-data-CSharp-main.zip).
  2. Descomprima los archivos descargados localmente (o en el espacio aislado si no usa un entorno de desarrollo local).

    1. En el equipo local, vaya a la carpeta de descargas.
    2. Haga clic con el botón derecho en el archivo Challenge-project-work-variable-data-CSharp-main.zip y seleccione Extraer todo.
    3. Anote la ubicación de los archivos extraídos (la ubicación de la carpeta raíz)
  3. Abra la carpeta Root GuidedProject en Visual Studio Code.

    1. Abra Visual Studio Code localmente (o abra el espacio aislado de MS Learn y abra Visual Studio Code si no usa un entorno de desarrollo local).

    2. En Visual Studio Code, en el menú Archivo, seleccione Abrir carpeta.

    3. Vaya a la carpeta que contiene los archivos extraídos, expanda la estructura de carpetas para buscar la carpeta denominada "Challenge-project-work-variable-data-CSharp-main".

    4. Seleccione Challenge-project-work-variable-data-CSharp-main y luego seleccione Seleccionar carpeta

      • La vista EXPLORADOR de Visual Studio Code debe mostrar dos subcarpetas denominadas Final y Starter.

Revisión de archivos de inicio

  1. En Visual Studio Code, vaya a la carpeta de inicio del proyecto de desafío.

  2. En la barra de menús de Visual Studio Code, seleccione: "Terminal" > "Nuevo terminal"

  3. La ventana de terminal debe estar abierta en la carpeta Starter que contiene el archivo Program.cs. Compile y ejecute el archivo escribiendo dotnet run en la ventana del terminal.

  4. El menú debe mostrarse con dos opciones. Escriba 1 como se muestra en el ejemplo de terminal siguiente:

    Welcome to the Contoso PetFriends app. Your main menu options are:
      1. List all of our current pet information
      2. Display all dogs with a specified characteristic
    
    Enter your selection number (or type Exit to exit the program)
    1
    

    Los datos de ejemplo de las mascotas actuales deben mostrarse seguidos del mensaje Press the Enter key to continue

  5. Después de presionar Entrar, el menú debería mostrarse de nuevo. Elija Opción 2, que se muestra en el ejemplo siguiente:

    Welcome to the Contoso PetFriends app. Your main menu options are:
     1. List all of our current pet information
     2. Display all dogs with a specified characteristic
    
    Enter your selection number (or type Exit to exit the program)
    2
    
    Enter one desired dog characteristic to search for
    
    
  6. Escriba "grande" para el término de búsqueda y presione "Entrar".

  7. Observe el mensaje de "búsqueda" como se muestra:

    searching our dog Nickname: gus for large ...     
    
  8. Observe que el mensaje se ejecuta antes de cada búsqueda de una mascota y los puntos (., .., ...) al final cambian en una animación. Vuelva a ejecutar la búsqueda si la perdió.

  9. Una vez finalizada la búsqueda, presione ENTRAR para volver al menú. A continuación, escriba "exit" y presione "Entrar" para cerrar la aplicación.

  10. Dedique unos minutos a familiarizarse con el código Project.cs iniciado.

    Céntrese en las áreas que requieren actualizaciones, busque y la animación.

    Observe que quedan algunos comentarios en el código que indican dónde colocar una actualización.

Ya está listo para comenzar los ejercicios del proyecto guiado. ¡Buena suerte!