ADB发送广播：命令、接收与调试全流程解析

Android开发过程中，广播机制（Broadcast）是一种非常重要的组件通信方式。通过广播，应用可以接收系统事件、应用内部消息以及其他应用发送的通知。而在实际开发和测试阶段，ADB（Android Debug Bridge）提供了一种非常便捷的方式，可以直接从电脑向Android设备发送广播，用于功能验证、问题定位以及自动化测试。

掌握ADB发送广播的方法，不仅能够提高Android开发调试效率，还可以帮助开发者快速分析BroadcastReceiver接收异常、Intent参数传递错误以及权限配置问题。

一、ADB广播机制简介

ADB是Android官方提供的调试工具，通过USB连接或网络连接方式，可以让开发者在电脑端控制Android设备。

执行ADB广播命令时，本质上是通过ActivityManager服务向系统发送一个Intent：

Bash
adb shell am broadcast

其中：

• adb shell表示进入Android设备Shell环境；

• am表示调用Activity Manager命令；

• broadcast表示发送广播Intent。

发送广播后，Android系统会根据Intent中的Action、Category、Data以及Extras等信息匹配对应的BroadcastReceiver，并执行接收逻辑。

---

二、ADB发送广播基础命令

最简单的广播发送方式如下：

Bash
adb shell am broadcast -a com.example.TEST_ACTION

其中：

• -a指定Intent Action；

• com.example.TEST_ACTION是自定义广播动作名称。

例如：

Bash
adb shell am broadcast -a com.demo.UPDATE_DATA

如果设备中存在注册了该Action的广播接收器，就会收到该广播。

执行成功后，通常会看到类似输出：

Broadcast completed: result=0

表示广播已经提交给系统处理。

---

三、常用ADB广播参数详解

ADB发送广播支持多个参数，可以模拟更加复杂的Intent。

1. 指定广播Action

Action是广播匹配的核心参数：

Bash
adb shell am broadcast -a android.intent.action.BOOT_COMPLETED

例如模拟系统启动完成事件。

需要注意，部分系统广播受到权限限制，即使发送成功，普通应用也可能无法接收。

---

2. 添加字符串参数

通过--es可以传递String类型Extra：

Bash
adb shell am broadcast 
-a com.demo.MESSAGE 
--es message "hello android"

Android代码中接收：

Java
String msg = intent.getStringExtra("message");

---

3. 添加整数参数

使用：

Bash
--ei key value

例如：

Bash
adb shell am broadcast 
-a com.demo.TEST 
--ei count 100

接收：

Java
int count = intent.getIntExtra("count", 0);

---

4. 添加布尔参数

使用：

Bash
--ez key value

例如：

Bash
adb shell am broadcast 
-a com.demo.TEST 
--ez enable true

接收：

Java
boolean enable = intent.getBooleanExtra("enable", false);

---

5. 添加浮点参数

可以使用：

Bash
--ef key value

例如：

Bash
adb shell am broadcast 
-a com.demo.TEST 
--ef speed 3.14

---

6. 添加多个Extra

实际项目中通常需要同时传递多个参数：

Bash
adb shell am broadcast 
-a com.demo.ORDER 
--es name "phone" 
--ei price 1999 
--ez available true

对应Intent：

Java
String name = intent.getStringExtra("name");
int price = intent.getIntExtra("price",0);
boolean available = intent.getBooleanExtra("available",false);

---

四、指定目标应用发送广播

Android系统支持通过包名限制广播接收范围。

命令：

Bash
adb shell am broadcast 
-a com.demo.TEST 
-p com.example.app

其中：

• -p表示指定Package；

• 只有指定应用中的Receiver可以匹配。

这种方式适用于：

• 应用内部调试；

• 避免广播被其他应用接收；

• 测试指定模块。

---

五、发送显式广播

如果已经知道BroadcastReceiver完整类名，可以直接指定组件：

Bash
adb shell am broadcast 
-n com.example.app/.MyReceiver

完整形式：

Bash
adb shell am broadcast 
-n com.example.app/com.example.app.MyReceiver

这种方式属于显式广播，会直接定位目标Receiver。

适合：

• 调试单个Receiver；

• 排查广播注册问题；

• 验证组件是否正常工作。

---

六、Android中如何接收ADB发送的广播

1. 静态注册BroadcastReceiver

在AndroidManifest.xml中：

XML
 android:name=".TestReceiver">
    
         android:name="com.demo.TEST"/>
    

创建Receiver：

Java
public class TestReceiver extends BroadcastReceiver {

    @Override
    public void onReceive(Context context, Intent intent) {

        String action = intent.getAction();

        if ("com.demo.TEST".equals(action)) {
            String message =
                intent.getStringExtra("message");

            Log.d("Receiver", message);
        }
    }
}

