/*
**
** Copyright 2007, The Android Open Source Project
**
** Licensed under the Apache License, Version 2.0 (the "License");
** you may not use this file except in compliance with the License.
** You may obtain a copy of the License at
**
** http://www.apache.org/licenses/LICENSE-2.0
**
** Unless required by applicable law or agreed to in writing, software
** distributed under the License is distributed on an "AS IS" BASIS,
** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
** See the License for the specific language governing permissions and
** limitations under the License.
*/
package com.android.commands.am;
import android.app.ActivityManagerNative;
import android.app.IActivityManager;
import android.app.IInstrumentationWatcher;
import android.app.Instrumentation;
import android.content.ComponentName;
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;
import android.os.RemoteException;
import android.os.ServiceManager;
import android.view.IWindowManager;
import java.util.Iterator;
import java.util.Set;
public class Am {
private IActivityManager mAm;
private String[] mArgs;
private int mNextArg;
private String mCurArgData;
private boolean mDebugOption = false;
/**
* Command-line entry point.
*
* @param args The command-line arguments
*/
public static void main(String[] args) {
(new Am()).run(args);
}
private void run(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 Intent makeIntent() {
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 void runStart() {
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 void sendBroadcast() {
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 void runInstrument() {
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 class InstrumentationWatcher extends IInstrumentationWatcher.Stub {
private boolean mFinished = false;
private boolean mRawMode = false;
/**
* Set or reset "raw mode". In "raw mode", all bundles are dumped. In "pretty mode",
* if a bundle includes Instrumentation.REPORT_KEY_STREAMRESULT, just print that.
* @param rawMode true for raw mode, false for pretty mode.
*/
public void setRawOutput(boolean rawMode) {
mRawMode = rawMode;
}
public void instrumentationStatus(ComponentName name, int resultCode, Bundle results) {
synchronized (this) {
// pretty printer mode?
String pretty = null;
if (!mRawMode && results != null) {
pretty = results.getString(Instrumentation.REPORT_KEY_STREAMRESULT);
}
if (pretty != null) {
System.out.print(pretty);
} else {
if (results != null) {
for (String key : results.keySet()) {
System.out.println(
"INSTRUMENTATION_STATUS: " + key + "=" + results.get(key));
}
}
System.out.println("INSTRUMENTATION_STATUS_CODE: " + resultCode);
}
notifyAll();
}
}
public void instrumentationFinished(ComponentName name, int resultCode,
Bundle results) {
synchronized (this) {
// pretty printer mode?
String pretty = null;
if (!mRawMode && results != null) {
pretty = results.getString(Instrumentation.REPORT_KEY_STREAMRESULT);
}
if (pretty != null) {
System.out.println(pretty);
} else {
if (results != null) {
for (String key : results.keySet()) {
System.out.println(
"INSTRUMENTATION_RESULT: " + key + "=" + results.get(key));
}
}
System.out.println("INSTRUMENTATION_CODE: " + resultCode);
}
mFinished = true;
notifyAll();
}
}
public boolean waitForFinish() {
synchronized (this) {
while (!mFinished) {
try {
if (!mAm.asBinder().pingBinder()) {
return false;
}
wait(1000);
} catch (InterruptedException e) {
}
}
}
return true;
}
}
private void runProfile() {
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 String nextOption() {
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 String nextOptionData() {
if (mCurArgData != null) {
return mCurArgData;
}
if (mNextArg >= mArgs.length) {
return null;
}
String data = mArgs[mNextArg];
mNextArg++;
return data;
}
private String nextArg() {
if (mNextArg >= mArgs.length) {
return null;
}
String arg = mArgs[mNextArg];
mNextArg++;
return arg;
}
private void showUsage() {
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>]");
}
}