feat(appdistribution): add in-app-feedback support

appdistribution/app/build.gradle

@@ -49,8 +49,10 @@ dependencies {
  // Import the Firebase BoM (see: https://firebase.google.com/docs/android/learn-more#bom)
  implementation platform('com.google.firebase:firebase-bom:31.2.0')
 
- // ADD the SDK to the "prerelease" variant only (example)
- implementation 'com.google.firebase:firebase-appdistribution-ktx:16.0.0-beta01'
+ implementation 'com.google.firebase:firebase-appdistribution-api-ktx:16.0.0-beta06'
+
+ // ADD the full SDK implementation to the "debug" variant only
+ debugImplementation 'com.google.firebase:firebase-appdistribution:16.0.0-beta06'
 
  // For an optimal experience using App Distribution, add the Firebase SDK
  // for Google Analytics. This is recommended, but not required.

appdistribution/app/src/main/AndroidManifest.xml

@@ -1,6 +1,9 @@
 <?xml version="1.0" encoding="utf-8"?>
 <manifest xmlns:android="http://schemas.android.com/apk/res/android">
 
+ <!-- Used by the Firebase App Distribution SDK to display in app feedback notifications -->
+ <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
+
  <application
  android:name="androidx.multidex.MultiDexApplication"
  android:allowBackup="true"

appdistribution/app/src/main/java/com/google/firebase/appdistributionquickstart/java/MainActivity.java

@@ -1,17 +1,37 @@
 package com.google.firebase.appdistributionquickstart.java;
 
+import android.Manifest;
+import android.content.pm.PackageManager;
+import android.os.Build;
 import android.os.Bundle;
+import android.widget.Toast;
 
+import androidx.activity.result.ActivityResultLauncher;
+import androidx.activity.result.contract.ActivityResultContracts;
 import androidx.appcompat.app.AppCompatActivity;
+import androidx.core.content.ContextCompat;
 
 import com.google.firebase.appdistribution.FirebaseAppDistribution;
 import com.google.firebase.appdistribution.FirebaseAppDistributionException;
+import com.google.firebase.appdistribution.InterruptionLevel;
 import com.google.firebase.appdistributionquickstart.databinding.ActivityMainBinding;
 
 public class MainActivity extends AppCompatActivity {
 
  private static final String TAG = "AppDistribution-Quickstart";
 
+ // Declare the launcher at the top of your Activity/Fragment:
+ private final ActivityResultLauncher<String> requestPermissionLauncher =
+ registerForActivityResult(new ActivityResultContracts.RequestPermission(), isGranted -> {
+ if (!isGranted) {
+ Toast.makeText(
+ MainActivity.this,
+ "The app won't display feedback notifications because the notification permission was denied",
+ Toast.LENGTH_LONG
+ ).show();
+ }
+ });
+
  private FirebaseAppDistribution mFirebaseAppDistribution;
 
  @Override
@@ -21,6 +41,19 @@ protected void onCreate(Bundle savedInstanceState) {
  setContentView(binding.getRoot());
 
  mFirebaseAppDistribution = FirebaseAppDistribution.getInstance();
+
+ binding.btShowNotification.setOnClickListener(view -> {
+ mFirebaseAppDistribution.showFeedbackNotification(
+ "Data Collection Notice",
+ InterruptionLevel.HIGH
+ );
+ });
+
+ binding.btSendFeedback.setOnClickListener(view -> {
+ mFirebaseAppDistribution.startFeedback("Thanks for sharing your feedback with us");
+ });
+
+ askNotificationPermission();
  }
 
  @Override
@@ -37,4 +70,29 @@ public void onResume() {
  }
  });
  }
+
+ @Override
+ protected void onDestroy() {
+ super.onDestroy();
+ // Hide the notification once this activity is destroyed
+ mFirebaseAppDistribution.cancelFeedbackNotification();
+ }
+
+ private void askNotificationPermission() {
+ // This is only necessary for API level >= 33 (TIRAMISU)
+ if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+ if (ContextCompat.checkSelfPermission(this, Manifest.permission.POST_NOTIFICATIONS) ==
+ PackageManager.PERMISSION_GRANTED) {
+ // All set. We can post notifications
+ } else if (shouldShowRequestPermissionRationale(Manifest.permission.POST_NOTIFICATIONS)) {
+ // Display an educational UI explaining to the user the features that will be enabled
+ // by them granting the POST_NOTIFICATION permission. This UI should provide the user
+ // "OK" and "No thanks" buttons. If the user selects "OK," directly request the permission.
+ // If the user selects "No thanks," allow the user to continue without notifications.
+ } else {
+ // Directly ask for the permission
+ requestPermissionLauncher.launch(Manifest.permission.POST_NOTIFICATIONS);
+ }
+ }
+ }
 }

appdistribution/app/src/main/java/com/google/firebase/appdistributionquickstart/kotlin/KotlinMainActivity.kt

@@ -1,9 +1,16 @@
 package com.google.firebase.appdistributionquickstart.kotlin
 
+import android.Manifest
+import android.content.pm.PackageManager
+import android.os.Build
 import android.os.Bundle
