Androidアプリのチーム開発をするために、新規プロジェクトの雛形コードをGitHubにpush。
チームメンバがgit cloneして動作確認しようとしたところGradle project sync failedというエラーが発生。
その時の原因と解決策です。
原因
原因は、Android Studioのバージョン違いによる、GradleおよびAndroid Gradle Pluginのバージョン違いでした。
最初にプロジェクトを作成してソースコードをpushした環境は、以前からAndroid Studioをインストール済みだったため、以下のような状況。
- Android Studio: 3.1.2
- Android Gradle Plugin: 4.1.3
- Gradle: 6.0.2
一方のチームメンバーは、Android Studioの新規インストールだっため、当時の最新の安定版であるAndroid Studio Arctic Fox (2020.3.1)をインストール。デフォルトで同梱されているバージョンが以下となり、旧バージョンに対応していませんでした。
- Android Studio Arctic Fox (2020.3.1)
- Android Gradle Plugin: 7.0.2
- Gradle: 7.0.2
ということで、Android Gradle PluginとGradleのバージョンを上げれば良さそう。
解決方法：Android Gradle PluginとGradleのバージョンアップ
プロジェクトで指定されるAndroid Gradle PluginおよびGradleのバージョンを上げます。
Gradleのバージョンを上げるには以下の２つの方法があります。
- Android StudioのUpdate通知に従ってアップデートする
- Android Studio > File > Project Structure > Projectからバージョンを上げる
今回は１の方法で解決しました。
2の方法については公式サイトの[Android Gradle プラグインのリリースノート | Android デベロッパー | Android Developers]に記載があるので、そちらをご覧ください。
環境
- MacBook Air 2020
- OS: macOS Big Sur 11.6
- Android Studio Arctic Fox | 2020.3.1
Android Gradle PluginとGradleのバージョンアップ手順
Android Studioでプロジェクトを開くと、右下にAndroid Gradle PluginのUpdateを促すポップアップが表示されます。
この”upgraded”をクリック。
「Android Gradle Plugin Upgrade Assistant」というダイアログで、
現在のバージョン(current version)から、アップデートするバージョン(to version)が表示されます。Android Studio Arctic Fox | 2020.3.1では7.0.2が安定版として標準搭載されているとのこと。
アップデートを実行するには右下の”Begin Upgrade”をクリック。
Android Studioの「Upgrade Assistant」タブで、Run selected steps”をクリック。
１０分ぐらい経つとアップデートが完了します。
Android Studio > File > Project Structure > Projectを確認すると、アップデートされていることが確認できます。めでたしめでたし。
これで万事解決…とはイカナイ
Gradleのバージョンをアップデートしたところビルドエラーが（汗
公式サイトを見ると、どうやらAndroid Gradle Plugin 7.0以上を動かすにはJava 11が必要とのこと。
[AGP 7.0 の実行に JDK 11 が必要]
解決方法：Android Studio Arctic Fox標準のJava11を利用する
先ほどの画面に出てくるGradle settingsをクリックし、Gradle JDKのプルダウンから、Android Studio java home version 11.0.11を選択します。
次に、build.gradleを、compileOptions を目的の Java バージョンに設定し、compileSdkVersion を 30 以上に設定します。
android { compileSdkVersion 30 compileOptions { sourceCompatibility JavaVersion.VERSION_11 targetCompatibility JavaVersion.VERSION_11 } }これで無事にビルドができるように！めでたしめでたし。