FileDocCategorySizeDatePackage
Am.javaAPI DocAndroid 1.5 API19407Wed May 06 22:41:54 BST 2009com.android.commands.am

Am

public class Am extends Object

Fields Summary
private android.app.IActivityManager
mAm
private String[]
mArgs
private int
mNextArg
private String
mCurArgData
private boolean
mDebugOption
Constructors Summary
Methods Summary
public static voidmain(java.lang.String[] args)
Command-line entry point.

param
args The command-line arguments


                 
         
        (new Am()).run(args);
    
private android.content.IntentmakeIntent()

        Intent intent = new Intent();
        boolean hasIntentInfo = false;

        mDebugOption = false;
        Uri data = null;
        String type = null;

        try {
            String opt;
            while ((opt=nextOption()) != null) {
                if (opt.equals("-a")) {
                    intent.setAction(nextOptionData());
                    hasIntentInfo = true;
                } else if (opt.equals("-d")) {
                    data = Uri.parse(nextOptionData());
                    hasIntentInfo = true;
                } else if (opt.equals("-t")) {
                    type = nextOptionData();
                    hasIntentInfo = true;
                } else if (opt.equals("-c")) {
                    intent.addCategory(nextOptionData());
                    hasIntentInfo = true;
                } else if (opt.equals("-e") || opt.equals("--es")) {
                    String key = nextOptionData();
                    String value = nextOptionData();
                    intent.putExtra(key, value);
                    hasIntentInfo = true;
                } else if (opt.equals("--ei")) {
                    String key = nextOptionData();
                    String value = nextOptionData();
                    intent.putExtra(key, Integer.valueOf(value));
                    hasIntentInfo = true;
                } else if (opt.equals("--ez")) {
                    String key = nextOptionData();
                    String value = nextOptionData();
                    intent.putExtra(key, Boolean.valueOf(value));
                    hasIntentInfo = true;
                } else if (opt.equals("-n")) {
                    String str = nextOptionData();
                    ComponentName cn = ComponentName.unflattenFromString(str);
                    if (cn == null) {
                        System.err.println("Error: Bad component name: " + str);
                        showUsage();
                        return null;
                    }
                    intent.setComponent(cn);
                    hasIntentInfo = true;
                } else if (opt.equals("-f")) {
                    String str = nextOptionData();
                    intent.setFlags(Integer.decode(str).intValue());
                } else if (opt.equals("-D")) {
                    mDebugOption = true;
                } else {
                    System.err.println("Error: Unknown option: " + opt);
                    showUsage();
                    return null;
                }
            }
        } catch (RuntimeException ex) {
            System.err.println("Error: " + ex.toString());
            showUsage();
            return null;
        }
        intent.setDataAndType(data, type);

        String uri = nextArg();
        if (uri != null) {
            try {
                Intent oldIntent = intent;
                try {
                    intent = Intent.getIntent(uri);
                } catch (java.net.URISyntaxException ex) {
                    System.err.println("Bad URI: " + uri);
                    showUsage();
                    return null;
                }
                if (oldIntent.getAction() != null) {
                    intent.setAction(oldIntent.getAction());
                }
                if (oldIntent.getData() != null || oldIntent.getType() != null) {
                    intent.setDataAndType(oldIntent.getData(), oldIntent.getType());
                }
                Set cats = oldIntent.getCategories();
                if (cats != null) {
                    Iterator it = cats.iterator();
                    while (it.hasNext()) {
                        intent.addCategory((String)it.next());
                    }
                }
            } catch (RuntimeException ex) {
                System.err.println("Error creating from URI: " + ex.toString());
                showUsage();
                return null;
            }
        } else if (!hasIntentInfo) {
            System.err.println("Error: No intent supplied");
            showUsage();
            return null;
        }

        return intent;
    
private java.lang.StringnextArg()

        if (mNextArg >= mArgs.length) {
            return null;
        }
        String arg = mArgs[mNextArg];
        mNextArg++;
        return arg;
    
