am 57553775: am 63477e67: Merge "cherrypick from klp-docs docs: Corrected doc for getLaunchIntentForPackage(). Change-Id: I2eab0956eaedac71289e19a3618a3553908f8c38" into klp-modular-docs

* commit '575537759222e0277c3979e33342407aa7ca1a78':
  cherrypick from klp-docs docs: Corrected doc for getLaunchIntentForPackage(). Change-Id: I2eab0956eaedac71289e19a3618a3553908f8c38
This commit is contained in:
Andrew Solovay
2014-07-16 13:29:08 +00:00
committed by Android Git Automerger

View File

@ -1479,21 +1479,19 @@ public abstract class PackageManager {
public abstract String[] canonicalToCurrentPackageNames(String[] names); public abstract String[] canonicalToCurrentPackageNames(String[] names);
/** /**
* Return a "good" intent to launch a front-door activity in a package, * Returns a "good" intent to launch a front-door activity in a package.
* for use for example to implement an "open" button when browsing through * This is used, for example, to implement an "open" button when browsing
* packages. The current implementation will look first for a main * through packages. The current implementation looks first for a main
* activity in the category {@link Intent#CATEGORY_INFO}, next for a * activity in the category {@link Intent#CATEGORY_INFO}, and next for a
* main activity in the category {@link Intent#CATEGORY_LAUNCHER}, or return * main activity in the category {@link Intent#CATEGORY_LAUNCHER}. Returns
* null if neither are found. * <code>null</code> if neither are found.
*
* <p>Throws {@link NameNotFoundException} if a package with the given
* name cannot be found on the system.
* *
* @param packageName The name of the package to inspect. * @param packageName The name of the package to inspect.
* *
* @return Returns either a fully-qualified Intent that can be used to * @return A fully-qualified {@link Intent} that can be used to launch the
* launch the main activity in the package, or null if the package does * main activity in the package. Returns <code>null</code> if the package
* not contain such an activity. * does not contain such an activity, or if <em>packageName</em> is not
* recognized.
*/ */
public abstract Intent getLaunchIntentForPackage(String packageName); public abstract Intent getLaunchIntentForPackage(String packageName);