feat: Add Home deep link intent

Support deep linking to the default tab of the application, which is
useful for generic promotions found on web pages.

Author: dcalhoun

WordPress/src/jetpack/AndroidManifest.xml

@@ -37,6 +37,9 @@
                 <data
                     android:host="notifications"
                     android:scheme="jetpack" />
+                <data
+                    android:host="home"
+                    android:scheme="jetpack" />
             </intent-filter>
         </activity>
 

WordPress/src/main/AndroidManifest.xml

@@ -400,6 +400,9 @@
                 <data
                     android:host="notifications"
                     android:scheme="wordpress" />
+                <data
+                    android:host="home"
+                    android:scheme="wordpress" />
             </intent-filter>
 
             <intent-filter android:autoVerify="true">

WordPress/src/main/java/org/wordpress/android/ui/deeplinks/DeepLinkNavigator.kt

@@ -8,6 +8,7 @@ import org.wordpress.android.ui.deeplinks.DeepLinkNavigator.NavigateAction.Login
 import org.wordpress.android.ui.deeplinks.DeepLinkNavigator.NavigateAction.OpenEditor
 import org.wordpress.android.ui.deeplinks.DeepLinkNavigator.NavigateAction.OpenEditorForPost
 import org.wordpress.android.ui.deeplinks.DeepLinkNavigator.NavigateAction.OpenEditorForSite
+import org.wordpress.android.ui.deeplinks.DeepLinkNavigator.NavigateAction.OpenHome
 import org.wordpress.android.ui.deeplinks.DeepLinkNavigator.NavigateAction.OpenInBrowser
 import org.wordpress.android.ui.deeplinks.DeepLinkNavigator.NavigateAction.OpenInReader
 import org.wordpress.android.ui.deeplinks.DeepLinkNavigator.NavigateAction.OpenNotifications
@@ -74,6 +75,7 @@ class DeepLinkNavigator
             is OpenPagesForSite -> ActivityLauncher.viewPagesInNewStack(activity, navigateAction.site)
             OpenPages -> ActivityLauncher.viewPagesInNewStack(activity)
             is OpenQRCodeAuthFlow -> ActivityLauncher.startQRCodeAuthFlowInNewStack(activity, navigateAction.uri)
+            OpenHome -> ActivityLauncher.viewMySiteInNewStack(activity)
         }
         if (navigateAction != LoginForResult) {
             activity.finish()
@@ -101,5 +103,6 @@ class DeepLinkNavigator
         data class OpenPagesForSite(val site: SiteModel) : NavigateAction()
         object OpenPages : NavigateAction()
         data class OpenQRCodeAuthFlow(val uri: String) : NavigateAction()
+        object OpenHome : NavigateAction()
     }
 }

WordPress/src/main/java/org/wordpress/android/ui/deeplinks/handlers/DeepLinkHandlers.kt

@@ -15,7 +15,8 @@ class DeepLinkHandlers
     readerLinkHandler: ReaderLinkHandler,
     pagesLinkHandler: PagesLinkHandler,
     notificationsLinkHandler: NotificationsLinkHandler,
-    qrCodeAuthLinkHandler: QRCodeAuthLinkHandler
+    qrCodeAuthLinkHandler: QRCodeAuthLinkHandler,
+    homeLinkHandler: HomeLinkHandler
 ) {
     private val handlers = listOf(
             editorLinkHandler,
@@ -24,7 +25,8 @@ class DeepLinkHandlers
             readerLinkHandler,
             pagesLinkHandler,
             notificationsLinkHandler,
-            qrCodeAuthLinkHandler
+            qrCodeAuthLinkHandler,
+            homeLinkHandler
     )
 
     private val _toast by lazy {

WordPress/src/main/java/org/wordpress/android/ui/deeplinks/handlers/HomeLinkHandler.kt

@@ -0,0 +1,30 @@
+package org.wordpress.android.ui.deeplinks.handlers
+
+import org.wordpress.android.ui.deeplinks.DeepLinkNavigator.NavigateAction
+import org.wordpress.android.ui.deeplinks.DeepLinkNavigator.NavigateAction.OpenHome
+import org.wordpress.android.util.UriWrapper
+import javax.inject.Inject
+
+class HomeLinkHandler
+@Inject constructor() : DeepLinkHandler {
+    /**
+     * Returns true if the URI looks like `wordpress://home`
+     */
+    override fun shouldHandleUrl(uri: UriWrapper): Boolean {
+        return uri.host == HOME_PATH
+    }
+
+    override fun buildNavigateAction(uri: UriWrapper): NavigateAction {
+        return OpenHome
+    }
+
+    override fun stripUrl(uri: UriWrapper): String {
+        return buildString {
+            append(HOME_PATH)
+        }
+    }
+
+    companion object {
+        private const val HOME_PATH = "home"
+    }
+}

WordPress/src/test/java/org/wordpress/android/ui/deeplinks/handlers/DeepLinkHandlersTest.kt

@@ -20,6 +20,7 @@ class DeepLinkHandlersTest : BaseUnitTest() {
     @Mock lateinit var pagesLinkHandler: PagesLinkHandler
     @Mock lateinit var notificationsLinkHandler: NotificationsLinkHandler
     @Mock lateinit var qrCodeAuthLinkHandler: QRCodeAuthLinkHandler
+    @Mock lateinit var homeLinkHandler: HomeLinkHandler
     @Mock lateinit var uri: UriWrapper
     private lateinit var deepLinkHandlers: DeepLinkHandlers
     private lateinit var handlers: List<DeepLinkHandler>
@@ -33,7 +34,8 @@ class DeepLinkHandlersTest : BaseUnitTest() {
                 readerLinkHandler,
                 pagesLinkHandler,
                 notificationsLinkHandler,
-                qrCodeAuthLinkHandler
+                qrCodeAuthLinkHandler,
+                homeLinkHandler
         )
         initDeepLinkHandlers()
     }
@@ -46,7 +48,8 @@ class DeepLinkHandlersTest : BaseUnitTest() {
                 readerLinkHandler,
                 pagesLinkHandler,
                 notificationsLinkHandler,
-                qrCodeAuthLinkHandler
+                qrCodeAuthLinkHandler,
+                homeLinkHandler
         )
     }
 

WordPress/src/test/java/org/wordpress/android/ui/deeplinks/handlers/HomeLinkHandlerTest.kt

@@ -0,0 +1,31 @@
+package org.wordpress.android.ui.deeplinks.handlers
+
+import org.assertj.core.api.Assertions.assertThat
+import org.junit.Before
+import org.junit.Test
+import org.junit.runner.RunWith
+import org.mockito.Mock
+import org.mockito.junit.MockitoJUnitRunner
+import org.wordpress.android.fluxc.model.SiteModel
+import org.wordpress.android.ui.deeplinks.DeepLinkNavigator.NavigateAction
+import org.wordpress.android.ui.deeplinks.buildUri
+
+@RunWith(MockitoJUnitRunner::class)
+class HomeLinkHandlerTest {
+    @Mock lateinit var site: SiteModel
+    private lateinit var homeLinkHandler: HomeLinkHandler
+
+    @Before
+    fun setUp() {
+        homeLinkHandler = HomeLinkHandler()
+    }
+
+    @Test
+    fun `opens home screen from app link`() {
+        val uri = buildUri(host = "home")
+
+        val navigateAction = homeLinkHandler.buildNavigateAction(uri)
+
+        assertThat(navigateAction).isEqualTo(NavigateAction.OpenHome)
+    }
+}