Android 系统设置访问指南：adb Shell Settings 与代码实现

本文系统介绍了Android系统设置的访问与管理方法，重点解析了adb shell settings命令的三大命名空间（system、global、secure）及其常用操作。同时详细阐述了如何在应用程序中通过ContentResolver和Settings API编程读写系统配置，包括权限要求、设置监听等关键技术要点。这些工具与API为系统调试、自动化测试和高级功能开发提供了核心支持，是Android开发者深入理解设备行为、实现定制化需求的重要基础。

博主博客

• https://blog.uso6.com
• https://blog.csdn.net/dxk539687357

一、概述

Android 系统提供了丰富的配置选项，这些设置分布在不同的命名空间中，可以通过 adb shell settings 命令或代码 API 进行访问和修改。了解这些系统设置对于开发、测试和系统定制都至关重要。

二、adb shell settings 命令详解

2.1 基础命令结构

# 基本语法
adb shell settings [subcommand] [namespace] [key] [value]

# 获取设置值
adb shell settings get system screen_brightness
adb shell settings get global airplane_mode_on
adb shell settings get secure location_providers_allowed

# 列出所有设置
adb shell settings list system
adb shell settings list global
adb shell settings list secure

2.2 三种命名空间

1. system - 与设备特定相关的设置

   # 屏幕相关设置
   adb shell settings get system screen_brightness
   adb shell settings get system screen_brightness_mode
   
   # 声音设置
   adb shell settings get system volume_music
   adb shell settings get system volume_ring
   
   # 显示设置
   adb shell settings get system font_scale
   adb shell settings get system screen_off_timeout
   

2. global - 跨所有用户/应用的全局设置

   # 网络相关
   adb shell settings get global airplane_mode_on
   adb shell settings get global wifi_on
   adb shell settings get global bluetooth_on
   
   # 开发选项
   adb shell settings get global adb_enabled
   adb shell settings get global stay_on_while_plugged_in
   
   # 系统状态
   adb shell settings get global device_provisioned
   

3. secure - 安全敏感设置（需要权限）

   # 位置服务
   adb shell settings get secure location_providers_allowed
   
   # 锁屏设置
   adb shell settings get secure lock_screen_lock_after_timeout
   
   # 输入法
   adb shell settings get secure default_input_method
   

2.3 常用操作命令

# 设置值
adb shell settings put system screen_brightness 200
adb shell settings put global airplane_mode_on 1

# 删除设置
adb shell settings delete system screen_brightness

# 重置设置
adb shell settings reset system
adb shell settings reset global

# 查看帮助
adb shell settings --help

三、代码中访问系统设置

3.1 通过 ContentResolver 访问

import android.content.ContentResolver;
import android.provider.Settings;

public class SystemSettingsHelper {
    
    private ContentResolver mContentResolver;
    
    public SystemSettingsHelper(ContentResolver contentResolver) {
        this.mContentResolver = contentResolver;
    }
    
    // 获取系统设置
    public int getScreenBrightness() {
        try {
            return Settings.System.getInt(
                mContentResolver, 
                Settings.System.SCREEN_BRIGHTNESS
            );
        } catch (Settings.SettingNotFoundException e) {
            e.printStackTrace();
            return -1;
        }
    }
    
    // 获取全局设置
    public int isAirplaneModeOn() {
        try {
            return Settings.Global.getInt(
                mContentResolver,
                Settings.Global.AIRPLANE_MODE_ON
            );
        } catch (Settings.SettingNotFoundException e) {
            e.printStackTrace();
            return 0;
        }
    }
    
    // 获取安全设置（需要权限）
    public String getDefaultInputMethod() {
        return Settings.Secure.getString(
            mContentResolver,
            Settings.Secure.DEFAULT_INPUT_METHOD
        );
    }
    
    // 修改设置
    public boolean setScreenBrightness(int brightness) {
        // 亮度值范围：0-255
        brightness = Math.max(0, Math.min(255, brightness));
        
        return Settings.System.putInt(
            mContentResolver,
            Settings.System.SCREEN_BRIGHTNESS,
            brightness
        );
    }
    
    // 监听设置变化
    public void registerSettingsObserver() {
        ContentResolver contentResolver = mContentResolver;
        
        contentResolver.registerContentObserver(
            Settings.System.getUriFor(Settings.System.SCREEN_BRIGHTNESS),
            false,
            new ContentObserver(new Handler()) {
                @Override
                public void onChange(boolean selfChange) {
                    super.onChange(selfChange);
                    int brightness = getScreenBrightness();
                    onBrightnessChanged(brightness);
                }
            }
        );
    }
    
