feat(perf-ktx): add trace(name, block) extension function

Author: thatfiredev

firebase-perf/ktx/api.txt

@@ -5,6 +5,7 @@ package com.google.firebase.perf.ktx {
     method @NonNull public static com.google.firebase.perf.FirebasePerformance getPerformance(@NonNull com.google.firebase.ktx.Firebase);
     method public static inline void trace(@NonNull com.google.firebase.perf.metrics.HttpMetric, @NonNull kotlin.jvm.functions.Function1<? super com.google.firebase.perf.metrics.HttpMetric,kotlin.Unit> block);
     method public static inline <T> T trace(@NonNull com.google.firebase.perf.metrics.Trace, @NonNull kotlin.jvm.functions.Function1<? super com.google.firebase.perf.metrics.Trace,? extends T> block);
+    method public static inline <T> T trace(@NonNull String name, @NonNull kotlin.jvm.functions.Function1<? super com.google.firebase.perf.metrics.Trace,? extends T> block);
   }
 
 }

firebase-perf/ktx/src/main/kotlin/com/google/firebase/perf/ktx/Performance.kt

@@ -48,6 +48,12 @@ inline fun <T> Trace.trace(block: Trace.() -> T): T {
     }
 }
 
+/**
+ * Creates a [Trace] object with given [name] and measures the time it takes to
+ * run the [block] wrapped by calls to [start] and [stop].
+ */
+inline fun <T> trace(name: String, block: Trace.() -> T): T = Trace.create(name).trace(block)
+
 internal const val LIBRARY_NAME: String = "fire-perf-ktx"
 
 /** @suppress */