Merge remote-tracking branch 'origin/main' into IgnoreUnknownPropertiesInResponse

Author: dconeybe

.github/workflows/ci_tests.yml

@@ -38,6 +38,7 @@ jobs:
     runs-on: ubuntu-22.04
     needs:
       - determine_changed
+    if: ${{ needs.determine_changed.outputs.modules != '[]' }}
     strategy:
       fail-fast: false
       matrix:
@@ -89,12 +90,11 @@ jobs:
   # to be used as a required check for merging.
   check_all:
     runs-on: ubuntu-22.04
-    if: always()
     name: Unit Tests (matrix)
     needs: unit_tests
+    if: ${{ failure() }}
     steps:
-      - name: Check test matrix
-        if: needs.unit_tests.result != 'success'
+      - name: Check test matrix results
         run: exit 1
 
 

agents.md

@@ -0,0 +1,129 @@
+# Agents
+
+This guide provides essential information for working within the `firebase-android-sdk` repository.
+
+## Environment Setup
+
+To work with this repository, the Android SDK must be installed. Use the `sdkmanager` command-line
+tool for this purpose.
+
+1.  **Install Android SDK Command-Line Tools**:
+
+    - If not already installed, download the command-line tools from the
+      [Android Studio page](https://developer.android.com/studio#command-line-tools-only).
+    - Create a directory for the Android SDK, e.g., `android_sdk`.
+    - Unzip the downloaded package. This will create a `cmdline-tools` directory. Move this
+      directory to `android_sdk/cmdline-tools/latest`.
+    - The final structure should be `android_sdk/cmdline-tools/latest/`.
+
+2.  **Install required SDK packages**:
+
+    - Use `sdkmanager` to install the necessary platforms, build tools, and other packages. For
+      example:
+
+      ```bash
+      # List all available packages
+      sdkmanager --list
+
+      # Install platform tools and the SDK for API level 33
+      sdkmanager "platform-tools" "platforms;android-33"
+
+      # Accept all licenses
+      yes | sdkmanager --licenses
+      ```
+
+    - Refer to the specific requirements of the project to determine which packages to install.
+
+3.  **Configure for integration tests**:
+
+    - To run integration tests, a `google-services.json` file is required.
+    - Place this file in the root of the repository.
+
+4.  **Install NDK for specific projects**:
+    - Some projects, like `firebase-crashlytics-ndk`, require a specific version of the Android NDK.
+      You can install it using `sdkmanager`. For example, to install NDK version 21.4.7075529, you
+      would run `sdkmanager "ndk;21.4.7075529"`. Always refer to the project's `README.md` for the
+      exact version required.
+
+---
+
+## Testing
+
+This repository uses two main types of tests:
+
+1.  **Unit Tests**:
+
+    - These tests run on the local JVM.
+    - To execute unit tests for a specific project, run:
+      ```bash
+      ./gradlew :<firebase-project>:check
+      ```
+
+2.  **Integration Tests**:
+    - These tests run on a hardware device or emulator.
+    - Ensure a `google-services.json` file is present in the repository root.
+    - To execute integration tests for a specific project, run:
+      ```bash
+      ./gradlew :<firebase-project>:connectedCheck
+      ```
+
+---
+
+## API Surface
+
+The public API of the Firebase SDKs is managed using a set of annotations:
+
+- `@PublicApi`: Marks APIs that are intended for public consumption by developers.
+- `@KeepForSdk`: Marks APIs that are intended for use by other Firebase SDKs. These APIs will
+  trigger a linter error if used by developers outside of a Firebase package.
+- `@Keep`: Marks APIs that need to be preserved at runtime, usually due to reflection. This
+  annotation should be used sparingly as it prevents Proguard from removing or renaming the code.
+
+---
+
+## Common Patterns
+
+This repository uses a combination of dependency injection frameworks:
+
+- **`firebase-components`**: This is a custom dependency injection framework used for discovery and
+  dependency injection between different Firebase SDKs. It allows SDKs to register their components
+  and declare dependencies on other components. The initialization is managed by `FirebaseApp`.
+
+- **Dagger**: Dagger is used for internal dependency injection within individual SDKs. This helps to
+  create more testable and maintainable code. Dagger components are typically instantiated within
+  the `ComponentRegistrar` of an SDK, which allows for the injection of dependencies from
+  `firebase-components` into the Dagger graph.
+
+---
+
+## Iteration Loop
+
+After you make a change, here's the flow you should follow:
+
+- Format the code using `spotless`. It can be run with:
+  ```bash
+  ./gradlew :<firebase-project>:spotlessApply
+  ```
+- Run unit tests:
+  ```bash
+  ./gradlew :<firebase-project>:check
+  ```
+- If necessary, run integration tests based on the instructions above.
+
+---
+
+## External Dependencies
+
+---
+
+Do not add, under any circunstance, any new dependency to a SDK that does not already exists in the
+`gradle/libs.versions.toml`, and even then, only do it if cxexplicitly asked to do so. The Firebase
+SDKs are designed to be lightweight, and adding new dependencies can increase the size of the final
+artifacts.
+
+---
+
+## Updating this Guide
+
+If new patterns or conventions are discovered, update this guide to ensure it remains a useful
+resource.

firebase-ai/CHANGELOG.md

@@ -1,14 +1,17 @@
 # Unreleased
 
+# 17.2.0
+
 - [feature] Added support for returning thought summaries, which are synthesized versions of a
   model's internal reasoning process.
 - [fixed] Fixed an issue causing the accessor methods in `GenerateContentResponse` to throw an
   exception when the response contained no candidates.
 - [changed] Added better description for requests which fail due to the Gemini API not being
   configured.
-- [changed] Added a `dilation` parameter to `ImagenMaskReference.generateMaskAndPadForOutpainting`
+
+* [changed] Added a `dilation` parameter to `ImagenMaskReference.generateMaskAndPadForOutpainting`
   (#7260)
-- [feature] Added support for limited-use tokens with Firebase App Check. These short-lived tokens
+* [feature] Added support for limited-use tokens with Firebase App Check. These short-lived tokens
   provide greater protection for the APIs that give you access to Gemini and Imagen models. Learn
   how to [enable usage of limited-use tokens](https://firebase.google.com/docs/ai-logic/app-check).
   (#7285)
@@ -19,7 +22,8 @@
 
 - [feature] added support for Imagen Editing, including inpainting, outpainting, control, style
   transfer, and subject references (#7075)
-- [feature] **Preview:** Added support for bidirectional streaming in Gemini Developer Api
+
+* [feature] **Preview:** Added support for bidirectional streaming in Gemini Developer Api
 
 # 17.0.0
 

firebase-ai/gradle.properties

@@ -12,5 +12,5 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-version=17.2.0
-latestReleasedVersion=17.1.0
+version=17.2.1
+latestReleasedVersion=17.2.0

firebase-crashlytics-ndk/CHANGELOG.md

@@ -1,5 +1,7 @@
 # Unreleased
 
+# 20.0.1
+
 - [changed] Updated `firebase-crashlytics` dependency to 20.0.1
 
 # 20.0.0

firebase-crashlytics-ndk/gradle.properties

@@ -1,2 +1,2 @@
-version=20.0.1
-latestReleasedVersion=20.0.0
+version=20.0.2
+latestReleasedVersion=20.0.1

firebase-crashlytics/CHANGELOG.md

@@ -1,6 +1,8 @@
 # Unreleased
 
-\*\* [changed] Updated `firebase-sessions` dependency to v3.0.1
+# 20.0.1
+
+- [changed] Updated `firebase-sessions` dependency to v3.0.1
 
 # 20.0.0
 

firebase-crashlytics/gradle.properties

@@ -1,2 +1,2 @@
-version=20.0.1
-latestReleasedVersion=20.0.0
+version=20.0.2
+latestReleasedVersion=20.0.1

firebase-perf/CHANGELOG.md

@@ -1,5 +1,7 @@
 # Unreleased
 
+# 22.0.1
+
 - [fixed] Fixed an ANR on app launch. [#4831]
 
 # 22.0.0

firebase-perf/gradle.properties

@@ -15,7 +15,7 @@
 #
 #
 
-version=22.0.1
-latestReleasedVersion=22.0.0
+version=22.0.2
+latestReleasedVersion=22.0.1
 android.enableUnitTestBinaryResources=true