AccessibilityService performGlobalAction失效问题求助

核心问题点 #

1. 错误实例化AccessibilityService #

你在MainActivity里直接new ExecutionService()创建服务实例，这是完全错误的。AccessibilityService是由Android系统管理的特殊服务，必须由系统初始化和绑定，手动创建的实例没有经过系统的生命周期处理，内部核心对象未初始化，所以会导致：

• 权限禁用时，调用方法触发空指针异常
• 权限启用后，调用方法也无法和系统无障碍服务通信，自然无反应

2. 其他潜在问题 #

• 无障碍服务配置xml中，未声明android:canPerformGestures="true"（Android 10+），截屏等全局操作需要该权限
• 未检查无障碍服务是否已启用，直接调用方法会导致异常或无效操作

修复步骤 #

步骤1：修正服务实例获取方式 #

通过ServiceConnection绑定服务，获取有效的ExecutionService实例：

修改MainActivity.java：

public class MainActivity extends AppCompatActivity {
    private ExecutionService accessibilityService;
    private ServiceConnection serviceConnection;

    @RequiresApi(api = Build.VERSION_CODES.P)
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Button b = findViewById(R.id.b);

        // 初始化服务连接
        serviceConnection = new ServiceConnection() {
            @Override
            public void onServiceConnected(ComponentName name, IBinder service) {
                ExecutionService.LocalBinder binder = (ExecutionService.LocalBinder) service;
                accessibilityService = binder.getService();
            }

            @Override
            public void onServiceDisconnected(ComponentName name) {
                accessibilityService = null;
            }
        };

        // 绑定服务
        Intent intent = new Intent(this, ExecutionService.class);
        bindService(intent, serviceConnection, Context.BIND_AUTO_CREATE);

        b.setOnClickListener(v -> {
            // 先检查服务是否可用且权限已启用
            if (accessibilityService != null && isAccessibilityServiceEnabled()) {
                boolean success = accessibilityService.performGlobalAction(AccessibilityService.GLOBAL_ACTION_TAKE_SCREENSHOT);
                // 可根据success值判断操作是否执行成功
            } else {
                // 引导用户开启无障碍权限
                openAccessibilitySettings();
            }
        });
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        if (serviceConnection != null) {
            unbindService(serviceConnection);
        }
    }

    // 检查无障碍服务是否已启用
    private boolean isAccessibilityServiceEnabled() {
        int accessibilityEnabled = 0;
        final String serviceName = getPackageName() + "/" + ExecutionService.class.getCanonicalName();
        try {
            accessibilityEnabled = Settings.Secure.getInt(getContentResolver(), Settings.Secure.ACCESSIBILITY_ENABLED);
        } catch (Settings.SettingNotFoundException e) {
            e.printStackTrace();
        }
        TextUtils.SimpleStringSplitter mStringColonSplitter = new TextUtils.SimpleStringSplitter(':');

        if (accessibilityEnabled == 1) {
            String settingValue = Settings.Secure.getString(getContentResolver(), Settings.Secure.ENABLED_ACCESSIBILITY_SERVICES);
            if (settingValue != null) {
                mStringColonSplitter.setString(settingValue);
                while (mStringColonSplitter.hasNext()) {
                    String accessibilityService = mStringColonSplitter.next();
                    if (accessibilityService.equalsIgnoreCase(serviceName)) {
                        return true;
                    }
                }
            }
        }
        return false;
    }

    // 打开无障碍设置页面
    private void openAccessibilitySettings() {
        Intent intent = new Intent(Settings.ACTION_ACCESSIBILITY_SETTINGS);
        startActivity(intent);
    }
}

步骤2：修改ExecutionService，添加LocalBinder #

让服务可以通过Binder暴露实例：

public class ExecutionService extends AccessibilityService {
    private final IBinder localBinder = new LocalBinder();

    public class LocalBinder extends Binder {
        public ExecutionService getService() {
            return ExecutionService.this;
        }
    }

    @Override
    public IBinder onBind(Intent intent) {
        return localBinder;
    }

    @Override
    public void onCreate() {
        super.onCreate();
    }

    @Override
    public void onAccessibilityEvent(AccessibilityEvent event) {

    }

    @Override
    public void onInterrupt() {

    }
}

步骤3：更新无障碍服务配置xml #

添加android:canPerformGestures="true"（针对Android 10及以上，确保支持截屏等手势操作）：

<?xml version="1.0" encoding="utf-8"?>
<accessibility-service xmlns:android="http://schemas.android.com/apk/res/android"
    android:accessibilityEventTypes="typeNotificationStateChanged|typeWindowStateChanged|typeWindowContentChanged"
    android:accessibilityFeedbackType="feedbackGeneric"
    android:accessibilityFlags="flagDefault"
    android:canRetrieveWindowContent="true"
    android:canPerformGestures="true"
    android:description="@string/accessibility_description"
    android:notificationTimeout="100" />

步骤4：关于BIND_ACCESSIBILITY_SERVICE权限 #

无需在<uses-permission>中声明该权限，因为这是系统级权限，只有系统才能绑定无障碍服务，你的服务在Manifest中已经通过android:permission="android.permission.BIND_ACCESSIBILITY_SERVICE"声明了绑定要求，这已经足够。

关键说明 #

• AccessibilityService的生命周期完全由系统控制，不能手动实例化，必须通过绑定或系统回调获取有效实例
• 调用全局操作前必须检查服务是否已启用，否则会触发异常或无反应
• 不同版本的Android对无障碍操作的权限要求略有差异，比如Android 10+需要canPerformGestures配置

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