Android Gradle Build Failed の原因と解決策

概要

Android StudioでGradleビルドが失敗した場合に発生するエラーです。依存関係の問題、SDK設定、Gradleバージョンの不一致など様々な原因があります。

エラーメッセージ

Build failed with an exception.
Could not resolve all dependencies for configuration ':app:debugCompileClasspath'.
Could not find com.android.support:appcompat-v7:28.0.0.
Execution failed for task ':app:compileDebugKotlin'.
SDK location not found.

原因

依存関係の解決失敗: ライブラリが見つからない
SDKバージョン不一致: compileSdkとライブラリの不整合
Gradleバージョン問題: プラグインとの互換性
キャッシュ破損: Gradleキャッシュが壊れている
JDKバージョン: サポートされていないJavaバージョン
ネットワーク問題: リポジトリへのアクセス失敗

解決策

1. Gradleキャッシュのクリア

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
# Gradleキャッシュをクリア
./gradlew clean

# さらに徹底的にクリア
./gradlew cleanBuildCache

# キャッシュディレクトリを削除
rm -rf ~/.gradle/caches/
rm -rf .gradle/

# Android Studioで
# File > Invalidate Caches / Restart

2. Gradle Wrapperの更新

1
2
# gradle/wrapper/gradle-wrapper.properties
distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-bin.zip

1
2
# または
./gradlew wrapper --gradle-version=8.4

3. build.gradleの依存関係修正

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
// build.gradle (Project)
buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:8.1.0'
        classpath 'org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.0'
    }
}

// build.gradle (Module: app)
plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'
}

android {
    compileSdk 34

    defaultConfig {
        applicationId "com.example.myapp"
        minSdk 24
        targetSdk 34
        versionCode 1
        versionName "1.0"
    }
}

dependencies {
    implementation 'androidx.core:core-ktx:1.12.0'
    implementation 'androidx.appcompat:appcompat:1.6.1'
    implementation 'com.google.android.material:material:1.10.0'
}

4. SDKの設定確認

1
2
# local.properties
sdk.dir=/Users/username/Library/Android/sdk

1
2
3
# 環境変数で設定
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools

5. JDKバージョンの確認

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
// build.gradle
android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_17
        targetCompatibility JavaVersion.VERSION_17
    }
    kotlinOptions {
        jvmTarget = '17'
    }
}

1
2
3
4
5
# JDKバージョン確認
java -version

# JAVA_HOMEの設定
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home

6. リポジトリの設定

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
// settings.gradle
pluginManagement {
    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

7. Support LibraryからAndroidXへ移行

1
2
3
4
5
// 古いSupport Library
implementation 'com.android.support:appcompat-v7:28.0.0'

// 新しいAndroidX
implementation 'androidx.appcompat:appcompat:1.6.1'

1
2
3
# gradle.properties
android.useAndroidX=true
android.enableJetifier=true

8. マルチデックス設定

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
// build.gradle (app)
android {
    defaultConfig {
        multiDexEnabled true
    }
}

dependencies {
    implementation 'androidx.multidex:multidex:2.0.1'
}

9. ProGuard/R8のエラー

1
2
3
4
5
6
7
8
9
// build.gradle
android {
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

# proguard-rules.pro
-keep class com.example.myapp.** { *; }
-dontwarn com.example.**

10. ネットワークプロキシの設定

1
2
3
4
5
# gradle.properties
systemProp.http.proxyHost=proxy.example.com
systemProp.http.proxyPort=8080
systemProp.https.proxyHost=proxy.example.com
systemProp.https.proxyPort=8080

11. メモリ設定

1
2
3
4
5
# gradle.properties
org.gradle.jvmargs=-Xmx4096m -XX:+HeapDumpOnOutOfMemoryError
org.gradle.parallel=true
org.gradle.caching=true
org.gradle.daemon=true

12. デバッグコマンド

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
# 詳細なログを表示
./gradlew build --stacktrace
./gradlew build --info
./gradlew build --debug

# 依存関係ツリーを表示
./gradlew app:dependencies

# タスクを表示
./gradlew tasks

バージョン互換性

AGP Version	Gradle Version	JDK
8.0+	8.0+	17+
7.4	7.5+	11+
7.0	7.0+	11+
4.2	6.7.1+	8+

よくある間違い

Google Play ServicesとFirebaseのバージョン不整合
compileSdkとtargetSdkの混同
JDKとGradleのバージョン不整合
local.propertiesをgitにコミットしてしまう

Android Gradle Build Failed

概要

エラーメッセージ

原因

解決策

1. Gradleキャッシュのクリア

2. Gradle Wrapperの更新

3. build.gradleの依存関係修正

4. SDKの設定確認

5. JDKバージョンの確認

6. リポジトリの設定

7. Support LibraryからAndroidXへ移行

8. マルチデックス設定

9. ProGuard/R8のエラー

10. ネットワークプロキシの設定

11. メモリ設定

12. デバッグコマンド

バージョン互換性

よくある間違い

関連エラー

参考リンク

Android の他のエラー