如何通过ADB调用带参数的应用函数并将结果返回至ADB命令行

• 无法直接通过ADB调用应用内部的单个函数，必须通过公开的四大组件（Activity/Service/BroadcastReceiver/ContentProvider）作为入口
• 不需要强制使用Activity作为中间层，优先推荐使用无界面的BroadcastReceiver实现，轻量化无前台干扰
• 参数传递通过ADB的am系列命令的extra参数实现，结果回传通过Logcat抓取实现，可通用适配所有业务场景

1. 推荐方案：使用BroadcastReceiver作为入口 #

步骤1：实现广播接收器 #

在应用内创建自定义广播接收器，作为ADB调用的统一入口，处理不同的函数调用请求、参数解析、执行结果输出：

import android.Manifest;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.content.pm.PackageManager;
import android.app.AlarmManager;
import android.util.Log;

public class ADBCallReceiver extends BroadcastReceiver {
    // 自定义Action，仅响应匹配的ADB广播
    private static final String ACTION_ADB_ENTRY = "com.your.package.ADB_ENTRY";
    // 结果输出的Log Tag，用于后续过滤抓取
    private static final String RESULT_TAG = "ADB_EXEC_RESULT";
    // 通用参数键
    private static final String KEY_FUNC_NAME = "func";
    // 对应setTimeZone函数的参数键
    private static final String KEY_TIMEZONE = "timezone";

    @Override
    public void onReceive(Context context, Intent intent) {
        // 仅响应指定Action的广播
        if (!ACTION_ADB_ENTRY.equals(intent.getAction())) return;
        String execResult = "ERROR: unknown error";

        // 解析要调用的函数名
        String funcName = intent.getStringExtra(KEY_FUNC_NAME);
        if (funcName == null) {
            execResult = "ERROR: missing func parameter";
        } else {
            // 匹配不同的业务函数
            switch (funcName) {
                case "setTimeZone":
                    String timezone = intent.getStringExtra(KEY_TIMEZONE);
                    execResult = setTimeZone(context, timezone);
                    break;
                // 后续新增业务函数只需要在这里加case即可
                default:
                    execResult = "ERROR: unsupported function " + funcName;
            }
        }
        // 输出执行结果到Logcat
        Log.d(RESULT_TAG, execResult);
    }

    // 你的业务函数示例
    private String setTimeZone(Context context, String timezone) {
        if (timezone == null || timezone.isEmpty()) {
            return "ERROR: missing timezone parameter";
        }
        try {
            AlarmManager am = (AlarmManager) context.getSystemService(Context.ALARM_SERVICE);
            if (context.checkSelfPermission(Manifest.permission.SET_TIME_ZONE) != PackageManager.PERMISSION_GRANTED) {
                return "ERROR: missing SET_TIME_ZONE permission";
            }
            am.setTimeZone(timezone);
            return "SUCCESS: timezone set to " + timezone;
        } catch (Exception e) {
            return "ERROR: " + e.getMessage();
        }
    }
}

步骤2：注册广播接收器 #

在AndroidManifest.xml中注册接收器，设置允许外部调用：

<receiver
    android:name=".ADBCallReceiver"
    android:exported="true">
    <intent-filter>
        <action android:name="com.your.package.ADB_ENTRY" />
    </intent-filter>
</receiver>

注意：生产环境可添加自定义权限校验，避免恶意第三方调用该接收器。

步骤3：ADB调用命令 #

使用如下命令即可传递参数调用函数，并获取返回结果：

# 第一步：清理旧的同Tag日志，避免结果干扰
adb logcat -c
# 第二步：发送广播，传递函数名和参数
adb shell am broadcast -a com.your.package.ADB_ENTRY --es func setTimeZone --es timezone "US/Eastern"
# 第三步：抓取执行结果，-m 1表示只获取1条匹配日志后退出
adb logcat -s ADB_EXEC_RESULT -m 1

2. 其他可选方案 #

方案A：使用Service作为入口 #

适合执行耗时较长的后台任务，实现逻辑和广播接收器基本一致，调用命令改为：

adb shell am startservice -a com.your.package.ADB_SERVICE_ENTRY --es func setTimeZone --es timezone "US/Eastern"

Service需要同样在Manifest中注册并设置android:exported="true"。

方案B：使用Activity作为入口 #

如果你的调用逻辑需要界面交互，可使用该方案，传递参数的命令为：

adb shell am start -n com.package.demo_app/.ChangeTimeZoneActivity --es timezone "US/Eastern"

在Activity的onCreate中通过getIntent().getStringExtra("timezone")即可获取参数，执行完成后同样打Log输出结果即可。

am命令支持传递不同类型的参数，常用参数标识如下：

• 字符串参数：--es <参数键> <参数值>
• 整数参数：--ei <参数键> <参数值>
• 布尔参数：--ez <参数键> true/false
• 长整数参数：--el <参数键> <参数值>
• 浮点数参数：--ef <参数键> <参数值>

1. 所有供ADB调用的组件必须设置android:exported="true"
2. 涉及敏感权限的操作（比如修改时区、修改系统设置）需要提前给应用授予对应权限
3. 该方案仅适合开发测试场景，不要在正式发布的应用中保留无权限校验的公开调用入口，避免安全风险

内容的提问来源于stack exchange，提问作者C18