added first level of deep linking to demo-app

build.gradle

@@ -3,7 +3,7 @@ buildscript {
         jcenter()
     }
     dependencies {
-        classpath 'com.android.tools.build:gradle:2.2.0'
+        classpath 'com.android.tools.build:gradle:2.2.2'
     }
 }
 

demo/src/main/AndroidManifest.xml

@@ -25,6 +25,18 @@
                 <action android:name="android.intent.action.MAIN"/>
                 <category android:name="android.intent.category.LAUNCHER"/>
             </intent-filter>
+
+           <intent-filter>
+                <action android:name="android.intent.action.VIEW" />
+
+                <category android:name="android.intent.category.DEFAULT" />
+                <category android:name="android.intent.category.BROWSABLE" />
+
+                <data
+                    android:host="bluelinelabs.com"
+                    android:pathPrefix="/demo"
+                    android:scheme="http" />
+            </intent-filter>
         </activity>
 
     </application>

demo/src/main/java/com/bluelinelabs/conductor/demo/MainActivity.java

@@ -1,8 +1,11 @@
 package com.bluelinelabs.conductor.demo;
 
+import android.content.Intent;
+import android.net.Uri;
 import android.os.Bundle;
 import android.support.v7.app.AppCompatActivity;
 import android.support.v7.widget.Toolbar;
+import android.util.Log;
 import android.view.ViewGroup;
 
 import com.bluelinelabs.conductor.Conductor;
@@ -19,6 +22,8 @@ public final class MainActivity extends AppCompatActivity implements ActionBarPr
     @BindView(R.id.controller_container) ViewGroup container;
 
     private Router router;
+    private static final String TAG = MainActivity.class.getSimpleName();
+    private static final String PATH_PREFIX = "/demo/";
 
     @Override
     protected void onCreate(Bundle savedInstanceState) {
@@ -31,7 +36,49 @@ protected void onCreate(Bundle savedInstanceState) {
 
         router = Conductor.attachRouter(this, container, savedInstanceState);
         if (!router.hasRootController()) {
-            router.setRoot(RouterTransaction.with(new HomeController()));
+
+            HomeController homeController = new HomeController();
+            router.setRoot(RouterTransaction.with(homeController));
+            handleIntentDataUri(homeController);
+        }
+    }
+
+    /**
+     * will handle the data URI of the intent and when it is valid, navigate to the matching
+     * controller
+     *
+     * EXAMPLE: to test this via command line
+     * <code>
+     * <pre>
+     * adb shell am start -W -a android.intent.action.VIEW
+     *   -d "http://bluelinelabs.com/demo/NAVIGATION"
+     *   com.bluelinelabs.conductor.demo
+     * </pre>
+     * </code>
+     *
+     * @param homeController the {@link HomeController} will handle the actual navigation
+     */
+    private void handleIntentDataUri(HomeController homeController) {
+        final Intent intent = getIntent();
+        Uri intentDataUri = intent.getData();
+        if (intentDataUri == null || intentDataUri.getPath() == null) return;
+
+        String path = intentDataUri.getPath();
+        if (!path.startsWith(PATH_PREFIX)) {
+            Log.w(TAG, "unexpected path: " + intentDataUri.getPath());
+            return;
+        }
+
+        /* Example: http://bluelinelabs.com/demo/MASTER_DETAIL?item=1
+
+           intentDataUri.getPath()  = /demo/MASTER_DETAIL
+           intentDataUri.getQuery() = item=1
+        */
+
+        // skip the expected prefix, so that the remaining part is e.g. MASTER_DETAIL
+        String navigationPath = path.substring(PATH_PREFIX.length());
+        if (!homeController.navigateTo(navigationPath)) {
+            Log.w(TAG, "cannot navigate to: " + intentDataUri.getPath());
         }
     }
 

demo/src/main/java/com/bluelinelabs/conductor/demo/controllers/HomeController.java

@@ -130,6 +130,23 @@ protected String getTitle() {
         return "Conductor Demos";
     }
 
+    /**
+     * will navigate to the controller represented by the @{code enumIdParam} parameter.
+     *
+     * @param enumIdParam can be any Id of the HomeDemoModel enumerations (case does not matter)
+     * @return @{code false} when we did not find a matching controller, @{code true} otherwise
+     */
+    public boolean navigateTo(@NonNull String enumIdParam) {
+        String enumIdentifier = enumIdParam.toUpperCase();
+        try {
+            HomeDemoModel hdm = HomeDemoModel.valueOf(enumIdentifier);
+            onModelRowClick(hdm);
+            return true;
+        } catch (IllegalArgumentException e) {
+            return false;
+        }
+    }
+
     void onModelRowClick(HomeDemoModel model) {
         switch (model) {
             case NAVIGATION: