Androidプロジェクトの依存関係はプロジェクトのルートディレクトリでGradleのdependenciesタスクを実行すると確認できます。macOS・Linuxでは次のコマンドを実行します。
./gradlew :app:dependencies --configuration debugRuntimeClasspath
Windowsでは.\gradlew.batに置き換えてください。この記事ではconfigurationの選び方、結果に表示される->や(*)の意味、バージョン競合の原因を絞り込む方法まで解説します。
依存関係を調べるGradleコマンド
実行前の準備
Android StudioのTerminalウィンドウを開いてください。Android StudioのTerminalを使えば、プロジェクトのルートディレクトリが自動的にカレントディレクトリになるので便利です。
コマンドラインから実行する場合はプロジェクトのルートディレクトリに移動してから実行してください。コマンドのパターンは次のとおりです。:appの部分は対象モジュール名に合わせて変更してください。
Windowsで実行する
プロジェクトのルートディレクトリで実行します。次の書き方はPowerShellとコマンドプロンプトの両方で使えます。
.\gradlew.bat :app:dependencies --configuration releaseRuntimeClasspathmacOS / Linuxで実行する
./gradlew :app:dependencies --configuration releaseRuntimeClasspath–configurationの指定について
--configurationにはビルドバリアント(Build Type + Product Flavor)に応じた設定名を指定します。
| ビルド構成 | 指定する設定名 |
|---|---|
| リリースビルド | releaseRuntimeClasspath |
| デバッグビルド | debugRuntimeClasspath |
Product Flavorがdevでデバッグ | devDebugRuntimeClasspath |
実行結果の見方
以下は旧Android Support Libraryを含む依存関係ツリーの例です。ライブラリ名やバージョンは現在の推奨構成を示すものではなく、ツリーと記号の読み方を説明するために掲載しています。
releaseRuntimeClasspath - Resolved configuration for runtime for variant: release
+--- com.android.support:support-v4:24.2.0
| +--- com.android.support:support-compat:24.2.0
| | \--- com.android.support:support-annotations:24.2.0
| +--- com.android.support:support-core-utils:24.2.0
| | \--- com.android.support:support-compat:24.2.0 (*)
| \--- com.android.support:support-fragment:24.2.0
| +--- com.android.support:support-compat:24.2.0 (*)
| \--- com.android.support:support-core-ui:24.2.0 (*)
+--- com.google.code.gson:gson:2.2.4
+--- com.android.support:multidex:1.0.1 -> 1.0.2
+--- com.journeyapps:zxing-android-embedded:3.3.0
| +--- com.google.zxing:core:3.2.1
| \--- com.android.support:support-v4:23.1.0 -> 24.2.0 (*)
\--- com.android.support:multidex:1.0.2
(*) - dependencies omitted (listed previously)各記号の意味
- インデントなしの
+---または---行 ツリーの最上位にある
+---または\---の行は対象のconfigurationに含まれる直接の依存関係です。implementationやapiなどから引き継がれた依存関係も表示されます。- インデントされている行
上位のライブラリから自動的に取り込まれた「推移的依存関係(transitive dependency)」です。
build.gradleで直接指定していなくても依存先としてプロジェクトに追加されます。->記号バージョンが自動解決・変更されたことを示します。
1.0.1 -> 1.0.2であれば「1.0.1を指定したが最終的に1.0.2が採用された」という意味です。(*)マーク同じ推移的依存関係のツリーがすでに展開されているため、配下の表示を省略していることを示します。依存関係そのものが除外されたわけではありません。
(c)マークバージョン選択の条件となる「依存関係の制約」を示します。この行だけでライブラリが追加されるわけではありません。実際の依存関係はツリー内の別の行で確認します。
(n)マーク解決できない依存関係、または解決対象にできないconfigurationを示します。依存宣言用のconfigurationにも付くため、この記号だけで通信エラーとは判断しません。
特定のライブラリの依存元をdependencyInsightで調べる
dependenciesタスクではプロジェクト全体の依存関係をツリー形式で確認できます。ただ、ツリーが大きいと「このライブラリをどこから取り込んでいるのか」が分かりにくいことがあります。特定のライブラリだけを詳しく調べたい場合は、GradleのdependencyInsightタスクを使います。
Windowsの場合
.\gradlew.bat :app:dependencyInsight --dependency androidx.core:core-ktx --configuration debugRuntimeClasspathmacOS・Linuxの場合
./gradlew :app:dependencyInsight --dependency androidx.core:core-ktx --configuration debugRuntimeClasspath--dependencyには調べたいライブラリ名を指定します。上記のandroidx.core:core-ktxは例なので、実際に調べたいライブラリへ置き換えてください。
--configurationには調査するビルドバリアントに対応した設定名を指定します。リリースビルドを調べる場合はdebugRuntimeClasspathをreleaseRuntimeClasspathに変更します。
コマンドを実行するとそのライブラリを要求している依存元と、最終的なバージョンが選ばれた理由を確認できます。依存関係ツリーだけではバージョン衝突の原因を特定できないときに便利です。
結果では採用されたバージョン、Selection reasons、依存元のツリーを確認します。dependenciesが依存先をたどる表示なのに対し、dependencyInsightは指定したライブラリをどこから要求しているかを追う表示です。
Selection reasonsに表示される代表的な理由は次のとおりです。
| 表示 | 読み方 |
|---|---|
By conflict resolution | 異なるバージョン要求の競合を解決して選ばれた |
By constraint | バージョン制約が選択に関わった |
Forced | 強制指定が選択に関わった |
たとえばBy conflict resolutionが出ている場合は、下のツリーで異なるバージョンを要求している依存元を探します。Forcedが出ている場合はビルド設定の強制指定を確認します。
依存関係を調査するときは最初にdependenciesで全体を確認し、気になるライブラリをdependencyInsightで絞り込むと原因を追いやすくなります。
バージョン衝突を確認するときのポイント
->は要求されたバージョンと採用されたバージョンが異なることを示します。
同じライブラリに複数のバージョン要求があるとGradleは通常最も高いバージョンを選びます。制約や強制指定などがある場合はその設定も選択に影響します。
build.gradleやbuild.gradle.ktsの依存宣言にバージョンを書くだけではそのバージョンに固定されるとは限りません。変更する前にdependencyInsightで依存元と採用理由を確認してください。
resolutionStrategy.forceでバージョンを強制する方法もありますが、依存元が必要とするバージョンとの不整合を招くことがあります。まず依存元のライブラリや設定を見直し、強制指定が必要な場合は変更後のビルドとアプリの動作を確認します。
AGPやGradleを更新したあとに依存関係を確認している場合はAndroid StudioとAGPの対応範囲もあわせて確認してください。3年ルールとUpgrade Assistantによる更新手順を以下の記事で整理しています。

迷いやすいポイント
まとめ
Androidプロジェクトでライブラリの依存関係を調べたいときはGradleのdependenciesタスクが便利だよ。ポイントをまとめておきますね。
- macOS / Linuxなら
./gradlew :app:dependencies --configuration releaseRuntimeClasspathを実行だよ。 - Windowsなら
.\gradlew.bat :app:dependencies --configuration releaseRuntimeClasspathを使うよ。 --configurationにはビルドバリアントに応じた設定名(例:debugRuntimeClasspath)を指定だよ。- 出力ツリーを読めばどのライブラリがどのライブラリに依存しているかが一目瞭然だよ。
->が出ていたらバージョンが自動解決されているサインだよ。バージョン衝突の調査に役立ててね。
Android Studio・ADB・GradleなどAndroid開発でよく使う情報は以下のまとめページから確認できます。


