Add a kotlin method for recording an exception with custom keys (#6546)

Author: tejasd

firebase-crashlytics/api.txt

@@ -39,11 +39,12 @@ package com.google.firebase.crashlytics {
 
   public final class FirebaseCrashlyticsKt {
     method @NonNull public static com.google.firebase.crashlytics.FirebaseCrashlytics getCrashlytics(@NonNull com.google.firebase.Firebase);
+    method public static void recordException(@NonNull com.google.firebase.crashlytics.FirebaseCrashlytics, @NonNull Throwable throwable, @NonNull kotlin.jvm.functions.Function1<? super com.google.firebase.crashlytics.KeyValueBuilder,kotlin.Unit> init);
     method public static void setCustomKeys(@NonNull com.google.firebase.crashlytics.FirebaseCrashlytics, @NonNull kotlin.jvm.functions.Function1<? super com.google.firebase.crashlytics.KeyValueBuilder,kotlin.Unit> init);
   }
 
   public final class KeyValueBuilder {
-    ctor public KeyValueBuilder(@NonNull com.google.firebase.crashlytics.FirebaseCrashlytics crashlytics);
+    ctor @Deprecated public KeyValueBuilder(@NonNull com.google.firebase.crashlytics.FirebaseCrashlytics crashlytics);
     method public void key(@NonNull String key, boolean value);
     method public void key(@NonNull String key, double value);
     method public void key(@NonNull String key, float value);

firebase-crashlytics/src/androidTest/java/com/google/firebase/crashlytics/CrashlyticsTests.kt

@@ -62,21 +62,36 @@ class CrashlyticsTests {
   @Test
   fun keyValueBuilder() {
     val keyValueBuilder = KeyValueBuilder()
-    keyValueBuilder.key("hello", "world")
-    keyValueBuilder.key("hello2", 23)
-    keyValueBuilder.key("hello3", 0.1)
+    keyValueBuilder.key("string", "world")
+    keyValueBuilder.key("int", Int.MAX_VALUE)
+    keyValueBuilder.key("float", Float.MAX_VALUE)
+    keyValueBuilder.key("boolean", true)
+    keyValueBuilder.key("double", Double.MAX_VALUE)
+    keyValueBuilder.key("long", Long.MAX_VALUE)
 
     val result: Map<String, String> = keyValueBuilder.build().keysAndValues
 
-    assertThat(result).containsExactly("hello", "world", "hello2", "23", "hello3", "0.1")
+    val expectedKeys =
+      mapOf(
+        "string" to "world",
+        "int" to "${Int.MAX_VALUE}",
+        "float" to "${Float.MAX_VALUE}",
+        "boolean" to "${true}",
+        "double" to "${Double.MAX_VALUE}",
+        "long" to "${Long.MAX_VALUE}"
+      )
+    assertThat(result).isEqualTo(expectedKeys)
   }
 
   @Test
   fun keyValueBuilder_withCrashlyticsInstance() {
     @Suppress("DEPRECATION") val keyValueBuilder = KeyValueBuilder(Firebase.crashlytics)
-    keyValueBuilder.key("hello", "world")
-    keyValueBuilder.key("hello2", 23)
-    keyValueBuilder.key("hello3", 0.1)
+    keyValueBuilder.key("string", "world")
+    keyValueBuilder.key("int", Int.MAX_VALUE)
+    keyValueBuilder.key("float", Float.MAX_VALUE)
+    keyValueBuilder.key("boolean", true)
+    keyValueBuilder.key("double", Double.MAX_VALUE)
+    keyValueBuilder.key("long", Long.MAX_VALUE)
 
     val result: Map<String, String> = keyValueBuilder.build().keysAndValues
 

firebase-crashlytics/src/main/java/com/google/firebase/crashlytics/FirebaseCrashlytics.kt

@@ -30,6 +30,10 @@ val Firebase.crashlytics: FirebaseCrashlytics
 fun FirebaseCrashlytics.setCustomKeys(init: KeyValueBuilder.() -> Unit) =
   setCustomKeys(KeyValueBuilder().apply(init).build())
 
+/** Records a non-fatal report to send to Crashlytics with additional custom keys */
+fun FirebaseCrashlytics.recordException(throwable: Throwable, init: KeyValueBuilder.() -> Unit) =
+  recordException(throwable, KeyValueBuilder().apply(init).build())
+
 /** @suppress */
 @Keep
 internal class FirebaseCrashlyticsKtxRegistrar : ComponentRegistrar {

firebase-crashlytics/src/main/java/com/google/firebase/crashlytics/KeyValueBuilder.kt

@@ -16,7 +16,7 @@
 
 package com.google.firebase.crashlytics
 
-/** Helper class to enable convenient syntax in [setCustomKeys] */
+/** Helper class to enable convenient syntax in [setCustomKeys] and [recordException] */
 class KeyValueBuilder
 private constructor(
   private val crashlytics: FirebaseCrashlytics?,