Skip to main content

Requisitos Generales

Paso 1: Código Base​

Se le proporciona un proyecto base de Gradle con las dependencias necesarias para resolver las tareas.

Comience por examinar el código base para comprender la estructura del proyecto y las dependencias agregadas. Esto le ayudará a resolver las tareas de manera más eficiente.

Código Limpio​

Asegúrese de que su código siga las normas de código limpio y sea mantenible, así como las reglas de documentación. Puede utilizar la guía de estilo de ejemplo proporcionada en el material.

Características del Lenguaje​

Puede utilizar cualquier característica del lenguaje Kotlin, incluidas:

  • Funciones de extensión
  • Funciones de orden superior
  • Lambdas
  • Clases selladas
  • Objetos
  • Interfaces
  • Propiedades delegadas
  • Reflexión

o cualquier otra característica que considere necesaria, a menos que se especifique lo contrario en la pregunta.

Análisis Estático​

Asegúrese de que su código no tenga errores de análisis estático. Para verificarlo, ejecute el siguiente comando:

./gradlew check

Si el comando se ejecuta sin errores, no se mostrará ninguna salida. Si hay errores, estos se mostrarán en la consola.

Configuración del Proyecto​

Reemplace assignments.group = com.github.your-name en el archivo gradle.properties con su nombre de usuario de GitHub o algún otro identificador único.

Organización del Código​

Organice su proyecto en subproyectos de Gradle para separar las diferentes partes de cada tarea. Cada tarea debe tener su propio subproyecto con su código y pruebas asociadas. Asegúrese de que cada subproyecto tenga su propio build.gradle.kts.

La estructura de directorios de su proyecto debería verse así:

tareas
├── event-manager
│   ├── src
│   │   ├── main
│   │   │   └── kotlin
│   │   └── test
│   │       └── kotlin
│   └── build.gradle.kts
├── calculator
│   ├── src
│   │   ├── main
│   │   │   └── kotlin
│   │   └── test
│   │       └── kotlin
│   └── build.gradle.kts
...
├── gradle.properties
├── settings.gradle.kts
└── build.gradle.kts

Documentación​

Asegúrese de que su código esté bien documentado. Cada clase, función y propiedad debe tener una descripción que explique su propósito y cómo se utiliza. Utilice comentarios de estilo KDoc para documentar su código.

Publicación de la Tarea​

Su tarea debe publicarse en un repositorio de GitHub Classroom. El repositorio debe incluir:

  • Su código fuente.
  • Un release con su(s) librería(s) compiladas.
  • La documentación generada.

Recuerde actualizar la versión de su librería en el archivo libs.versions.toml antes de publicarla.

Opcionalmente, puede publicar su librería en GitHub Packages para optar por una bonificación de 0.3 puntos.