From f5b210a81893fa345b20da11c9edd9e31caf0658 Mon Sep 17 00:00:00 2001
From: Kevin Hufnagle <khufnagle@google.com>
Date: Mon, 20 Mar 2017 21:39:04 -0700
Subject: Merge from oc-preview-docs-release: docs: Added note that
 INSTALL_SHORTCUT is implicit broadcast as of O.

The INSTALL_SHORTCUT broadcast is now a private, implicit broadcast,
so app developers should pin a shortcut themselves using the methods
in the ShortcutManager class on Android O and higher. Updated
manifest permission doc accordingly.

Test: make ds-docs
Bug: 36442658
Change-Id: I1777dfde691089485dc4e6b7cb8a9de0ee527298
Original-Change-Id: I0ef5595e2f08efbab6c28af5fa2f6b6c2295424c
---
 core/res/AndroidManifest.xml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/core/res/AndroidManifest.xml b/core/res/AndroidManifest.xml
index 794d4f8b78b9..93d55a7b7be0 100644
--- a/core/res/AndroidManifest.xml
+++ b/core/res/AndroidManifest.xml
@@ -1965,6 +1965,11 @@
     <eat-comment />
 
     <!-- Allows an application to install a shortcut in Launcher.
+         <p>In Android O (API level 26) and higher, the <code>INSTALL_SHORTCUT</code> broadcast no
+         longer has any effect on your app because it's a private, implicit
+         broadcast. Instead, you should create an app shortcut by using the
+         {@link android.content.pm.ShortcutManager#requestPinShortcut requestPinShortcut()}
+         method from the {@link android.content.pm.ShortcutManager} class.
          <p>Protection level: normal
     -->
     <permission android:name="com.android.launcher.permission.INSTALL_SHORTCUT"
-- 
cgit v1.2.3-59-g8ed1b