Various performance and other work.

- IME service now switches between visible and perceptible depending on
  whether it is being showm, allowing us to more aggressively free its
  memory when not shown.

- The activity display time is no longer delayed by the activity
  transition animation.

- New -R (repeat) option for launching activities with the am command.

- Improved some documentation on Loader to be clear about some methods
  that apps should not normally call.

- FrameworkPerf test now allows you to select individual tests to run.

Change-Id: Id1f73de66dc93d63212183958a72119ad174318b

Author: Dianne Hackborn

api/15.txt

@@ -5087,7 +5087,7 @@ package android.content {
     field public static final java.lang.String ALARM_SERVICE = "alarm";
     field public static final java.lang.String AUDIO_SERVICE = "audio";
     field public static final int BIND_ABOVE_CLIENT = 8; // 0x8
-    field public static final int BIND_ADJUST_WITH_ACTIVITY = 64; // 0x40
+    field public static final int BIND_ADJUST_WITH_ACTIVITY = 128; // 0x80
     field public static final int BIND_ALLOW_OOM_MANAGEMENT = 16; // 0x10
     field public static final int BIND_AUTO_CREATE = 1; // 0x1
     field public static final int BIND_DEBUG_UNBIND = 2; // 0x2

api/current.txt

@@ -60,6 +60,8 @@ public class Am {
     private boolean mWaitOption = false;
     private boolean mStopOption = false;
 
+    private int mRepeat = 0;
+
     private String mProfileFile;
     private boolean mProfileAutoStop;
 
@@ -133,6 +135,7 @@ private Intent makeIntent() throws URISyntaxException {
         mDebugOption = false;
         mWaitOption = false;
         mStopOption = false;
+        mRepeat = 0;
         mProfileFile = null;
         Uri data = null;
         String type = null;
@@ -263,6 +266,8 @@ private Intent makeIntent() throws URISyntaxException {
             } else if (opt.equals("--start-profiler")) {
                 mProfileFile = nextArgRequired();
                 mProfileAutoStop = false;
+            } else if (opt.equals("-R")) {
+                mRepeat = Integer.parseInt(nextArgRequired());
             } else if (opt.equals("-S")) {
                 mStopOption = true;
             } else {
@@ -335,138 +340,144 @@ private void runStart() throws Exception {
             mimeType = mAm.getProviderMimeType(intent.getData());
         }
 
-        if (mStopOption) {
-            String packageName;
-            if (intent.getComponent() != null) {
-                packageName = intent.getComponent().getPackageName();
-            } else {
-                IPackageManager pm = IPackageManager.Stub.asInterface(
-                        ServiceManager.getService("package"));
-                if (pm == null) {
-                    System.err.println("Error: Package manager not running; aborting");
-                    return;
+        do {
+            if (mStopOption) {
+                String packageName;
+                if (intent.getComponent() != null) {
+                    packageName = intent.getComponent().getPackageName();
+                } else {
+                    IPackageManager pm = IPackageManager.Stub.asInterface(
+                            ServiceManager.getService("package"));
+                    if (pm == null) {
+                        System.err.println("Error: Package manager not running; aborting");
+                        return;
+                    }
+                    List<ResolveInfo> activities = pm.queryIntentActivities(intent, mimeType, 0);
+                    if (activities == null || activities.size() <= 0) {
+                        System.err.println("Error: Intent does not match any activities: "
+                                + intent);
+                        return;
+                    } else if (activities.size() > 1) {
+                        System.err.println("Error: Intent matches multiple activities; can't stop: "
+                                + intent);
+                        return;
+                    }
+                    packageName = activities.get(0).activityInfo.packageName;
                 }
-                List<ResolveInfo> activities = pm.queryIntentActivities(intent, mimeType, 0);
-                if (activities == null || activities.size() <= 0) {
-                    System.err.println("Error: Intent does not match any activities: "
-                            + intent);
-                    return;
-                } else if (activities.size() > 1) {
-                    System.err.println("Error: Intent matches multiple activities; can't stop: "
-                            + intent);
+                System.out.println("Stopping: " + packageName);
+                mAm.forceStopPackage(packageName);
+                Thread.sleep(250);
+            }
+    
+            System.out.println("Starting: " + intent);
+            intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+    
+            ParcelFileDescriptor fd = null;
+    
+            if (mProfileFile != null) {
+                try {
+                    fd = ParcelFileDescriptor.open(
+                            new File(mProfileFile),
+                            ParcelFileDescriptor.MODE_CREATE |
+                            ParcelFileDescriptor.MODE_TRUNCATE |
+                            ParcelFileDescriptor.MODE_READ_WRITE);
+                } catch (FileNotFoundException e) {
+                    System.err.println("Error: Unable to open file: " + mProfileFile);
                     return;
                 }
-                packageName = activities.get(0).activityInfo.packageName;
-            }
-            System.out.println("Stopping: " + packageName);
-            mAm.forceStopPackage(packageName);
-            Thread.sleep(250);
-        }
-
-        System.out.println("Starting: " + intent);
-        intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
-
-        ParcelFileDescriptor fd = null;
-
-        if (mProfileFile != null) {
-            try {
-                fd = ParcelFileDescriptor.open(
-                        new File(mProfileFile),
-                        ParcelFileDescriptor.MODE_CREATE |
-                        ParcelFileDescriptor.MODE_TRUNCATE |
-                        ParcelFileDescriptor.MODE_READ_WRITE);
-            } catch (FileNotFoundException e) {
-                System.err.println("Error: Unable to open file: " + mProfileFile);
-                return;
             }
-        }
-
-        IActivityManager.WaitResult result = null;
-        int res;
-        if (mWaitOption) {
-            result = mAm.startActivityAndWait(null, intent, mimeType,
+    
+            IActivityManager.WaitResult result = null;
+            int res;
+            if (mWaitOption) {
+                result = mAm.startActivityAndWait(null, intent, mimeType,
+                            null, 0, null, null, 0, false, mDebugOption,
+                            mProfileFile, fd, mProfileAutoStop);
+                res = result.result;
+            } else {
+                res = mAm.startActivity(null, intent, mimeType,
                         null, 0, null, null, 0, false, mDebugOption,
                         mProfileFile, fd, mProfileAutoStop);
-            res = result.result;
-        } else {
-            res = mAm.startActivity(null, intent, mimeType,
-                    null, 0, null, null, 0, false, mDebugOption,
-                    mProfileFile, fd, mProfileAutoStop);
-        }
-        PrintStream out = mWaitOption ? System.out : System.err;
-        boolean launched = false;
-        switch (res) {
-            case IActivityManager.START_SUCCESS:
-                launched = true;
-                break;
-            case IActivityManager.START_SWITCHES_CANCELED:
-                launched = true;
-                out.println(
-                        "Warning: Activity not started because the "
-                        + " current activity is being kept for the user.");
-                break;
-            case IActivityManager.START_DELIVERED_TO_TOP:
-                launched = true;
-                out.println(
-                        "Warning: Activity not started, intent has "
-                        + "been delivered to currently running "
-                        + "top-most instance.");
-                break;
-            case IActivityManager.START_RETURN_INTENT_TO_CALLER:
-                launched = true;
-                out.println(
-                        "Warning: Activity not started because intent "
-                        + "should be handled by the caller");
-                break;
-            case IActivityManager.START_TASK_TO_FRONT:
-                launched = true;
-                out.println(
-                        "Warning: Activity not started, its current "
-                        + "task has been brought to the front");
-                break;
-            case IActivityManager.START_INTENT_NOT_RESOLVED:
-                out.println(
-                        "Error: Activity not started, unable to "
-                        + "resolve " + intent.toString());
-                break;
-            case IActivityManager.START_CLASS_NOT_FOUND:
-                out.println(NO_CLASS_ERROR_CODE);
-                out.println("Error: Activity class " +
-                        intent.getComponent().toShortString()
-                        + " does not exist.");
-                break;
-            case IActivityManager.START_FORWARD_AND_REQUEST_CONFLICT:
-                out.println(
-                        "Error: Activity not started, you requested to "
-                        + "both forward and receive its result");
-                break;
-            case IActivityManager.START_PERMISSION_DENIED:
-                out.println(
-                        "Error: Activity not started, you do not "
-                        + "have permission to access it.");
-                break;
-            default:
-                out.println(
-                        "Error: Activity not started, unknown error code " + res);
-                break;
-        }
-        if (mWaitOption && launched) {
-            if (result == null) {
-                result = new IActivityManager.WaitResult();
-                result.who = intent.getComponent();
             }
-            System.out.println("Status: " + (result.timeout ? "timeout" : "ok"));
-            if (result.who != null) {
-                System.out.println("Activity: " + result.who.flattenToShortString());
+            PrintStream out = mWaitOption ? System.out : System.err;
+            boolean launched = false;
+            switch (res) {
+                case IActivityManager.START_SUCCESS:
+                    launched = true;
+                    break;
+                case IActivityManager.START_SWITCHES_CANCELED:
+                    launched = true;
+                    out.println(
+                            "Warning: Activity not started because the "
+                            + " current activity is being kept for the user.");
+                    break;
+                case IActivityManager.START_DELIVERED_TO_TOP:
+                    launched = true;
+                    out.println(
+                            "Warning: Activity not started, intent has "
+                            + "been delivered to currently running "
+                            + "top-most instance.");
+                    break;
+                case IActivityManager.START_RETURN_INTENT_TO_CALLER:
+                    launched = true;
+                    out.println(
+                            "Warning: Activity not started because intent "
+                            + "should be handled by the caller");
+                    break;
+                case IActivityManager.START_TASK_TO_FRONT:
+                    launched = true;
+                    out.println(
+                            "Warning: Activity not started, its current "
+                            + "task has been brought to the front");
+                    break;
+                case IActivityManager.START_INTENT_NOT_RESOLVED:
+                    out.println(
+                            "Error: Activity not started, unable to "
+                            + "resolve " + intent.toString());
+                    break;
+                case IActivityManager.START_CLASS_NOT_FOUND:
+                    out.println(NO_CLASS_ERROR_CODE);
+                    out.println("Error: Activity class " +
+                            intent.getComponent().toShortString()
+                            + " does not exist.");
+                    break;
+                case IActivityManager.START_FORWARD_AND_REQUEST_CONFLICT:
+                    out.println(
+                            "Error: Activity not started, you requested to "
+                            + "both forward and receive its result");
+                    break;
+                case IActivityManager.START_PERMISSION_DENIED:
+                    out.println(
+                            "Error: Activity not started, you do not "
+                            + "have permission to access it.");
+                    break;
+                default:
+                    out.println(
+                            "Error: Activity not started, unknown error code " + res);
+                    break;
             }
-            if (result.thisTime >= 0) {
-                System.out.println("ThisTime: " + result.thisTime);
+            if (mWaitOption && launched) {
+                if (result == null) {
+                    result = new IActivityManager.WaitResult();
+                    result.who = intent.getComponent();
+                }
+                System.out.println("Status: " + (result.timeout ? "timeout" : "ok"));
+                if (result.who != null) {
+                    System.out.println("Activity: " + result.who.flattenToShortString());
+                }
+                if (result.thisTime >= 0) {
+                    System.out.println("ThisTime: " + result.thisTime);
+                }
+                if (result.totalTime >= 0) {
+                    System.out.println("TotalTime: " + result.totalTime);
+                }
+                System.out.println("Complete");
             }
-            if (result.totalTime >= 0) {
-                System.out.println("TotalTime: " + result.totalTime);
+            mRepeat--;
+            if (mRepeat > 1) {
+                mAm.unhandledBack();
             }
-            System.out.println("Complete");
-        }
+        } while (mRepeat > 1);
     }
 
     private void runForceStop() throws Exception {
@@ -1164,7 +1175,8 @@ private String nextArgRequired() {
     private static void showUsage() {
         System.err.println(
                 "usage: am [subcommand] [options]\n" +
-                "usage: am start [-D] [-W] [-P <FILE>] [--start-profiler <FILE>] [-S] <INTENT>\n" +
+                "usage: am start [-D] [-W] [-P <FILE>] [--start-profiler <FILE>]\n" +
+                "               [--R COUNT] [-S] <INTENT>\n" +
                 "       am startservice <INTENT>\n" +
                 "       am force-stop <PACKAGE>\n" +
                 "       am broadcast <INTENT>\n" +
@@ -1182,6 +1194,8 @@ private static void showUsage() {
                 "    -W: wait for launch to complete\n" +
                 "    --start-profiler <FILE>: start profiler and send results to <FILE>\n" +
                 "    -P <FILE>: like above, but profiling stops when app goes idle\n" +
+                "    -R: repeat the activity launch <COUNT> times.  Prior to each repeat,\n" +
+                "        the top activity will be finished.\n" +
                 "    -S: force stop the target app before starting the activity\n" +
                 "\n" +
                 "am startservice: start a Service.\n" +

cmds/am/src/com/android/commands/am/Am.java

@@ -185,7 +185,14 @@ public abstract class Context {
      * used to reduce the amount that the client process's overall importance
      * is used to impact it.
      */
-    public static final int BIND_ADJUST_WITH_ACTIVITY = 0x0040;
+    public static final int BIND_ADJUST_WITH_ACTIVITY = 0x0080;
+
+    /**
+     * Flag for {@link #bindService}: Don't consider the bound service to be
+     * visible, even if the caller is visible.
+     * @hide
+     */
+    public static final int BIND_NOT_VISIBLE = 0x40000000;
 
     /** Return an AssetManager instance for your application's package. */
     public abstract AssetManager getAssets();

core/java/android/content/Context.java

@@ -183,6 +183,12 @@ public boolean isReset() {
     }
 
     /**
+     * This function will normally be called for you automatically by
+     * {@link android.app.LoaderManager} when the associated fragment/activity
+     * is being started.  When using a Loader with {@link android.app.LoaderManager},
+     * you <em>must not</em> call this method yourself, or you will conflict
+     * with its management of the Loader.
+     *
      * Starts an asynchronous load of the Loader's data. When the result
      * is ready the callbacks will be called on the process's main thread.
      * If a previous load has been completed and is still valid
@@ -232,7 +238,13 @@ protected void onForceLoad() {
     }
 
     /**
-     * Stops delivery of updates until the next time {@link #startLoading()} is called.
+     * This function will normally be called for you automatically by
+     * {@link android.app.LoaderManager} when the associated fragment/activity
+     * is being stopped.  When using a Loader with {@link android.app.LoaderManager},
+     * you <em>must not</em> call this method yourself, or you will conflict
+     * with its management of the Loader.
+     *
+     * <p>Stops delivery of updates until the next time {@link #startLoading()} is called.
      * Implementations should <em>not</em> invalidate their data at this point --
      * clients are still free to use the last data the loader reported.  They will,
      * however, typically stop reporting new data if the data changes; they can
@@ -260,6 +272,12 @@ protected void onStopLoading() {
     }
 
     /**
+     * This function will normally be called for you automatically by
+     * {@link android.app.LoaderManager} when restarting a Loader.  When using
+     * a Loader with {@link android.app.LoaderManager},
+     * you <em>must not</em> call this method yourself, or you will conflict
+     * with its management of the Loader.
+     *
      * Tell the Loader that it is being abandoned.  This is called prior
      * to {@link #reset} to have it retain its current data but not report
      * any new data.
@@ -282,6 +300,12 @@ protected void onAbandon() {
     }
 
     /**
+     * This function will normally be called for you automatically by
+     * {@link android.app.LoaderManager} when destroying a Loader.  When using
+     * a Loader with {@link android.app.LoaderManager},
+     * you <em>must not</em> call this method yourself, or you will conflict
+     * with its management of the Loader.
+     *
      * Resets the state of the Loader.  The Loader should at this point free
      * all of its resources, since it may never be called again; however, its
      * {@link #startLoading()} may later be called at which point it must be