    private void onBrightnessChanged(int brightness) {
        // 处理亮度变化
        Log.d("Settings", "亮度已更改为: " + brightness);
    }
}

3.2 使用 Settings.System 常量

Android 提供了完整的设置键名常量：

// 系统设置常量
Settings.System.SCREEN_BRIGHTNESS
Settings.System.SCREEN_BRIGHTNESS_MODE
Settings.System.VOLUME_MUSIC
Settings.System.VIBRATE_ON

// 全局设置常量  
Settings.Global.AIRPLANE_MODE_ON
Settings.Global.WIFI_ON
Settings.Global.BLUETOOTH_ON
Settings.Global.DEVICE_PROVISIONED

// 安全设置常量
Settings.Secure.LOCATION_PROVIDERS_ALLOWED
Settings.Secure.ANDROID_ID
Settings.Secure.INSTALL_NON_MARKET_APPS

3.3 权限要求

在 AndroidManifest.xml 中添加相应权限：

<!-- 读取系统设置 -->
<uses-permission android:name="android.permission.READ_SETTINGS" />

<!-- 写入系统设置（需要系统签名或特殊权限） -->
<uses-permission android:name="android.permission.WRITE_SETTINGS"
    android:protectionLevel="signature|system" />

<!-- 安全设置权限 -->
<uses-permission android:name="android.permission.WRITE_SECURE_SETTINGS"
    android:protectionLevel="signature" />

四、实际应用示例

4.1 屏幕亮度控制工具

public class BrightnessController {
    
    public static void setAutoBrightness(Context context, boolean enabled) {
        Settings.System.putInt(
            context.getContentResolver(),
            Settings.System.SCREEN_BRIGHTNESS_MODE,
            enabled ? Settings.System.SCREEN_BRIGHTNESS_MODE_AUTOMATIC 
                    : Settings.System.SCREEN_BRIGHTNESS_MODE_MANUAL
        );
    }
    
    public static void adjustBrightness(Context context, int levelPercent) {
        int brightness = (int) (255 * levelPercent / 100.0);
        brightness = Math.max(0, Math.min(255, brightness));
        
        // 设置亮度
        Settings.System.putInt(
            context.getContentResolver(),
            Settings.System.SCREEN_BRIGHTNESS,
            brightness
        );
        
        // 更新窗口亮度（立即生效）
        Window window = ((Activity) context).getWindow();
        WindowManager.LayoutParams layoutParams = window.getAttributes();
        layoutParams.screenBrightness = brightness / 255f;
        window.setAttributes(layoutParams);
    }
}

4.2 系统状态监控

public class SystemStateMonitor {
    
    private static final String[] MONITORED_SETTINGS = {
        Settings.Global.AIRPLANE_MODE_ON,
        Settings.Global.WIFI_ON,
        Settings.Global.BLUETOOTH_ON,
        Settings.System.SCREEN_BRIGHTNESS
    };
    
    public void startMonitoring(Context context) {
        ContentResolver resolver = context.getContentResolver();
        
        for (String setting : MONITORED_SETTINGS) {
            resolver.registerContentObserver(
                Settings.System.getUriFor(setting),
                true,
                mSettingsObserver
            );
        }
    }
    
    private final ContentObserver mSettingsObserver = new ContentObserver(new Handler()) {
        @Override
        public void onChange(boolean selfChange, Uri uri) {
            super.onChange(selfChange, uri);
            
            String key = uri.getLastPathSegment();
            Log.i("SystemMonitor", "设置变更: " + key);
            
            // 根据变更的设置执行相应操作
            handleSettingChange(key);
        }
    };
    
    private void handleSettingChange(String key) {
        switch (key) {
            case Settings.Global.AIRPLANE_MODE_ON:
                // 处理飞行模式变更
                break;
            case Settings.Global.WIFI_ON:
                // 处理WiFi开关变更
                break;
            // ... 其他设置处理
        }
    }
}

五、调试技巧与注意事项

5.1 调试技巧

1. 批量导出设置

   # 导出所有系统设置到文件
   adb shell settings list system > system_settings.txt
   adb shell settings list global > global_settings.txt
   adb shell settings list secure > secure_settings.txt
   

