Error Gradle en Android: No signature of method: build_*.android() — ¿cómo solucionarlo?

¿Te has encontrado con «No signature of method: build_*.android()»? No estás solo

Si alguna vez abriste Android Studio, hiciste cambios en el archivo build.gradle.kts y recibiste un misterioso error rojo ERROR: No signature of method: build_ap86oam3dut3pxce3x49rdtma.android() — bienvenido al club. Este problema con Gradle es uno de los más populares en Stack Overflow (¡miles de visitas!), y puede desconcertar incluso a un desarrollador experimentado.

La buena noticia: el error casi siempre tiene la misma causa y se soluciona en un par de minutos. En este artículo lo analizaremos usando Kotlin DSL (es decir, build.gradle.kts), mostraremos por qué ocurre y daremos un plan de solución paso a paso. ¡Allá vamos!

¿Qué significa realmente este error?

Gradle es un sistema de compilación que lee scripts build.gradle (Groovy) o build.gradle.kts (Kotlin). Cuando ves No signature of method: build_*.android(), significa que Gradle no puede encontrar la función android { ... } en el contexto del proyecto raíz.

En términos simples: estás intentando configurar parámetros específicos de Android (compileSdk, buildTypes, defaultConfig) en un script que no es un módulo de aplicación o biblioteca. Esto suele ocurrir en el archivo raíz build.gradle.kts, donde solo deberían estar las configuraciones para todos los proyectos (plugins, repositorios), no la configuración de Android.

Situación típica (ejemplo en Kotlin DSL)

Imagina que abres el archivo raíz build.gradle.kts y escribes algo como:

// ❌ Código incorrecto en el build.gradle.kts raíz\nandroid {\n    compileSdk = 34\n    defaultConfig {\n        minSdk = 24\n    }\n}\n

Después de sincronizar Gradle, aparece ese error. ¿Por qué? Porque el script raíz no sabe nada sobre Android — se encarga de la configuración general, no de un módulo específico.

Solución paso a paso del error

Veamos cómo estructurar correctamente los archivos de compilación en un proyecto con Kotlin. Solo dos pasos.

Paso 1: Verifica qué archivo estás editando

Abre el panel Project en Android Studio (generalmente a la izquierda). Encuentra los dos archivos:

\n
• build.gradle.kts (raíz, está en la raíz del proyecto)
\n
• app/build.gradle.kts (archivo del módulo app)
\n

El error ocurre si accidentalmente colocaste el bloque android { ... } en el archivo raíz. Asegúrate de estar trabajando con app/build.gradle.kts.

Paso 2: Traslada el código al archivo correcto (si es necesario)

Si encuentras el bloque android en el build.gradle.kts raíz — córtalo y pégalo en app/build.gradle.kts. Así es como debería verse la versión correcta para el módulo app:

// ✅ app/build.gradle.kts correcto\nplugins {\n    id("com.android.application")\n    id("org.jetbrains.kotlin.android")\n}\n\nandroid {\n    namespace = "com.example.myapp"\n    compileSdk = 34\n\n    defaultConfig {\n        applicationId = "com.example.myapp"\n        minSdk = 24\n        targetSdk = 34\n        versionCode = 1\n        versionName = "1.0"\n    }\n\n    buildTypes {\n        release {\n            isMinifyEnabled = false\n            proguardFiles(\n                getDefaultProguardFile("proguard-android-optimize.txt"),\n                "proguard-rules.pro"\n            )\n        }\n    }\n\n    compileOptions {\n        sourceCompatibility = JavaVersion.VERSION_1_8\n        targetCompatibility = JavaVersion.VERSION_1_8\n    }\n\n    kotlinOptions {\n        jvmTarget = "1.8"\n    }\n}\n\ndependencies {\n    implementation("androidx.core:core-ktx:1.12.0")\n    implementation("androidx.appcompat:appcompat:1.6.1")\n    // ... resto de dependencias\n}\n

Y el build.gra