private java.lang.StringnextOption()

        if (mNextArg >= mArgs.length) {
            return null;
        }
        String arg = mArgs[mNextArg];
        if (!arg.startsWith("-")) {
            return null;
        }
        mNextArg++;
        if (arg.equals("--")) {
            return null;
        }
        if (arg.length() > 1 && arg.charAt(1) != '-") {
            if (arg.length() > 2) {
                mCurArgData = arg.substring(2);
                return arg.substring(0, 2);
            } else {
                mCurArgData = null;
                return arg;
            }
        }
        mCurArgData = null;
        return arg;
    
private java.lang.StringnextOptionData()

        if (mCurArgData != null) {
            return mCurArgData;
        }
        if (mNextArg >= mArgs.length) {
            return null;
        }
        String data = mArgs[mNextArg];
        mNextArg++;
        return data;
    
private voidrun(java.lang.String[] args)

        if (args.length < 1) {
            showUsage();
            return;
        }

        mAm = ActivityManagerNative.getDefault();
        if (mAm == null) {
            System.err.println("Error type 2");
            System.err.println("Error: Unable to connect to activity manager; is the system running?");
            showUsage();
            return;
        }

        mArgs = args;

        String op = args[0];
        mNextArg = 1;
        if (op.equals("start")) {
            runStart();
        } else if (op.equals("instrument")) {
            runInstrument();
        } else if (op.equals("broadcast")) {
            sendBroadcast();
        } else if (op.equals("profile")) {
            runProfile();
        } else {
            System.err.println("Error: Unknown command: " + op);
            showUsage();
            return;
        }
    
private voidrunInstrument()

        String profileFile = null;
        boolean wait = false;
        boolean rawMode = false;
        boolean no_window_animation = false;
        Bundle args = new Bundle();
        String argKey = null, argValue = null;
        IWindowManager wm = IWindowManager.Stub.asInterface(ServiceManager.getService("window"));

        try {
            String opt;
            while ((opt=nextOption()) != null) {
                if (opt.equals("-p")) {
                    profileFile = nextOptionData();
                } else if (opt.equals("-w")) {
                    wait = true;
                } else if (opt.equals("-r")) {
                    rawMode = true;
                } else if (opt.equals("-e")) {
                    argKey = nextOptionData();
                    argValue = nextOptionData();
                    args.putString(argKey, argValue);
                } else if (opt.equals("--no_window_animation")) {
                    no_window_animation = true;
                } else {
                    System.err.println("Error: Unknown option: " + opt);
                    showUsage();
                    return;
                }
            }
        } catch (RuntimeException ex) {
            System.err.println("Error: " + ex.toString());
            showUsage();
            return;
        }

        String cnArg = nextArg();
        if (cnArg == null) {
            System.err.println("Error: No instrumentation component supplied");
            showUsage();
            return;
        }
        
        ComponentName cn = ComponentName.unflattenFromString(cnArg);
        if (cn == null) {
            System.err.println("Error: Bad component name: " + cnArg);
            showUsage();
            return;
        }

        InstrumentationWatcher watcher = null;
        if (wait) {
            watcher = new InstrumentationWatcher();
            watcher.setRawOutput(rawMode);
        }
        float[] oldAnims = null;
        if (no_window_animation) {
            try {
                oldAnims = wm.getAnimationScales();
                wm.setAnimationScale(0, 0.0f);
                wm.setAnimationScale(1, 0.0f);
            } catch (RemoteException e) {
            }
        }

        try {
            if (!mAm.startInstrumentation(cn, profileFile, 0, args, watcher)) {
                System.out.println("INSTRUMENTATION_FAILED: " +
                        cn.flattenToString());
                showUsage();
                return;
            }
        } catch (RemoteException e) {
        }

        if (watcher != null) {
            if (!watcher.waitForFinish()) {
                System.out.println("INSTRUMENTATION_ABORTED: System has crashed.");
            }
        }

        if (oldAnims != null) {
            try {
                wm.setAnimationScales(oldAnims);
            } catch (RemoteException e) {
            }
        }
    