+import android.widget.Toast
+import androidx.activity.result.contract.ActivityResultContracts
 import androidx.appcompat.app.AppCompatActivity
+import androidx.core.content.ContextCompat
 import com.google.firebase.appdistribution.FirebaseAppDistribution
 import com.google.firebase.appdistribution.FirebaseAppDistributionException
+import com.google.firebase.appdistribution.InterruptionLevel
 import com.google.firebase.appdistribution.ktx.appDistribution
 import com.google.firebase.appdistributionquickstart.databinding.ActivityMainBinding
 import com.google.firebase.ktx.Firebase
@@ -12,12 +19,38 @@ class KotlinMainActivity : AppCompatActivity() {
 
  private lateinit var firebaseAppDistribution: FirebaseAppDistribution
 
+ // Declare the launcher at the top of your Activity/Fragment:
+ private val requestPermissionLauncher = registerForActivityResult(
+ ActivityResultContracts.RequestPermission()
+ ) { isGranted: Boolean ->
+ if (!isGranted) {
+ Toast.makeText(
+ this@KotlinMainActivity,
+ "The app won't display feedback notifications because the notification permission was denied",
+ Toast.LENGTH_LONG
+ ).show()
+ }
+ }
+
  override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  val binding = ActivityMainBinding.inflate(layoutInflater)
  setContentView(binding.root)
 
  firebaseAppDistribution = Firebase.appDistribution
+
+ binding.btShowNotification.setOnClickListener {
+ firebaseAppDistribution.showFeedbackNotification(
+ "Data Collection Notice",
+ InterruptionLevel.HIGH
+ )
+ }
+
+ binding.btSendFeedback.setOnClickListener {
+ firebaseAppDistribution.startFeedback("Thanks for sharing your feedback with us")
+ }
+
+ askNotificationPermission()
  }
 
  override fun onResume() {
@@ -34,7 +67,30 @@ class KotlinMainActivity : AppCompatActivity() {
  }
  }
 
+ override fun onDestroy() {
+ super.onDestroy()
+ // Hide the notification once this activity is destroyed
+ firebaseAppDistribution.cancelFeedbackNotification()
+ }
 
+ private fun askNotificationPermission() {
+ // This is only necessary for API level >= 33 (TIRAMISU)
+ if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+ if (ContextCompat.checkSelfPermission(this, Manifest.permission.POST_NOTIFICATIONS) ==
+ PackageManager.PERMISSION_GRANTED
+ ) {
+ // All set. We can post notifications
+ } else if (shouldShowRequestPermissionRationale(Manifest.permission.POST_NOTIFICATIONS)) {
+ // Display an educational UI explaining to the user the features that will be enabled
+ // by them granting the POST_NOTIFICATION permission. This UI should provide the user
+ // "OK" and "No thanks" buttons. If the user selects "OK," directly request the permission.
+ // If the user selects "No thanks," allow the user to continue without notifications.
+ } else {
+ // Directly ask for the permission
+ requestPermissionLauncher.launch(Manifest.permission.POST_NOTIFICATIONS)
+ }
+ }
+ }
 
  companion object {
 

appdistribution/app/src/main/res/layout/activity_main.xml

@@ -5,7 +5,7 @@
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  android:padding="16dp"
- tools:context=".MainActivity">
+ tools:context=".kotlin.KotlinMainActivity">
 
  <ImageView
  android:id="@+id/imageView"
@@ -34,4 +34,26 @@
  app:layout_constraintRight_toRightOf="parent"
  app:layout_constraintTop_toBottomOf="@+id/imageView" />
 
+ <Button
+ android:id="@+id/btShowNotification"
+ android:layout_width="0dp"
+ android:layout_height="wrap_content"
+ android:layout_marginStart="16dp"
+ android:layout_marginTop="24dp"
+ android:layout_marginEnd="16dp"
+ android:text="@string/show_feedback_notification"
+ app:layout_constraintEnd_toEndOf="@+id/textView"
+ app:layout_constraintStart_toStartOf="@+id/textView"
+ app:layout_constraintTop_toBottomOf="@+id/textView" />
+
+ <Button
+ android:id="@+id/btSendFeedback"
+ android:layout_width="0dp"
+ android:layout_height="wrap_content"
+ android:layout_marginTop="16dp"
+ android:text="@string/send_feedback"
+ app:layout_constraintEnd_toEndOf="@+id/btShowNotification"
+ app:layout_constraintStart_toStartOf="@+id/btShowNotification"
+ app:layout_constraintTop_toBottomOf="@+id/btShowNotification" />
+
 </androidx.constraintlayout.widget.ConstraintLayout>

appdistribution/app/src/main/res/values/strings.xml

@@ -3,4 +3,6 @@
  <string name="textview_text">Welcome to the Firebase App Distribution Quickstart app. Press the button to trigger an analytics event!</string>
 
  <string name="installation_id_fmt">Firebase Installation ID: %s</string>
+ <string name="show_feedback_notification">Show Feedback Notification</string>
+ <string name="send_feedback">Send Feedback</string>
 </resources>