feat: update to maps 20.0.0 and add usage attribution

Author: dkhawk

gradle/libs.versions.toml

@@ -1,29 +1,30 @@
 [versions]
 compileSdk = "36"
 targetSdk = "36"
-minimumSdk = "21"
+minimumSdk = "23"
 
 appcompat = "1.7.1"
 dokka-gradle-plugin = "2.1.0"
-gradle = "8.13.1"
+gradle = "8.13.2"
 jacoco-android = "0.2.1"
 lifecycle-extensions = "2.2.0"
-lifecycle-viewmodel-ktx = "2.9.4"
+lifecycle-viewmodel-ktx = "2.10.0"
+startup-runtime = "1.2.0"
 kotlin = "2.2.21"
 kotlinx-coroutines = "1.10.2"
 junit = "4.13.2"
-mockito-core = "5.20.0"
+mockito-core = "5.21.0"
 secrets-gradle-plugin = "2.0.1"
 truth = "1.4.5"
-play-services-maps = "19.2.0"
+play-services-maps = "20.0.0"
 core-ktx = "1.17.0"
-robolectric = "4.16"
+robolectric = "4.16.1"
 kxml2 = "2.3.0"
-mockk = "1.14.6"
-lint = "31.13.1"
+mockk = "1.14.7"
+lint = "32.0.0"
 org-jacoco-core = "0.8.14"
 material = "1.13.0"
-gradleMavenPublishPlugin = "0.35.0"
+gradleMavenPublishPlugin = "0.36.0"
 
 [libraries]
 appcompat = { module = "androidx.appcompat:appcompat", version.ref = "appcompat" }
@@ -34,6 +35,7 @@ kotlin-gradle-plugin = { module = "org.jetbrains.kotlin:kotlin-gradle-plugin", v
 kotlin-test = { module = "org.jetbrains.kotlin:kotlin-test", version.ref = "kotlin" }
 lifecycle-extensions = { module = "androidx.lifecycle:lifecycle-extensions", version.ref = "lifecycle-extensions" }
 lifecycle-viewmodel-ktx = { module = "androidx.lifecycle:lifecycle-viewmodel-ktx", version.ref = "lifecycle-viewmodel-ktx" }
+startup-runtime = { module = "androidx.startup:startup-runtime", version.ref = "startup-runtime" }
 kotlin-stdlib-jdk8 = { module = "org.jetbrains.kotlin:kotlin-stdlib-jdk8", version.ref = "kotlin" }
 kotlinx-coroutines-android = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-android", version.ref = "kotlinx-coroutines" }
 kotlinx-coroutines-core = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-core", version.ref = "kotlinx-coroutines" }

library/build.gradle.kts

@@ -27,7 +27,7 @@ android {
     }
     defaultConfig {
         compileSdk = libs.versions.compileSdk.get().toInt()
-        minSdk = 21
+        minSdk = libs.versions.minimumSdk.get().toInt()
         testOptions.targetSdk = libs.versions.targetSdk.get().toInt()
         consumerProguardFiles("consumer-rules.pro")
     }
@@ -60,13 +60,15 @@ android {
         unitTests.isReturnDefaultValues = true
     }
     namespace = "com.google.maps.android"
+    sourceSets["main"].java.srcDir("build/generated/source/artifactId")
 }
 
 dependencies {
     api(libs.play.services.maps)
     implementation(libs.kotlinx.coroutines.android)
     implementation(libs.appcompat)
     implementation(libs.core.ktx)
+    implementation(libs.startup.runtime)
     lintPublish(project(":lint-checks"))
     testImplementation(libs.junit)
     testImplementation(libs.robolectric)
@@ -89,3 +91,39 @@ tasks.register("instrumentTest") {
 if (System.getenv("JITPACK") != null) {
     apply(plugin = "maven")
 }
+
+// START: Attribution ID Generation Logic
+val attributionId = "gmp_git_androidmapsutils_v$version"
+
+val generateArtifactIdFile = tasks.register("generateArtifactIdFile") {
+    description = "Generates an AttributionId object from the project version."
+    group = "build"
+
+    val outputDir = layout.buildDirectory.dir("generated/source/artifactId")
+    val packageName = "com.google.maps.android.utils.meta"
+    val packagePath = packageName.replace('.', '/')
+    val outputFile = outputDir.get().file("$packagePath/ArtifactId.kt").asFile
+
+    outputs.file(outputFile)
+
+    doLast {
+        outputFile.parentFile.mkdirs()
+        outputFile.writeText(
+            """
+            package $packageName
+
+            /**
+             * Automatically generated object containing the library's attribution ID.
+             * This is used to track library usage for analytics.
+             */
+            public object AttributionId {
+                public const val VALUE: String = "$attributionId"
+            }
+            """.trimIndent()
+        )
+    }
+}
+
+tasks.named("preBuild") {
+    dependsOn(generateArtifactIdFile)
+}

library/src/main/AndroidManifest.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!--
- Copyright 2024 Google LLC
+ Copyright 2025 Google LLC
 
  Licensed under the Apache License, Version 2.0 (the "License");
  you may not use this file except in compliance with the License.
@@ -15,12 +15,23 @@
  limitations under the License.
 -->
 
-<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
     <!-- https://groups.google.com/group/adt-dev/browse_thread/thread/c059c0380998092b/6720093fb40fdaf9 -->
     <application>
         <meta-data
             android:name="com.google.android.gms.version"
             android:value="@integer/google_play_services_version" />
 
+        <provider
+            android:name="androidx.startup.InitializationProvider"
+            android:authorities="${applicationId}.androidx-startup"
+            android:exported="false"
+            tools:node="merge">
+
+            <meta-data
+                android:name="com.google.maps.android.utils.attribution.AttributionIdInitializer"
+                android:value="androidx.startup" />
+        </provider>
     </application>
 </manifest>

library/src/main/java/com/google/maps/android/utils/attribution/AttributionIdInitializer.kt

@@ -0,0 +1,38 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.google.maps.android.utils.attribution
+
+import android.content.Context
+import androidx.startup.Initializer
+import com.google.android.gms.maps.MapsApiSettings
+import com.google.maps.android.utils.meta.AttributionId
+
+/**
+ * Initializes the AttributionId at application startup.
+ */
+internal class AttributionIdInitializer : Initializer<Unit> {
+    override fun create(context: Context) {
+        MapsApiSettings.addInternalUsageAttributionId(
+            /* context = */ context,
+            /* internalUsageAttributionId = */ AttributionId.VALUE
+        )
+    }
+
+    override fun dependencies(): List<Class<out Initializer<*>>> {
+        return emptyList()
+    }
+}