Add provider functions

Author: kmadsen

libnavui-androidauto/src/main/java/com/mapbox/androidauto/navigation/audioguidance/AppAudioGuidanceUi.kt

@@ -7,7 +7,6 @@ import androidx.lifecycle.Lifecycle
 import androidx.lifecycle.LifecycleOwner
 import androidx.lifecycle.lifecycleScope
 import androidx.lifecycle.repeatOnLifecycle
-import com.mapbox.androidauto.MapboxCarApp
 import com.mapbox.navigation.ui.voice.api.MapboxAudioGuidance
 import com.mapbox.navigation.ui.voice.api.MapboxAudioGuidanceState
 import com.mapbox.navigation.ui.voice.view.MapboxSoundButton

libnavui-androidauto/src/main/java/com/mapbox/androidauto/navigation/audioguidance/CarAudioGuidanceUi.kt

@@ -8,7 +8,6 @@ import androidx.core.graphics.drawable.IconCompat
 import androidx.lifecycle.Lifecycle
 import androidx.lifecycle.coroutineScope
 import androidx.lifecycle.repeatOnLifecycle
-import com.mapbox.androidauto.MapboxCarApp
 import com.mapbox.androidauto.R
 import com.mapbox.androidauto.car.MainActionStrip
 import com.mapbox.androidauto.car.action.MapboxActionProvider

libnavui-voice/api/current.txt

@@ -22,13 +22,20 @@ package com.mapbox.navigation.ui.voice.api {
   }
 
   public final class MapboxAudioGuidance implements com.mapbox.navigation.core.lifecycle.MapboxNavigationObserver {
-    ctor public MapboxAudioGuidance();
+    method public static com.mapbox.navigation.ui.voice.api.MapboxAudioGuidance create();
+    method public static com.mapbox.navigation.ui.voice.api.MapboxAudioGuidance getInstance();
     method public void mute();
     method public void onAttached(com.mapbox.navigation.core.MapboxNavigation mapboxNavigation);
     method public void onDetached(com.mapbox.navigation.core.MapboxNavigation mapboxNavigation);
     method public kotlinx.coroutines.flow.StateFlow<com.mapbox.navigation.ui.voice.api.MapboxAudioGuidanceState> stateFlow();
     method public void toggle();
     method public void unMute();
+    field public static final com.mapbox.navigation.ui.voice.api.MapboxAudioGuidance.Companion Companion;
+  }
+
+  public static final class MapboxAudioGuidance.Companion {
+    method public com.mapbox.navigation.ui.voice.api.MapboxAudioGuidance create();
+    method public com.mapbox.navigation.ui.voice.api.MapboxAudioGuidance getInstance();
   }
 
   public final class MapboxAudioGuidanceState {

libnavui-voice/src/main/java/com/mapbox/navigation/ui/voice/api/MapboxAudioGuidance.kt

@@ -200,9 +200,19 @@ internal constructor(
             booleanDataStoreKey("audio_guidance_muted", false)
         private const val DEFAULT_DATA_STORE_NAME = "mapbox_navigation_preferences"
 
+        /**
+         * Construct an instance without registering to [MapboxNavigationApp].
+         */
+        @JvmStatic
+        fun create() = MapboxAudioGuidance(MapboxAudioGuidanceServices(), Dispatchers.Main)
+
+        /**
+         * Get the registered instance or create one and register it to [MapboxNavigationApp].
+         */
+        @JvmStatic
         fun getInstance(): MapboxAudioGuidance = MapboxNavigationApp
             .getObservers(MapboxAudioGuidance::class)
-            .firstOrNull() ?: MapboxAudioGuidance(MapboxAudioGuidanceServices(), Dispatchers.Main)
+            .firstOrNull() ?: create()
             .also { MapboxNavigationApp.registerObserver(it) }
     }
 }

qa-test-app/src/main/java/com/mapbox/navigation/qa_test_app/testing/JavaInterfaceChecker.java

@@ -0,0 +1,23 @@
+package com.mapbox.navigation.qa_test_app.testing;
+
+import com.mapbox.navigation.core.lifecycle.MapboxNavigationApp;
+import com.mapbox.navigation.ui.voice.api.MapboxAudioGuidance;
+
+import kotlinx.coroutines.CoroutineScope;
+
+class JavaInterfaceChecker {
+
+  void MapboxAudioGuidance(
+          CoroutineScope coroutineScope
+  ) {
+    MapboxAudioGuidance sut = MapboxAudioGuidance.getInstance();
+    sut.mute();
+    sut.unMute();
+    sut.toggle();
+    MapboxNavigationApp.registerObserver(sut);
+    MapboxNavigationApp.unregisterObserver(sut);
+    JavaFlow.collect(sut.stateFlow(), coroutineScope, (enabled) -> {
+      // observe state
+    });
+  }
+}