Update AA example to handle init failure (#2389)

Author: kiryldz

android-auto-app/build.gradle.kts

@@ -60,7 +60,8 @@ dependencies {
 
   // Please review the compatibility guide. This app is showcasing the latest features.
   // https://github.com/mapbox/mapbox-maps-android/tree/main/extension-androidauto#compatibility-with-maps-sdk-v10
-  implementation("com.mapbox.maps:android:10.10.0-beta.1")
+  implementation("com.mapbox.maps:android:10.16.6")
+  implementation("androidx.startup:startup-runtime:1.1.1")
 
   implementation(Dependencies.kotlin)
   implementation(Dependencies.androidxAppCompat)

android-auto-app/src/main/java/com/mapbox/maps/testapp/auto/car/MapSession.kt

@@ -7,39 +7,58 @@ import android.content.res.Configuration
 import androidx.car.app.Screen
 import androidx.car.app.ScreenManager
 import androidx.car.app.Session
+import com.mapbox.common.BaseMapboxInitializer
+import com.mapbox.maps.ContextMode
 import com.mapbox.maps.MapInitOptions
 import com.mapbox.maps.MapboxExperimental
+import com.mapbox.maps.extension.androidauto.MapboxCarMapObserver
 import com.mapbox.maps.extension.androidauto.mapboxMapInstaller
+import com.mapbox.maps.loader.MapboxMapsInitializerImpl
 
 /**
  * Session class for the Mapbox Map sample app for Android Auto.
  */
-@OptIn(MapboxExperimental::class)
 class MapSession : Session() {
-
   private val carMapShowcase = CarMapShowcase()
-  private val mapboxCarMap = mapboxMapInstaller()
-    .onCreated(CarAnimationThreadController(), CarMapWidgets(), carMapShowcase)
-    .install { carContext ->
-      // Callback is triggered when the Session calls onCreate. This allows you to specify
-      // custom MapInitOptions.
-      MapInitOptions(carContext)
-    }
-
   override fun onCreateScreen(intent: Intent): Screen {
     // The onCreate is guaranteed to be called before onCreateScreen. You can pass the
     // mapboxCarMap to other screens. Each screen can register and unregister observers.
     // This allows you to scope behaviors to sessions, screens, or events.
-    val mapScreen = MapScreen(mapboxCarMap)
+
+    // Also we cover the use-case if native libraries could not yet be loaded and show
+    // RetryScreen in that case with UI to retry init on a button click
+    val screen = tryInit(carMapShowcase)
+      ?: RetryScreen(
+        carContext,
+        this,
+        carMapShowcase,
+        "Map not available"
+      )
 
     return if (carContext.checkSelfPermission(ACCESS_FINE_LOCATION) != PERMISSION_GRANTED) {
       carContext.getCarService(ScreenManager::class.java)
-        .push(mapScreen)
+        .push(screen)
       RequestPermissionScreen(carContext)
-    } else mapScreen
+    } else screen
   }
 
   override fun onCarConfigurationChanged(newConfiguration: Configuration) {
     carMapShowcase.loadMapStyle(carContext)
   }
+}
+@OptIn(MapboxExperimental::class)
+internal fun MapSession.tryInit(carMapShowcase: MapboxCarMapObserver): MapScreen? = try {
+  // if Mapbox was init before successful - this is no-op
+  BaseMapboxInitializer.init(MapboxMapsInitializerImpl::class.java)
+  val mapboxCarMap = mapboxMapInstaller()
+    .onCreated(CarAnimationThreadController(), CarMapWidgets(), carMapShowcase)
+    .install { carContext ->
+      val mapOptions = MapInitOptions(carContext).mapOptions.toBuilder()
+        .contextMode(ContextMode.SHARED)
+        .build()
+      MapInitOptions(carContext, mapOptions = mapOptions)
+    }
+  MapScreen(mapboxCarMap)
+} catch (e: Throwable) {
+  null
 }

android-auto-app/src/main/java/com/mapbox/maps/testapp/auto/car/RetryScreen.kt

@@ -0,0 +1,38 @@
+package com.mapbox.maps.testapp.auto.car
+
+import androidx.car.app.CarContext
+import androidx.car.app.Screen
+import androidx.car.app.ScreenManager
+import androidx.car.app.model.Action
+import androidx.car.app.model.CarColor
+import androidx.car.app.model.MessageTemplate
+import androidx.car.app.model.ParkedOnlyOnClickListener
+import androidx.car.app.model.Template
+
+/* Retry screen if the map failed to load. */
+class RetryScreen(
+  carContext: CarContext,
+  private val session: MapSession,
+  private val carMapShowcase: CarMapShowcase,
+  private val message: String
+) : Screen(carContext) {
+
+  override fun onGetTemplate(): Template {
+    val listener = ParkedOnlyOnClickListener.create {
+      val screen = session.tryInit(carMapShowcase)
+        ?: RetryScreen(carContext, session, carMapShowcase, "Map not yet loaded...")
+      carContext.getCarService(ScreenManager::class.java)
+        .push(screen)
+      finish()
+    }
+    val action = Action.Builder()
+      .setTitle("Retry loading the map")
+      .setBackgroundColor(CarColor.GREEN)
+      .setOnClickListener(listener)
+      .build()
+    return MessageTemplate.Builder(message)
+      .addAction(action)
+      .setHeaderAction(Action.BACK)
+      .build()
+  }
+}