private voidrunProfile()

        String profileFile = null;
        boolean start = false;

        String process = nextArg();
        if (process == null) {
            System.err.println("Error: No profile process supplied");
            showUsage();
            return;
        }
        
        String cmd = nextArg();
        if ("start".equals(cmd)) {
            start = true;
            profileFile = nextArg();
            if (profileFile == null) {
                System.err.println("Error: No profile file path supplied");
                showUsage();
                return;
            }
        } else if (!"stop".equals(cmd)) {
            System.err.println("Error: Profile command " + cmd + " not valid");
            showUsage();
            return;
        }
        
        try {
            if (!mAm.profileControl(process, start, profileFile)) {
                System.out.println("PROFILE FAILED on process " + process);
                return;
            }
        } catch (IllegalArgumentException e) {
            System.out.println("PROFILE FAILED: " + e.getMessage());
            return;
        } catch (IllegalStateException e) {
            System.out.println("PROFILE FAILED: " + e.getMessage());
            return;
        } catch (RemoteException e) {
            System.out.println("PROFILE FAILED: activity manager gone");
            return;
        }
    
private voidrunStart()

        Intent intent = makeIntent();
        
        if (intent != null) {
            System.out.println("Starting: " + intent);
            try {
                intent.addFlags(intent.FLAG_ACTIVITY_NEW_TASK);
                // XXX should do something to determine the MIME type.
                int res = mAm.startActivity(null, intent, intent.getType(),
                        null, 0, null, null, 0, false, mDebugOption);
                switch (res) {
                    case IActivityManager.START_SUCCESS:
                        break;
                    case IActivityManager.START_CLASS_NOT_FOUND:
                        System.err.println("Error type 3");
                        System.err.println("Error: Activity class " +
                                intent.getComponent().toShortString()
                                + " does not exist.");
                        break;
                    case IActivityManager.START_DELIVERED_TO_TOP:
                        System.err.println(
                                "Warning: Activity not started, intent has "
                                + "been delivered to currently running "
                                + "top-most instance.");
                        break;
                    case IActivityManager.START_FORWARD_AND_REQUEST_CONFLICT:
                        System.err.println(
                                "Error: Activity not started, you requested to "
                                + "both forward and receive its result");
                        break;
                    case IActivityManager.START_INTENT_NOT_RESOLVED:
                        System.err.println(
                                "Error: Activity not started, unable to "
                                + "resolve " + intent.toString());
                        break;
                    case IActivityManager.START_RETURN_INTENT_TO_CALLER:
                        System.err.println(
                                "Warning: Activity not started because intent "
                                + "should be handled by the caller");
                        break;
                    case IActivityManager.START_TASK_TO_FRONT:
                        System.err.println(
                                "Warning: Activity not started, its current "
                                + "task has been brought to the front");
                        break;
                    default:
                        System.err.println(
                                "Error: Activity not started, unknown error "
                                + "code " + res);
                        break;
                }
            } catch (RemoteException e) {
                System.err.println("Error type 1");
                System.err.println(
                        "Error: Activity not started, unable to "
                        + "call on to activity manager service");
            }
        }
    
private voidsendBroadcast()

        Intent intent = makeIntent();
        
        if (intent != null) {
            System.out.println("Broadcasting: " + intent);
            try {
                mAm.broadcastIntent(null, intent, null, null, 0, null, null,
                        null, true, false);
            } catch (RemoteException e) {
            }
        }
    
private voidshowUsage()

        System.err.println("usage: am [start|broadcast|instrument|profile]");
        System.err.println("       am start -D INTENT");
        System.err.println("       am broadcast INTENT");
        System.err.println("       am instrument [-r] [-e <ARG_NAME> <ARG_VALUE>] [-p <PROF_FILE>]");
        System.err.println("                [-w] <COMPONENT> ");
        System.err.println("       am profile <PROCESS> [start <PROF_FILE>|stop]");
        System.err.println("");
        System.err.println("       INTENT is described with:");
        System.err.println("                [-a <ACTION>] [-d <DATA_URI>] [-t <MIME_TYPE>]");
        System.err.println("                [-c <CATEGORY> [-c <CATEGORY>] ...]");
        System.err.println("                [-e|--es <EXTRA_KEY> <EXTRA_STRING_VALUE> ...]");
        System.err.println("                [--ez <EXTRA_KEY> <EXTRA_BOOLEAN_VALUE> ...]");
        System.err.println("                [-e|--ei <EXTRA_KEY> <EXTRA_INT_VALUE> ...]");
        System.err.println("                [-n <COMPONENT>] [-f <FLAGS>] [<URI>]");