Add deep linking page

src/_data/sidenav.yml

@@ -75,6 +75,12 @@
           permalink: /docs/development/ui/assets-and-images
         - title: Navigation & routing
           permalink: /docs/development/ui/navigation
+          children:
+            - title: Navigation in Flutter
+              permalink: /docs/development/ui/navigation
+              match-page-url-exactly: true
+            - title: Deep linking
+              permalink: /docs/development/ui/navigation/deep-linking
         - title: Animations
           permalink: /docs/development/ui/animations
           children:

src/docs/development/ui/navigation/deep-linking.md

@@ -0,0 +1,130 @@
+---
+title: Deep linking
+description: Navigate to routes when the app receives a new URL
+---
+
+{{site.alert.note}}
+  This feature is only available on the dev or master channel. To learn how to
+  switch channels, see [Switching Flutter channels][switching-channels].
+{{site.alert.end}}
+
+Flutter supports deep linking on iOS, Android, and web browsers in the dev
+channel. Opening a URL displays that screen in your app. With the following
+steps, you can launch and display routes by using named routes (either with the
+[`routes`][routes] parameter or [`onGenerateRoute`][onGenerateRoute]), or by
+using the [`Router`][Router] widget.
+
+{{site.alert.secondary}}
+  **Version note:** [Navigator 2.0][] is now called [`Router`][Router], which
+  allows you to declaratively set the displayed routes based on the app's
+  current state. This API is opt-in.
+{{site.alert.end}}
+
+If you're running the app in a web browser, there's no additional setup
+required. Route paths are handled in the same way as an iOS or Android deep
+link. By default, web apps read the deep link path from the url fragment
+using the pattern: `/#/path/to/app/screen`.
+
+To follow along, create a new Flutter project with [the `Router` widget
+sample][router-sample] in flutter/samples.
+
+## Enable deep linking on Android
+
+Add a metadata tag and [intent filter][] to `AndroidManifest.xml`
+inside the `<activity> `tag with the `".MainActivity"` name:
+
+```
+<!-- Deep linking -->
+<meta-data android:name="flutter_deeplinking_enabled" android:value="true" />
+<intent-filter android:autoVerify="true">
+    <action android:name="android.intent.action.VIEW" />
+    <category android:name="android.intent.category.DEFAULT" />
+    <category android:name="android.intent.category.BROWSABLE" />
+    <data android:scheme="http" android:host="flutterbooksample.com" />
+    <data android:scheme="https" />
+</intent-filter>
+```
+
+A full restart is required to apply these changes.
+
+## Test on Android emulator
+To test with an Android emulator, give the `adb` command an intent where the
+host name matches the name defined in `AndroidManifest.xml`:
+
+```
+adb shell am start -a android.intent.action.VIEW \
+    -c android.intent.category.BROWSABLE \
+    -d "http://flutterbooksample.com/book/1"
+```
+
+For more details, see the [Verify Android App Links][verify-android-links]
+documentation in the Android docs.
+
+## Enable deep linking on iOS
+Add two new keys to `Info.plist` in the ios/Runner directory:
+
+```
+<key>FlutterDeepLinkingEnabled</key>
+<true/>
+<key>CFBundleURLTypes</key>
+<array>
+    <dict>
+    <key>CFBundleTypeRole</key>
+    <string>Editor</string>
+    <key>CFBundleURLName</key>
+    <string>flutterbooksample.com</string>
+    <key>CFBundleURLSchemes</key>
+    <array>
+    <string>customscheme</string>
+    </array>
+    </dict>
+</array>
+```
+
+The `CFBundleURLName` is a unique URL used to distinguish your app from others
+that use the same scheme. The scheme (`customscheme://`)  can also be unique.
+
+A full restart is required to apply these changes.
+
+## Test on iOS simulator
+Use the `xcrun` command to test on the iOS Simulator:
+
+```
+xcrun simctl openurl booted customscheme://flutterbooksample.com/book/1 
+```
+
+## Migrating from plugin-based deep linking
+
+If you have written a plugin to handle deep links, as described in ["Deep Links
+and Flutter applications" on Medium][plugin-linking], it will continue to work
+until you opt-in to this behavior by adding `FlutterDeepLinkingEnabled` to
+`Info.plist` or `flutter_deeplinking_enabled` to `AndroidManifest.xml`,
+respectively.
+
+## Behavior
+
+The behavior varies slightly based on the platform and whether the app is
+launched and running.
+
+<div class="table-wrapper" markdown="1">
+| Platform / Scenario      | Using Navigator                                                     | Using Router                                                                                                                                                                                        |
+|--------------------------|---------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| iOS (not launched)       | App gets initialRoute ("/") and a short time after gets a pushRoute | App gets initialRoute ("/") and a short time after uses the RouteInformationParser to parse the route and call RouterDelegate.setNewRoutePath, which configures the Navigator with the corresponding Page. |
+| Android - (not launched) | App gets initialRoute containing the full route ("http:/deeplink/") | App gets initialRoute ("/deeplink") and passes it to the RouteInformationParser to parse the route and call RouterDelegate.setNewRoutePath, which configures the Navigator with the corresponding Pages.   |
+| iOS (launched)           | pushRoute is called                                                 | Path is parsed, and the Navigator is configured with a new set of Pages.                                                                                                                                   |
+| Android (launched)       | pushRoute is called                                                 | Path is parsed, and the Navigator is configured with a new set of Pages.                                                                                                                                   |
+{:.table.table-striped}
+</div>
+
+After upgrading to the [`Router`][Router] widget, your app has the ability to replace the
+current set of pages when a new deep link is opened while the app is running.
+
+[switching-channels]: /docs/development/tools/sdk/upgrading#switching-flutter-channels
+[routes]: https://api.flutter.dev/flutter/material/MaterialApp/routes.html
+[onGenerateRoute]: https://api.flutter.dev/flutter/material/MaterialApp/onGenerateRoute.html
+[Router]: https://api.flutter.dev/flutter/widgets/Router-class.html
+[Navigator 2.0]: https://medium.com/flutter/learning-flutters-new-navigation-and-routing-system-7c9068155ade
+[intent filter]: https://developer.android.com/guide/components/intents-filters
+[plugin-linking]: https://medium.com/flutter-community/deep-links-and-flutter-applications-how-to-handle-them-properly-8c9865af9283
+[verify-android-links]: https://developer.android.com/training/app-links/verify-site-associations
+[router-sample]: https://github.com/flutter/samples/blob/master/navigation_and_routing/lib/nav_2/router.dart