Gradle no Android explicado: build.gradle para iniciantes

05/03/2026 Alexandre

O que é Gradle no Android

O Gradle é o sistema de build usado pelo Android Studio para compilar aplicativos Android.

Ele é responsável por:

Compilar o código Java/Kotlin
Gerenciar dependências
Gerar APK ou AAB
Controlar versões do app

Basicamente, o Gradle automatiza todo o processo de construção do aplicativo.

Estrutura do Gradle no Android

Normalmente um projeto Android possui dois arquivos principais:

build.gradle (Project)
build.gradle (Module: app)

Cada um tem uma função diferente.

build.gradle do projeto

Esse arquivo define configurações globais do projeto. Exemplo:


buildscript {

repositories {
google()
mavenCentral()
}

dependencies {
classpath "com.android.tools.build:gradle:8.2.0"
}

}

Ele define:

versão do Gradle
repositórios
plugins do projeto

build.gradle do módulo (app)

Esse é o arquivo mais importante. Exemplo:


plugins {
id 'com.android.application'
}

android {

compileSdk 34

defaultConfig {

applicationId "com.meuapp.exemplo"
minSdk 21
targetSdk 34
versionCode 1
versionName "1.0"

}

}

Aqui ficam as configurações do aplicativo.

Versionamento do aplicativo

No Gradle controlamos versões usando:


versionCode 1
versionName "1.0"

Explicação:

versionCode → número interno usado pelo Android
versionName → versão exibida ao usuário

Ao publicar atualizações, aumente sempre o versionCode.

Adicionar dependências

Bibliotecas são adicionadas na seção dependencies. Exemplo:


dependencies {

implementation 'androidx.appcompat:appcompat:1.6.1'
implementation 'com.google.android.material:material:1.11.0'

}

Essas dependências são baixadas automaticamente pelo Gradle.

Sincronizar o Gradle

Após editar o build.gradle é necessário sincronizar o projeto. No Android Studio:


File
→ Sync Project with Gradle Files

Ou clique no botão **Sync Now**.

Erros comuns no Gradle

Alguns erros frequentes:

dependência incompatível
versão do Gradle desatualizada
erro de internet ao baixar bibliotecas
conflito entre dependências

Nesses casos tente:

Sync Project
Invalidate Cache
Clean Project

Comandos importantes

Alguns comandos Gradle usados no desenvolvimento:


./gradlew build
./gradlew clean
./gradlew assembleDebug

Makrosites