执行：

Bash
adb shell am broadcast 
-a com.demo.TEST 
--es message "ADB Test"

即可触发接收逻辑。

---

2. 动态注册BroadcastReceiver

代码注册：

Java
IntentFilter filter = new IntentFilter();

filter.addAction("com.demo.TEST");

registerReceiver(
    receiver,
    filter
);

发送广播：

Bash
adb shell am broadcast 
-a com.demo.TEST

动态注册的Receiver也可以正常接收。

---

七、ADB广播调试常用技巧

1. 查看广播发送结果

增加调试信息：

Bash
adb shell am broadcast -a com.demo.TEST -v

-v可以显示更详细的信息。

---

2. 查看系统广播日志

使用：

Bash
adb logcat

过滤广播相关日志：

Bash
adb logcat | grep Broadcast

或者：

Bash
adb logcat | grep Receiver

查看Receiver是否执行。

---

3. 查看应用注册的Receiver

查询指定应用：

Bash
adb shell dumpsys package com.example.app

查看Receiver：

Bash
adb shell dumpsys package com.example.app | grep Receiver

可以确认：

• Receiver是否注册；

• Action是否正确；

• 包名是否匹配。

---

4. 查看系统广播状态

Android提供：

Bash
adb shell dumpsys activity broadcasts

可以查看：

• 当前广播队列；

• 注册Receiver；

• 最近发送记录。

排查广播丢失问题时非常有用。

---

八、ADB广播常见问题分析

问题1：发送成功但Receiver没有响应

可能原因：

Action不一致

发送：

Bash
adb shell am broadcast -a com.demo.TEST

代码：

XML
 android:name="com.demo.TEST_EVENT"/>

两个Action不同，无法匹配。

解决：

统一Action名称。

---

问题2：动态Receiver无法接收

动态注册生命周期有限。

例如：

Java
registerReceiver(receiver,filter);

如果Activity退出：

Java
unregisterReceiver(receiver);

Receiver已经不存在。

解决：

确认注册时机和生命周期。

---

问题3：Android 8.0以后静态广播限制

Android 8.0（API 26）开始限制隐式广播。

例如：

XML
 android:name=".TestReceiver">
    
         android:name="com.demo.TEST"/>
    

部分隐式广播无法正常触发。

解决方案：

• 使用动态注册；

• 使用显式广播；

• 添加包名限制。

例如：

Bash
adb shell am broadcast 
-a com.demo.TEST 
-p com.example.app

---

问题4：权限导致无法接收

如果Receiver声明权限：

XML

    android:name=".TestReceiver"
    android:permission="com.demo.permission.TEST"/>

发送方必须拥有对应权限。

ADB测试时可能需要：

Bash
adb shell am broadcast 
-a com.demo.TEST 
--receiver-permission com.demo.permission.TEST

---

九、ADB广播在自动化测试中的应用

ADB发送广播不仅用于手动调试，也广泛应用于自动化测试。

例如：

模拟网络变化

Bash
adb shell am broadcast 
-a android.net.conn.CONNECTIVITY_CHANGE

模拟业务事件

Bash
adb shell am broadcast 
-a com.app.PAY_SUCCESS 
--es orderId 10001

自动化脚本触发功能

Shell脚本：

Bash
adb shell am broadcast 
-a com.demo.START_TASK 
--ez debug true

结合CI工具，可以实现：

• 自动启动测试流程；

• 模拟用户行为；

• 验证业务状态变化。

---

十、ADB发送广播最佳实践

为了提高调试效率，实际开发中建议遵循以下原则：

1. 使用唯一Action命名

推荐：

com.company.project.ACTION_NAME

避免：

TEST
UPDATE
START

等容易冲突的名称。

---

2. 优先使用显式广播

开发调试阶段：

Bash
adb shell am broadcast 
-n package/.Receiver

能够减少匹配问题。

---

3. 记录Intent参数

复杂广播建议打印：

Java
Log.d(
"Broadcast",
intent.getExtras().toString()
);

方便定位参数传递错误。

---

4. 使用adb命令验证Receiver

不要直接怀疑业务代码，先确认：

• Action是否一致；

• Receiver是否注册；

• 权限是否满足；

• 包名是否正确。

---

十一、总结

ADB发送广播是Android开发过程中非常实用的调试工具。通过adb shell am broadcast命令，开发者可以快速模拟各种Intent事件，验证BroadcastReceiver逻辑，定位广播接收失败原因。

掌握Action设置、Extra参数传递、显式广播、权限控制以及logcat调试方法，可以大幅提升Android应用开发和测试效率。

无论是日常开发排查问题，还是自动化测试流程搭建，ADB广播都是Android工程师必须掌握的重要技能之一。