summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAndrew Solovay <asolovay@google.com>2014-07-15 22:13:45 +0000
committerAndroid (Google) Code Review <android-gerrit@google.com>2014-07-15 16:06:37 +0000
commit63477e67eba4e8f3d3c17c3774cd99d23db39456 (patch)
treeedd3588f0470d1b588f44e6a4b7d4c8918fac4d4
parentbf42978e14e352984eb5443687fccd5b15dc27a3 (diff)
parent5ae13354773911f2c1567332a846020ff93390e3 (diff)
downloadframeworks_base-63477e67eba4e8f3d3c17c3774cd99d23db39456.zip
frameworks_base-63477e67eba4e8f3d3c17c3774cd99d23db39456.tar.gz
frameworks_base-63477e67eba4e8f3d3c17c3774cd99d23db39456.tar.bz2
Merge "cherrypick from klp-docs docs: Corrected doc for getLaunchIntentForPackage(). Change-Id: I2eab0956eaedac71289e19a3618a3553908f8c38" into klp-modular-docs
-rw-r--r--core/java/android/content/pm/PackageManager.java22
1 files changed, 10 insertions, 12 deletions
diff --git a/core/java/android/content/pm/PackageManager.java b/core/java/android/content/pm/PackageManager.java
index ff88dd7..119ecb0 100644
--- a/core/java/android/content/pm/PackageManager.java
+++ b/core/java/android/content/pm/PackageManager.java
@@ -1460,21 +1460,19 @@ public abstract class PackageManager {
public abstract String[] canonicalToCurrentPackageNames(String[] names);
/**
- * Return a "good" intent to launch a front-door activity in a package,
- * for use for example to implement an "open" button when browsing through
- * packages. The current implementation will look first for a main
- * activity in the category {@link Intent#CATEGORY_INFO}, next for a
- * main activity in the category {@link Intent#CATEGORY_LAUNCHER}, or return
- * null if neither are found.
- *
- * <p>Throws {@link NameNotFoundException} if a package with the given
- * name cannot be found on the system.
+ * Returns a "good" intent to launch a front-door activity in a package.
+ * This is used, for example, to implement an "open" button when browsing
+ * through packages. The current implementation looks first for a main
+ * activity in the category {@link Intent#CATEGORY_INFO}, and next for a
+ * main activity in the category {@link Intent#CATEGORY_LAUNCHER}. Returns
+ * <code>null</code> if neither are found.
*
* @param packageName The name of the package to inspect.
*
- * @return Returns either a fully-qualified Intent that can be used to
- * launch the main activity in the package, or null if the package does
- * not contain such an activity.
+ * @return A fully-qualified {@link Intent} that can be used to launch the
+ * main activity in the package. Returns <code>null</code> if the package
+ * does not contain such an activity, or if <em>packageName</em> is not
+ * recognized.
*/
public abstract Intent getLaunchIntentForPackage(String packageName);