docs: Added section describing Launcher Shortcuts.
The "Android N for Developers" page within the Android N preview
documentation now includes a section discussing the features and
workflow associated with Launcher Shortcuts.
Bug: 27753707
Change-Id: I43c17960f08a3c2a9e123ca5b5c411381afdfab8
diff --git a/docs/html/preview/api-overview.jd b/docs/html/preview/api-overview.jd
index 478f068..c2421eb 100644
--- a/docs/html/preview/api-overview.jd
+++ b/docs/html/preview/api-overview.jd
@@ -34,6 +34,7 @@
<li><a href="#default_trusted_ca">Default Trusted CA</a></li>
<li><a href="apk_signature_v2">APK signature scheme v2</a></li>
<li><a href="#scoped_directory_access">Scoped directory access</a></li>
+ <li><a href="#launcher_shortcuts">Launcher shortcuts</a></li>
</ol>
</div>
</div>
@@ -696,8 +697,57 @@
<a href="{@docRoot}preview/features/scoped-folder-access.html">Scoped
Directory Access</a> developer documentation.</p>
+<h2 id="launcher_shortcuts">
+ Launcher shortcuts
+</h2>
+<p>
+ Android N allows apps to define action-specific shortcuts which can be
+ displayed in the launcher. These <em>launcher shortcuts</em> let your users
+ quickly start common or recommended tasks within your app. Each shortcut
+ contains an <a href=
+ "{@docRoot}guide/components/intents-filters.html">intent</a>, which links the
+ shortcut to a specific action in your app. Examples of these actions include:
+</p>
+<ul>
+ <li>Navigating users to a particular location in a mapping app.
+ </li>
+ <li>Sending messages to a friend in a communication app.
+ </li>
+ <li>Playing the next episode of a TV show in a media app.
+ </li>
+ <li>Loading the last save point in a gaming app.
+ </li>
+</ul>
+
+<p>
+ Your app can create up to five <em>dynamic shortcuts</em>. When users perform
+ a gesture over your app's launcher icon, these shortcuts appear. By dragging
+ the shortcuts onto the launcher, users can make persistent copies of the
+ shortcuts, called <em>pinned shortcuts</em>. Users can create an unlimited
+ number of pinned shortcuts for each app.
+</p>
+
+<p class="note">
+ <strong>Note:</strong> Although other apps can't access your shortcut data,
+ the launcher <strong>does</strong> have access to this data. Therefore, the
+ shortcuts you create should conceal sensitive user information.
+</p>
+
+<p>
+ You can use this command to view your app's shortcuts:
+</p>
+
+<pre class="no-pretty-print">
+$ adb shell dumpsys shortcut
+</pre>
+<p>
+ To update all shortcuts and to delete dynamic shortcuts, use the appropriate
+ methods that the Launcher Shortcut API provides. For more details about this
+ API, see <code>android.content.pm.ShortcutManager</code> in the downloadable
+ <a href="{@docRoot}preview/setup-sdk.html#docs-dl">API Reference</a>.
+</p>