如何在Android系统设置中添加无障碍服务的配置条目？

1. 关联设置界面到无障碍服务 #

在AndroidManifest.xml的无障碍Service标签内，添加android.settings类型的meta-data，直接关联你的配置Activity：

<service
    android:name=".YourAccessibilityService"
    android:permission="android.permission.BIND_ACCESSIBILITY_SERVICE">
    <intent-filter>
        <action android:name="android.accessibilityservice.AccessibilityService" />
    </intent-filter>
    <!-- 无障碍服务核心配置 -->
    <meta-data
        android:name="android.accessibilityservice"
        android:resource="@xml/accessibility_service_config" />
    <!-- 绑定设置界面 -->
    <meta-data
        android:name="android.settings"
        android:value=".YourSettingsActivity" />
</service>

2. 配置无障碍服务基础参数 #

在res/xml目录下创建accessibility_service_config.xml，填写服务的必要配置（系统设置中显示的描述、监听事件类型等）：

<?xml version="1.0" encoding="utf-8"?>
<accessibility-service xmlns:android="http://schemas.android.com/apk/res/android"
    android:description="@string/accessibility_service_desc"
    android:accessibilityEventTypes="typeAllMask"
    android:accessibilityFeedbackType="feedbackGeneric"
    android:accessibilityFlags="flagDefault" />

记得在strings.xml中定义对应的描述字符串：

<string name="accessibility_service_desc">你的无障碍服务功能描述，用户在系统设置中可见</string>

3. 实现配置界面Activity #

创建你的设置Activity（如YourSettingsActivity），开发对应的配置布局和逻辑：

public class YourSettingsActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_settings);
        // 示例：读取保存的配置项，绑定控件事件
        SwitchCompat configSwitch = findViewById(R.id.config_switch);
        SharedPreferences sp = getSharedPreferences("accessibility_config", MODE_PRIVATE);
        configSwitch.setChecked(sp.getBoolean("enable_feature", false));
        configSwitch.setOnCheckedChangeListener((buttonView, isChecked) -> {
            sp.edit().putBoolean("enable_feature", isChecked).apply();
            // 若需要同步到服务，可通过Intent或Binder通知
        });
    }
}

同时在AndroidManifest.xml中注册该Activity：

<activity android:name=".YourSettingsActivity" android:exported="true" />

4. 注意事项 #

• 只有当用户在系统设置中启用你的无障碍服务后，才会在服务条目右侧显示"设置"入口
• 若设置Activity在不同包名下，android.settings的value需要填写完整类名（如com.yourpackage.YourSettingsActivity）
• Android 12及以上版本，若配置界面涉及敏感权限，需处理动态权限申请流程

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