2. 对比设置变化

   # 修改设置前备份
   adb shell settings list system > before.txt
   
   # 进行操作...
   
   # 修改后对比
   adb shell settings list system > after.txt
   diff before.txt after.txt
   

3. 通过adb快速测试

   # 测试亮度调整
   adb shell settings put system screen_brightness 100
   adb shell settings put system screen_brightness_mode 0
   
   # 测试飞行模式
   adb shell settings put global airplane_mode_on 1
   adb shell am broadcast -a android.intent.action.AIRPLANE_MODE
   

5.2 注意事项

1. 权限限制

   • secure 命名空间需要系统级权限
   • WRITE_SETTINGS 权限需要动态申请（Android 6.0+）
   • 某些设置只能在系统应用或具有特定权限的应用中修改

2. 版本兼容性

   // 检查设置是否存在
   public boolean isSettingAvailable(String settingName) {
       try {
           // 尝试读取设置，如果抛出异常则说明不存在
           Settings.System.getInt(mContentResolver, settingName);
           return true;
       } catch (Settings.SettingNotFoundException e) {
           return false;
       }
   }
   

3. 线程安全

   • ContentResolver 操作应在工作线程执行
   • UI 更新应在主线程进行

4. 设置变更监听最佳实践

   public class SettingsMonitor {
       private ContentResolver mResolver;
       private Map<String, ContentObserver> mObservers = new HashMap<>();
       
       public void observeSetting(String key, Consumer<String> callback) {
           Uri uri = Settings.System.getUriFor(key);
           ContentObserver observer = new ContentObserver(new Handler()) {
               @Override
               public void onChange(boolean selfChange) {
                   callback.accept(key);
               }
           };
           
           mResolver.registerContentObserver(uri, false, observer);
           mObservers.put(key, observer);
       }
       
       public void stopObserving() {
           for (ContentObserver observer : mObservers.values()) {
               mResolver.unregisterContentObserver(observer);
           }
           mObservers.clear();
       }
   }
   

六、常见问题与解决方案

6.1 设置修改不生效

问题：通过代码修改了设置，但系统没有立即响应。

解决方案：

// 1. 发送广播通知系统
public static void setAirplaneMode(Context context, boolean enabled) {
    Settings.Global.putInt(
        context.getContentResolver(),
        Settings.Global.AIRPLANE_MODE_ON,
        enabled ? 1 : 0
    );
    
    // 发送广播使设置生效
    Intent intent = new Intent(Intent.ACTION_AIRPLANE_MODE_CHANGED);
    intent.putExtra("state", enabled);
    context.sendBroadcast(intent);
}

// 2. 对于亮度等设置，需要同时更新窗口属性
private void applyBrightnessImmediately(int brightness) {
    if (getActivity() != null) {
        Window window = getActivity().getWindow();
        WindowManager.LayoutParams layoutParams = window.getAttributes();
        layoutParams.screenBrightness = brightness / 255f;
        window.setAttributes(layoutParams);
    }
}

6.2 权限不足问题

问题：无法修改某些系统设置。

解决方案：

1. 检查应用是否具有相应权限
2. 检查应用是否被授予特殊权限（系统应用）
3. 使用 fallback 方案：

public boolean trySetBrightness(int brightness) {
    // 方法1：尝试通过系统API设置
    if (hasWriteSettingsPermission()) {
        return Settings.System.putInt(
            mContentResolver,
            Settings.System.SCREEN_BRIGHTNESS,
            brightness
        );
    }
    
    // 方法2：尝试通过无障碍服务（如果需要）
    if (isAccessibilityServiceEnabled()) {
        return setBrightnessViaAccessibility(brightness);
    }
    
    // 方法3：显示系统设置页面让用户手动调整
    showSystemSettingsPage();
    return false;
}

七、总结

通过 adb shell settings 命令和相应的代码 API，开发者可以有效地访问和控制系统设置。关键点包括：

1. 理解三个命名空间：system、global、secure 的不同用途和权限要求
2. 正确使用API：通过 ContentResolver 和 Settings 类访问设置
3. 处理权限问题：了解不同设置所需的权限级别
4. 监控设置变化：使用 ContentObserver 监听设置变更
5. 考虑兼容性：处理不同 Android 版本的差异

这些工具和 API 为系统定制、自动化测试和高级功能开发提供了强大的支持。在实际使用中，应根据具体需求和权限限制选择合适的访问方式。