Merge branch 'main' into dependabot/gradle/truth-1.4.4

Author: rlazo

.github/workflows/dataconnect.yml

@@ -217,10 +217,10 @@ jobs:
           if-no-files-found: warn
           compression-level: 9
 
-      - name: Check test result
+      - name: Verify "Gradle connectedCheck" step was successful
         if: steps.connectedCheck.outcome != 'success'
         run: |
-          echo "Failing the job since the connectedCheck step failed"
+          echo 'Failing because the outcome of the "Gradle connectedCheck" step ("${{ steps.connectedCheck.outcome }}") was not successful'
           exit 1
 
   # Check this yml file with "actionlint": https://github.com/rhysd/actionlint

firebase-config/src/main/java/com/google/firebase/remoteconfig/FirebaseRemoteConfig.java

@@ -656,16 +656,17 @@ private Task<Void> setDefaultsWithStringsMapAsync(Map<String, String> defaultsSt
    * Asynchronously changes the custom signals for this {@link FirebaseRemoteConfig} instance.
    *
    * <p>Custom signals are subject to limits on the size of key/value pairs and the total
-   * number of signals. Any calls that exceed these limits will be discarded.
+   * number of signals. Any calls that exceed these limits will be discarded. See <a
+   * href="https://firebase.google.com/docs/remote-config/parameters?template_type=client#custom-signal-limits">Custom
+   * Signal Limits</a>.
    *
    * @param customSignals The custom signals to set for this instance.
-   * <ol>
+   * <ul>
    *   <li>New keys will add new key-value pairs in the custom signals.
    *   <li>Existing keys with new values will update the corresponding signals.
    *   <li>Setting a key's value to {@code null} will remove the associated signal.
-   * </ol>
+   * </ul>
    */
-  // TODO(b/385028620): Add link to documentation about custom signal limits.
   @NonNull
   public Task<Void> setCustomSignals(@NonNull CustomSignals customSignals) {
     return Tasks.call(

firebase-vertexai/src/main/kotlin/com/google/firebase/vertexai/type/ImagenGenerationResponse.kt

@@ -16,10 +16,11 @@
 
 package com.google.firebase.vertexai.type
 
+import com.google.firebase.vertexai.ImagenModel
 import kotlinx.serialization.Serializable
 
 /**
- * Represents a response from a call to [ImagenModel#generateImages]
+ * Represents a response from a call to [ImagenModel.generateImages]
  *
  * @param images contains the generated images
  * @param filteredReason if fewer images were generated than were requested, this field will contain

plugins/src/main/java/com/google/firebase/gradle/plugins/CopyApiTask.kt

@@ -0,0 +1,33 @@
+/*
+ * 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.firebase.gradle.plugins
+
+import org.gradle.api.DefaultTask
+import org.gradle.api.file.RegularFileProperty
+import org.gradle.api.tasks.InputFile
+import org.gradle.api.tasks.OutputFile
+import org.gradle.api.tasks.TaskAction
+
+abstract class CopyApiTask : DefaultTask() {
+  @get:InputFile abstract val apiTxtFile: RegularFileProperty
+  @get:OutputFile abstract val output: RegularFileProperty
+
+  @TaskAction
+  fun run() {
+    output.get().asFile.writeText(apiTxtFile.get().asFile.readText())
+  }
+}

plugins/src/main/java/com/google/firebase/gradle/plugins/FirebaseAndroidLibraryPlugin.kt

@@ -160,6 +160,11 @@ class FirebaseAndroidLibraryPlugin : BaseFirebaseLibraryPlugin() {
           .getLatestReleasedVersion()
       )
     }
+
+    project.tasks.register<CopyApiTask>("copyApiTxtFile") {
+      apiTxtFile.set(project.file("api.txt"))
+      output.set(project.file("previous_api.txt"))
+    }
   }
 
   private fun setupApiInformationAnalysis(project: Project, android: LibraryExtension) {

plugins/src/main/java/com/google/firebase/gradle/plugins/FirebaseJavaLibraryPlugin.kt

@@ -103,6 +103,11 @@ class FirebaseJavaLibraryPlugin : BaseFirebaseLibraryPlugin() {
 
       dependsOn("copyPreviousArtifacts")
     }
+
+    project.tasks.register<CopyApiTask>("copyApiTxtFile") {
+      apiTxtFile.set(project.file("api.txt"))
+      output.set(project.file("previous_api.txt"))
+    }
   }
 
   private fun setupApiInformationAnalysis(project: Project) {

plugins/src/main/java/com/google/firebase/gradle/plugins/FirebaseLibraryExtension.kt

@@ -241,6 +241,9 @@ constructor(val project: Project, val type: LibraryType) {
   val version: String
     get() = project.version.toString()
 
+  val previousVersion: String
+    get() = project.properties["latestReleasedVersion"].toString()
+
   val path: String = project.path
 
   val runtimeClasspath: String =