commit c25c4bb378a0f22a42d3dd7787b381543d42464c
author Sunny Goyal <sunnygoyal@google.com> Thu Feb 20 16:19:57 2020 -0800
committer Sunny Goyal <sunnygoyal@google.com> Mon Feb 24 15:16:08 2020 -0800
tree 524858fa80df525585c81b8149398156dbe8b01c
parent 27f83cdbcefd687632811996e25ece99f7e1ac69

Updating documentation for isDefaultApplicationIcon API

Bug: 149758817
Test: N/A
Change-Id: Iaa9b29f55087204f4af849a384cb6c9b01df4465

core/java/android/content/pm/PackageManager.java

diff --git a/core/java/android/content/pm/PackageManager.java b/core/java/android/content/pm/PackageManager.java
index f2ec938..fa751d3 100644
--- a/core/java/android/content/pm/PackageManager.java
+++ b/core/java/android/content/pm/PackageManager.java
@@ -7853,11 +7853,16 @@
     /**
      * Returns if the provided drawable represents the default activity icon provided by the system.
      *
-     * PackageManager provides a default icon for any package/activity if the app itself does not
-     * define one or if the system encountered any error when loading the icon.
+     * PackageManager silently returns a default application icon for any package/activity if the
+     * app itself does not define one or if the system encountered any error when loading the icon.
+     *
+     * Developers can use this to check implement app specific logic around retrying or caching.
      *
      * @return true if the drawable represents the default activity icon, false otherwise
      * @see #getDefaultActivityIcon()
+     * @see PackageItemInfo#loadDefaultIcon(PackageManager)
+     * @see #getActivityIcon
+     * @see LauncherActivityInfo#getIcon(int)
      */
     public boolean isDefaultApplicationIcon(@NonNull Drawable drawable) {
         int resId = drawable instanceof AdaptiveIconDrawable