Archivos y Estructura Carpetas Esenciales Proyecto Android

Entender la estructura proyecto Android es fundamental para desarrollo eficiente. Aquí desglose de archivos y directorios críticos en proyecto moderno basado en Gradle.

Configuración Nivel Raíz

  • settings.gradle(.kts): Inclusión proyecto, gestión plugins, definiciones repositorios
  • build.gradle(.kts) [Proyecto]: Dependencias buildscript (AGP, Kotlin), repositorios allprojects
  • gradle.properties: Args JVM, constantes versiones, feature flags
  • gradle/wrapper/gradle-wrapper.properties: Versión Gradle fijada
  • .gitignore: Excluye build/, .gradle/, local.properties, *.iml

Módulo App (Típicamente app/)

Manifest y Core

  • src/main/AndroidManifest.xml: Permisos, componentes, intent-filters, metadata
  • src/main/java/ o kotlin/: Paquetes fuentes (activities, fragments, ViewModels, repositories, etc.)

Recursos (src/main/res/)

  • layout/: Definiciones UI XML (ConstraintLayout, Compose interop)
  • values/: strings.xml, colors.xml, dimens.xml, themes.xml, attrs.xml
  • drawable/: Assets vectoriales (XML), raster (PNG/WebP) en carpetas densidad
  • mipmap/: Iconos launcher (capas adaptive icon)
  • xml/: Pantallas preferencias, reglas backup, config seguridad red
  • raw/: Assets sin compilar (JSON, certificados, media)
  • font/: Fuentes TTF/OTF
  • anim/ & animator/: Animaciones vista/propiedad
  • navigation/: Grafo navegación XML

Configuración Build

  • build.gradle(.kts) [Módulo]: Plugins (com.android.application, kotlin-android), namespace, compileSdk, minSdk, targetSdk, dependencias, buildTypes, productFlavors, composeOptions, packagingOptions
  • proguard-rules.pro: Reglas keep R8/ProGuard para reflexión, JNI, libs terceros

Tipos Módulo Adicionales

  • Módulos feature: Entrega dinámica (bajo demanda, instant)
  • Módulos library: Código compartido (apply plugin: 'com.android.library')
  • Módulos test: Unit (test/), instrumentados (androidTest/)

Generados y Derivados (No Commit)

  • build/: Todas salidas compilador, fuentes generadas, APKs/AABs
  • .gradle/: Caché Gradle
  • local.properties: Ruta SDK (específica máquina)
  • .idea/: Config IDE (commit opcional)

Proyectos modernos usan cada vez más Kotlin DSL (.kts), Jetpack Compose (reduce layout/XML), y catálogos versiones (gradle/libs.versions.toml) para gestión dependencias.