Android系统am命令

在Android开发和测试中，am（Activity Manager）命令是一个非常强大的工具，它允许你从命令行或脚本中执行各种系统操作，如启动应用、发送广播、启动服务等。am命令通过adb shell在设备上执行。

1、启动应用

#通过packagename和activity启动应用
$ am start -n com.package.name/com.package.name.ActivityName
#通过activity的action启动应用，action在AndroidManifest.xml中配置
$ am start -a android.settings.SETTINGS
如：
	<activity
            android:name=".Main"
            android:launchMode="singleTask"
            android:theme="@android:style/Theme.NoTitleBar">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
            <intent-filter>
                <action android:name="android.settings.SETTINGS" />
                <category android:name="android.intent.category.DEFAULT" />
            </intent-filter>
	</activity>
	
#带参启动
#启动包名为com.package.name，Activity路径为com.package.name.ActivityName的应用，传递Intent参数pageUrl
$ am start -n com.package.name/com.package.name.ActivityName --es "pageUrl" "http://www.baidu.com"
$ am start -a android.settings.SETTINGS --es "pageUrl" "http://www.baidu.com"

am start命令还支持多种选项来控制Activity的启动方式，例如：
-D 启动调试模式
-W 等待启动完成
-activity-single-top 如果Activity已在任务的顶部运行，则不会创建新的实例

#启动Activity并等待
$ am start -W -n com.package.name/com.package.name.ActivityName

2、发送广播

#发送一个BOOT_COMPLETED的广播，模拟设备启动完成的事件。-a指定了广播的动作，-p指定了接收广播的包名
$ am broadcast -a android.intent.action.BOOT_COMPLETED -p com.package.name
#发送错误码广播，不指定包名，携带参数showOrHide=hide
$ am broadcast -a com.android.ERRORCODE --es "errorcode" "951XX" --es "showOrHide" "hide"

//举例
//1) 实例化
Intent intent = new Intent();
//2）Action
intent.setAction("com.xxx.action.SOME_ACTION");
//3) Component
intent.setComponent(new Component("com.xxx.somepackage", "com.xxx.packagesclass"));
//4) Package
intent.setPackage("com.xxx.someReceivePackage");
//5) Extra-String
intent.putExtra("extraStringName", "stringValue");
//6) Extra-Int
intent.putExtra("extraIntName", 1);
//7) Extra-Boolean
intent.putExtra("extraBoolName", true);

//对应am broadcast 命令行参数
// Action
-a com.xxx.action.SOME_ACTION
// Component
-n com.xxx.somepackage/com.xxx.packagesclass
// Package
-p com.xxx.someReceivePackage
// Extra-String 注意String字符中存在的双引号需要做转义 \"
-es extraStringName "stringValue"
// Extra-Int
-ei extraIntName 1
// Extra-Boolean
-ez extraBoolName true

//Andriod 9.0发送恢复出厂广播
am broadcast -a android.intent.action.FACTORY_RESET -p android  -f 0x10000000
//举例
//1) 实例化
Intent intent = new Intent();
//2）Action
intent.setAction("android.intent.action.FACTORY_RESET");
-a android.intent.action.FACTORY_RESET
//4) Package
intent.setPackage("android");
-p android
//5) Flags
intent.addFlags(Intent.FLAG_RECEIVER_FOREGROUND);
-f 0x10000000

3、启动/停止服务

#通过am命令启动一个服务
$ am startservice -n com.package.name/.ServiceName
#停止服务
$ am stopservice -n com.package.name/.ServiceName