Androidプロジェクトの依存関係をGradleで確認する方法|結果の見方と競合調査

このサイトはアフィリエイト広告(Amazonアソシエイト含む)を掲載しています。
AndroidのプロジェクトツリーとGradle・モジュール・ライブラリの関係を描いたイメージ

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 releaseRuntimeClasspath

macOS / Linuxで実行する

Bash
./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の場合

PowerShell
.\gradlew.bat :app:dependencyInsight --dependency androidx.core:core-ktx --configuration debugRuntimeClasspath

macOS・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 Studio上でGUIで確認する方法はない?

Android Studioには依存関係をグラフィカルに表示する機能もあります。

View → Tool Windows → Gradle → AppName → Tasks → android → androidDependencies

:app以外のモジュールも調べられる?

調べられますよ。マルチモジュール構成のプロジェクトであれば:feature:loginのようにモジュール名を変えれば各モジュールの依存関係を個別に確認できます。

releaseRuntimeClasspathが見つからない場合は?

対象モジュールに、その名前のconfigurationがあるか確認してください。Product Flavorを使っている場合はdevReleaseRuntimeClasspathのようにフレーバー名が含まれることがあります。

名前が分からないときは--configurationを外して実行し、レポートに出るconfiguration名を確認します。

Windowsの場合

PowerShell
.\gradlew.bat :app:dependencies

macOS・Linuxの場合

Bash
./gradlew :app:dependencies

一覧から調べたいビルドバリアントのRuntimeClasspathを選び--configurationに指定してください。:app以外のモジュールを調べる場合は、モジュール名も変更します。

特定のライブラリだけ調べるには?

dependencyInsightタスクを使います。--dependencyにライブラリ名、--configurationに調査するクラスパスを指定すると依存元と採用理由を確認できます。

まとめ

Androidプロジェクトでライブラリの依存関係を調べたいときはGradleのdependenciesタスクが便利だよ。ポイントをまとめておきますね。

  • macOS / Linuxなら./gradlew :app:dependencies --configuration releaseRuntimeClasspathを実行だよ。
  • Windowsなら.\gradlew.bat :app:dependencies --configuration releaseRuntimeClasspathを使うよ。
  • --configurationにはビルドバリアントに応じた設定名(例:debugRuntimeClasspath)を指定だよ。
  • 出力ツリーを読めばどのライブラリがどのライブラリに依存しているかが一目瞭然だよ。
  • ->が出ていたらバージョンが自動解決されているサインだよ。バージョン衝突の調査に役立ててね。

Android Studio・ADB・GradleなどAndroid開発でよく使う情報は以下のまとめページから確認できます。

  • URLをコピーしました!
目次