libs.versions.toml の group / name 分離と module 1文字列、どっちを使う?——実際の傾向と選び方の基準

Gradle の Version Catalog(gradle/libs.versions.toml)でライブラリを定義するとき、次のような2つの書き方があることに気づく。


# 1. group と name を分ける書き方
androidx-ui-tooling-preview = { group = "androidx.compose.ui", name = "ui-tooling-preview", version.ref = "composeBom" }

# 2. module に 1 文字列で書く書き方
androidx-ui-tooling-preview = { module = "androidx.compose.ui:ui-tooling-preview", version.ref = "composeBom" }

結論から言うと、Gradle 側の解釈やビルド結果に違いはない。どちらも同じ依存関係として解決される。

では、現場や公開リポジトリではどちらが多く使われているのか、また自分のプロジェクトではどちらを選ぶべきなのかを整理する。

 

🧑🏻‍💻 実際の現場ではどちらが多い?

体感や公開テンプレート・サンプルコードの傾向としては、group と name を分ける書き方のほうがやや多い。

理由はシンプルで、Android Studio の新規プロジェクト生成や公式サンプルで長く使われてきたスタイルだからだ。一度テンプレートや既存コードベースで group / name 形式が定着すると、そのまま踏襲されるケースが多くなる。

一方で、最近は module = "group:name" を好むケースも着実に増えている。リリースノートやドキュメントに書かれた group:artifact の表記をそのままコピー&ペーストしやすく、記述の手間が少ないからだ。特に BOM(Bill of Materials)でバージョンが管理されるライブラリを並べる場合、1行でスッキリ書ける点が好まれる。

 

🧑🏻‍💻 それぞれのメリット・デメリット

1. group と name を分ける書き方


[libraries]
compose-ui = { group = "androidx.compose.ui", name = "ui", version.ref = "composeBom" }
compose-ui-graphics = { group = "androidx.compose.ui", name = "ui-graphics", version.ref = "composeBom" }
compose-ui-tooling-preview = { group = "androidx.compose.ui", name = "ui-tooling-preview", version.ref = "composeBom" }

メリット:

- 同じ group に属するライブラリ群を並べたとき、構造が揃って視認性が高い。

- group 単位・name 単位での検索や機械的な置換がしやすい。

デメリット:

- 1エントリあたりの記述量が増える。

- ライブラリを追加するたびに group と name に分割するひと手間がかかる。

2. module = "group:name" の書き方


[libraries]
compose-ui = { module = "androidx.compose.ui:ui", version.ref = "composeBom" }
compose-ui-graphics = { module = "androidx.compose.ui:ui-graphics", version.ref = "composeBom" }
compose-ui-tooling-preview = { module = "androidx.compose.ui:ui-tooling-preview", version.ref = "composeBom" }

メリット:

- 外部ドキュメントや Maven 座標のコピペが速く、分割ミスが起きにくい。

- バージョン指定を省略できるケース(BOM 併用時など)では 1 行で簡潔に書ける。

デメリット:

- 同じ group が続く場合、コピペの繰り返しが多くなる。

 

🧑🏻‍💻 結局、どう選ぶのが現実的か

厳密な正解があるわけではないので、迷ったら次の基準で決めるとブレない。

既存プロジェクトやチームに合わせる:
すでにどちらかに統一されているなら、差分ノイズを減らすためにそのスタイルに合わせるのが一番無難。

新規・個人開発なら好みで選ぶ:
コピペの速さや短さを優先するなら module、構造の揃いや group / name の明示性を優先するなら分離形式を選べば問題ない。

途中から変えるときは一括変換で揃える:
混在して読みづらくなった場合は、エディタの検索置換やスクリプトで一気にどちらかに寄せてしまうとスッキリする。

 

🧑🏻‍💻 まとめ

libs.versions.toml における group / name 分離と module 1文字列は、どちらも仕様上同等で機能差はない。現状は group / name 分離がやや主流だが、module 記法の手軽さも十分実用的だ。大事なのは表記の揺れを放置せず、プロジェクトごとに読みやすい形へ揃えておくことである。


Related Categories :  Android・AndroidStudio・apps・JetpackCompose・KMP・Kotlin・Kotlin Multiplatform Mobile