feat(android): Improve SentryNavEffect by consolidating back stack entry mapping (JAVA-274) (#6197)

Commit improves the yet-to-be-released SentryNavEffect by replacing separate route name and argument extractors with a single BackStackEntryMapper. Doing so lets us spare users from having to create three giant `when` statements mapping all nav entries in their entire app (two for us and one for Nav3's entryProvider). After this commit, users only have to create two. (Future work will allow them to create just one via a forthcoming Sentry entryProvider wrapper.)

Commit also uses the term "back stack entry" rather than "back stack route" throughout to avoid developer confusion, given Google's use of "route" to mean (essentially) a navigation destination. By contrast, we need a term that refers solely to an element in the host app's back stack. (In general, Nav3 is careful to distinguish between nav destinations and back stack entries, as a destination may be composed from multiple entries in a back stack.)

Author: 0xadam-brown

sentry-android-navigation3/api/sentry-android-navigation3.api

@@ -1,3 +1,7 @@
+public abstract interface class io/sentry/compose/navigation3/BackStackEntryMapper {
+	public abstract fun map (Ljava/lang/Object;)Lio/sentry/compose/navigation3/SentryBackStackEntry;
+}
+
 public final class io/sentry/compose/navigation3/BuildConfig {
 	public static final field BUILD_TYPE Ljava/lang/String;
 	public static final field DEBUG Z
@@ -6,16 +10,19 @@ public final class io/sentry/compose/navigation3/BuildConfig {
 	public fun <init> ()V
 }
 
-public abstract interface class io/sentry/compose/navigation3/RouteArgumentsExtractor {
-	public abstract fun extract (Ljava/lang/Object;)Ljava/util/Map;
-}
-
-public abstract interface class io/sentry/compose/navigation3/RouteNameExtractor {
-	public abstract fun extract (Ljava/lang/Object;)Ljava/lang/String;
+public final class io/sentry/compose/navigation3/SentryBackStackEntry {
+	public static final field $stable I
+	public fun <init> (Ljava/lang/String;Ljava/util/Map;)V
+	public synthetic fun <init> (Ljava/lang/String;Ljava/util/Map;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
+	public fun equals (Ljava/lang/Object;)Z
+	public final fun getArguments ()Ljava/util/Map;
+	public final fun getName ()Ljava/lang/String;
+	public fun hashCode ()I
+	public fun toString ()Ljava/lang/String;
 }
 
 public final class io/sentry/compose/navigation3/SentryNavEffectKt {
-	public static final fun SentryNavEffect (Ljava/util/List;Lio/sentry/compose/navigation3/RouteNameExtractor;Lio/sentry/compose/navigation3/RouteArgumentsExtractor;Lio/sentry/compose/navigation3/SentryNavOptions;Landroidx/compose/runtime/Composer;II)V
+	public static final fun SentryNavEffect (Ljava/util/List;Lio/sentry/compose/navigation3/BackStackEntryMapper;Lio/sentry/compose/navigation3/SentryNavOptions;Landroidx/compose/runtime/Composer;II)V
 }
 
 public final class io/sentry/compose/navigation3/SentryNavOptions {