firebase-dataconnect merge into main branch

firebase-dataconnect/.gitignore

@@ -0,0 +1 @@
+dataconnect.local.properties

firebase-dataconnect/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Unreleased
+* [feature] Initial release of the Data Connect SDK (public preview). See
+  https://firebase.google.com/docs/data-connect/android-sdk for instructions on
+  getting started.
+* [feature] Add ability to specify SerializersModule when serializing.
+* [feature] CallerSdkType added, to enable tracking generated SDK usage.
+* [changed] Changed gRPC proto package to v1beta (was v1alpha).

firebase-dataconnect/README.md

@@ -0,0 +1,110 @@
+# firebase-dataconnect
+
+This is the Firebase Android Data Connect SDK.
+
+## Building
+
+All Gradle commands should be run from the source root (which is one level up
+from this folder). See the README.md in the source root for instructions on
+publishing/testing Firebase Data Connect.
+
+To build Firebase Data Connect, from the source root run:
+```bash
+./gradlew :firebase-dataconnect:assembleRelease
+```
+
+## Unit Testing
+
+To run unit tests for Firebase Data Connect, from the source root run:
+```bash
+./gradlew :firebase-dataconnect:check
+```
+
+## Integration Testing
+
+Running integration tests requires a Firebase project because they connect to
+the Firebase Data Connect backend.
+
+See [here](../README.md#project-setup) for how to setup a project.
+
+Once you setup the project, download `google-services.json` and place it in
+the source root.
+
+Make sure you have created a Firebase Data Connect instance for your project,
+before you proceed.
+
+By default, integration tests run against the Firebase Data Connect emulator.
+
+### Setting up the Firebase Data Connect Emulator
+
+The integration tests require that the Firebase Data Connect emulator is running
+on port 9399, which is default when running it via the Data Connect Toolkit.
+
+  * [Install the Firebase CLI](https://firebase.google.com/docs/cli/).
+    ```
+    npm install -g firebase-tools
+    ```
+  * [Install the Firebase Data Connect
+    emulator](https://firebase.google.com/docs/FIX_URL/security/test-rules-emulator#install_the_emulator).
+    ```
+    firebase setup:emulators:dataconnect
+    ```
+  * Run the emulator
+    ```
+    firebase emulators:start --only dataconnect
+    ```
+  * Select the `Firebase Data Connect Integration Tests (Firebase Data Connect
+    Emulator)` run configuration to run all integration tests.
+
+To run the integration tests against prod, select
+`DataConnectProdIntegrationTest` run configuration.
+
+### Run on Local Android Emulator
+
+Then run:
+```bash
+./gradlew :firebase-dataconnect:connectedCheck
+```
+
+### Run on Firebase Test Lab
+
+You can also test on Firebase Test Lab, which allow you to run the integration
+tests on devices hosted in a Google data center.
+
+See [here](../README.md#running-integration-tests-on-firebase-test-lab) for
+instructions of how to setup Firebase Test Lab for your project.
+
+Run:
+```bash
+./gradlew :firebase-dataconnect:deviceCheck
+```
+
+## Code Formatting
+
+Run below to format Kotlin and Java code:
+```bash
+./gradlew :firebase-dataconnect:spotlessApply
+```
+
+See [here](../README.md#code-formatting) if you want to be able to format code
+from within Android Studio.
+
+## Build Local Jar of Firebase Data Connect SDK
+
+```bash
+./gradlew -PprojectsToPublish="firebase-dataconnect" publishReleasingLibrariesToMavenLocal
+```
+
+Developers may then take a dependency on these locally published versions by adding
+the `mavenLocal()` repository to your [repositories
+block](https://docs.gradle.org/current/userguide/declaring_repositories.html) in
+your app module's build.gradle.
+
+## Misc
+After importing the project into Android Studio and building successfully
+for the first time, Android Studio will delete the run configuration xml files
+in `./idea/runConfigurations`. Undo these changes with the command:
+
+```
+$ git checkout .idea/runConfigurations
+```

firebase-dataconnect/androidTestutil/androidTestutil.gradle.kts

@@ -0,0 +1,73 @@
+/*
+ * Copyright 2024 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.
+ */
+
+import org.jetbrains.kotlin.gradle.tasks.KotlinCompile
+
+plugins {
+  id("com.android.library")
+  id("kotlin-android")
+  alias(libs.plugins.kotlinx.serialization)
+}
+
+android {
+  val compileSdkVersion : Int by rootProject
+  val targetSdkVersion : Int by rootProject
+  val minSdkVersion : Int by rootProject
+
+  namespace = "com.google.firebase.dataconnect.androidTestutil"
+  compileSdk = compileSdkVersion
+  defaultConfig {
+    minSdk = minSdkVersion
+    targetSdk = targetSdkVersion
+    testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
+  }
+  compileOptions {
+    sourceCompatibility = JavaVersion.VERSION_1_8
+    targetCompatibility = JavaVersion.VERSION_1_8
+  }
+  kotlinOptions { jvmTarget = "1.8" }
+
+  packaging {
+    resources {
+      excludes.add("META-INF/LICENSE.md")
+      excludes.add("META-INF/LICENSE-notice.md")
+    }
+  }
+}
+
+dependencies {
+  api("com.google.firebase:firebase-common:21.0.0")
+  api(project(":firebase-dataconnect"))
+  api(project(":firebase-dataconnect:testutil"))
+  api(libs.kotlinx.coroutines.core)
+
+  implementation(libs.androidx.test.core)
+  implementation(libs.androidx.test.junit)
+  implementation(libs.auth0.jwt)
+  implementation(libs.kotlinx.serialization.core)
+  implementation(libs.kotlinx.serialization.json)
+  implementation(libs.turbine)
+  implementation(libs.truth)
+
+  implementation("com.google.firebase:firebase-auth:22.3.1")
+  implementation("com.google.firebase:firebase-appcheck:18.0.0")
+}
+
+tasks.withType<KotlinCompile>().all {
+  kotlinOptions {
+    freeCompilerArgs = listOf("-opt-in=kotlin.RequiresOptIn")
+  }
+}

firebase-dataconnect/androidTestutil/src/main/AndroidManifest.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools">
+  <application />
+</manifest>

firebase-dataconnect/androidTestutil/src/main/assets/firebase-admin-service-account.key.json

@@ -0,0 +1,13 @@
+{
+  "type": "service_account",
+  "project_id": "prjh5zbv64sv6",
+  "private_key_id": "abcdef0123456789abcdef0123456789abcdef01",
+  "private_key": "-----BEGIN PRIVATE KEY-----\nMIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCvfyKRUZMyp1FS\nbL2cZIMNA5AbDHBuZciEZFIbG7rx7d12Lnwz/inBSuhJ2qzmSHvWLQfjV0xsPVEH\nCCQdB7owt8GemvcyrzaW/vQ5WmvN7Wpj7Efz7iEguXQfqa09FklGECfrhgnOdsdd\ntoQW19nzETwepXzBvo6C/etTesUHAjBLUeHoh94vDvMTbp+9Dc48pG+uMhSVItjV\nv32lDRemFcewK33SCYWG2+3CqEQHlFf75pnbMTJr0392KLJtXqv6Kgcd61JXB7l8\nw8G4GPm8o9er0l4j5lB36Az1SmAJM68K7lI98PMrCcSsdwgNT3R16J6y+zMJfc5h\nStGdJP5hAgMBAAECggEARGEtl2CpEYoHEi4jfS3esDHsstVYc3N+OzOZmE1oPH65\nlSRMqbeFDncA5lHpn3qrocp+8dJgiSYlDa/a3mLV5cibjRCFc/64LwJdJ4G3UpAI\nrbFxYbatusH34KRsx0oJN97wpwDdjlBSow2MDxiAqAhVm/1QDG+SuLB2QlsqLO3E\ntDHgix+x08b01ui7/QYm83y1qTUTeCq/JlpRcMe4Nqp8RJiVTu+OY9MVJeA7o/ng\nLYnjTI0u1kB346EClTvq2xSb0h5AENtAd61B7H65JtkQWB5uDHL3HrWAbVVldp21\ncH6sO66/ApY4v0KGalgbBZ6VzmVuzVp7Kl+0t+m0/wKBgQDVdmz77vdjsTG7LEqC\nsknEKOTXSJYpA6g4dCouwHGrS4EkNzCXaAOCAdOoPkBF991uNNSqPtaDDMqF5CpA\nvJKzANBn1AuGp9jimITfA82KtEbA3t7yCk6A6+sAJNHsVA5I0+p/wcO0VmVZGIoN\n2pIHOTVbytcfAgHG0CjMv2SbJwKBgQDSd+n/sdTNFcTe8KoRJP2N9UFGip/9GZrV\nn9SUZGHojYrCY8DKI0GtAgR6Lij9D9CJRTPDSOEMuNpyPQQNFa5Sa14ic6dcksNg\nG6cq1BaaqXE7nxzVvgrOBXAxnRudd7rI/JoEsrG+Ca23HkvuCKsydjbNs6GY9hfE\nSfMnrsivNwKBgQDBJDAkG+pXl6Jpuv+IFg1Mobu9Vv4XCioROnpYZuPym5Sz0gPz\nWreh0ElUd07sgAMojkDF8aliVhaA4xugC3+o21m2OFRdeE1zaZD/wI8fq1JBfOa4\nlb7GQ7AUJzyR2tQ57RTGl+mdqHZ3EQ8IzfVG9+phrbzLX6N/4iSobZx4DQKBgEYY\nn/uD+67OOEJT/yA0pKnZ7AKVetFt7K6HS+KcSCuOsI8rb/MiqOX5DQqwQwB9euOt\nA59fr2xwSHjRr364INXcYn6w7CWdz6o7q4JNHrYmBstno8/gOnMBRquPeroIPVJh\nJt63sRDs4klhssI1auckjf4WfJSYKbQ7ONuXj8kjAoGBAILZG9+YNZ9IKLtQzcdf\nbWzgQ2b9CujHdZ5agSGUHVeKSSIInQZAc5jRCKz35T9Xnh50qrixcNA90IvpjbGL\nCNmmvmB+IlIuH/Mzn6wb5fad8d80e1Yz+ueeAyZjMS6NYLwmZ1M52eeikRWdyO/h\nZ3q6UYLR9K+mhUFgV+X7g15T\n-----END PRIVATE KEY-----\n",
+  "client_email": "firebase-adminsdk-trn2rx6xed@prjh5zbv64sv6.iam.gserviceaccount.com",
+  "client_id": "123456789012345678901",
+  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
+  "token_uri": "https://oauth2.googleapis.com/token",
+  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
+  "client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/firebase-adminsdk-trn2rx6xed%40prjh5zbv64sv6.iam.gserviceaccount.com",
+  "universe_domain": "googleapis.com"
+}