Add Bill of Material

bom/build.gradle.kts

@@ -0,0 +1,18 @@
+plugins {
+    kotlin("jvm")
+    id("com.vanniktech.maven.publish")
+}
+
+dependencies {
+    constraints {
+        api(project(":permissions"))
+        api(project(":photopicker"))
+        api(project(":storage"))
+        api("com.squareup.okio:okio:3.0.0")
+    }
+}
+
+java {
+    sourceCompatibility = JavaVersion.VERSION_1_8
+    targetCompatibility = JavaVersion.VERSION_1_8
+}

bom/gradle.properties

@@ -0,0 +1,3 @@
+POM_ARTIFACT_ID=modernstorage-bom
+POM_NAME=ModernStorage Bill of Material
+POM_PACKAGING=jar

build.gradle

@@ -70,7 +70,7 @@ subprojects {
         }
     }
 
-    if (project.hasProperty('POM_ARTIFACT_ID')) {
+    if (project.hasProperty('POM_ARTIFACT_ID') && project.properties['POM_ARTIFACT_ID'] != "modernstorage-bom") {
         apply plugin: 'me.tylerbwong.gradle.metalava'
 
         metalava {

docs/README.md

@@ -19,6 +19,21 @@ implementation("com.google.modernstorage:modernstorage-permissions:{{ lib_versio
 implementation("com.google.modernstorage:modernstorage-storage:{{ lib_version }}")
 ```
 
+Alternatively use the Bill of Material to just have to define the version once, and then define which modules you need.
+
+```kotlin
+implementation("com.google.modernstorage:modernstorage-bom:{{ lib_version }}")
+
+implementation("com.google.modernstorage:modernstorage-permissions")
+
+implementation("com.google.modernstorage:modernstorage-storage")
+
+// The Bill of Material includes Okio and Photo Picker as well
+implementation("com.google.modernstorage:modernstorage-photopicker")
+
+implementation("com.squareup.okio:okio")
+```
+
 ## Quick start
 
 * Have a look at the [permissions][permissions_guide] and [storage interactions][storage_interactions_guide] guides

mkdocs.yml

@@ -46,4 +46,4 @@ plugins:
     - macros
 
 extra:
-    lib_version: "1.0.0-alpha04"
+    lib_version: "1.0.0-alpha03"

settings.gradle

@@ -15,6 +15,7 @@
  */
 
 rootProject.name = "ModernStorage"
+include ':bom'
 include ':permissions'
 include ':photopicker'
 include ':storage'