setprop 是一个在 Android 系统和基于 Linux 的系统中广泛使用的命令，用于在运行时设置系统属性，这些属性是全局的字符串键值对，贯穿整个系统，可以被系统服务和应用程序读取，从而影响系统的行为。
（图片来源网络，侵删）
核心概念：什么是系统属性？
你可以把系统属性想象成一个全局的、内存中的“配置数据库”，它由 Android 系统在启动时初始化，并在整个系统运行期间存在。
- 键：一个字符串，通常以
ro.(只读),persist.(持久化), 或service.等为前缀。 - 值：一个字符串。
常见的属性前缀及其含义：
ro.(Read-Only): 只读属性，一旦设置，就不能再被修改，通常用于定义硬件或构建时的固定信息。- 示例:
ro.product.model(设备型号),ro.build.version.release(Android 系统版本)。
- 示例:
persist.: 持久化属性，设置后，即使系统重启，属性值也会被保留，通常用于存储用户希望持久化的设置。- 示例:
persist.sys.timezone(时区),persist.sys.locale(语言区域)。
- 示例:
ctl.: 控制属性，用于向系统服务（如init进程）发送控制命令。- 示例:
ctl.start(启动服务),ctl.stop(停止服务)。
- 示例:
net.: 网络相关属性。- 示例:
net.dns1(首选 DNS 服务器)。
- 示例:
debug.: 调试属性，用于开启或关闭某个组件的调试日志。- 示例:
debug.sf.hw(是否启用硬件加速)。
- 示例:
setprop 命令的基本用法
setprop 命令通常需要 root 权限 才能执行，因为它会修改系统的核心状态。
语法
setprop <key> <value>
参数说明
key: 你要设置的系统属性的名称。value: 你要赋给该属性的值。
实战示例
示例 1：设置一个自定义属性
假设我们想设置一个名为 my.custom.property 的属性，值为 hello world。
（图片来源网络，侵删）
# 需要 root 权限 su # 设置属性 setprop my.custom.property "hello world" # 验证属性是否设置成功 getprop my.custom.property
输出:
[hello world]注意,getprop 返回的值被方括号 [] 包裹。
示例 2：修改一个已有的可写属性
有些非 ro. 前缀的属性是可写的，我们可以修改设备的时区。
# 需要 root 权限 su # 查看当前时区 getprop persist.sys.timezone # 输出可能是: [America/New_York] # 修改时区为亚洲/上海 setprop persist.sys.timezone "Asia/Shanghai" # 再次验证 getprop persist.sys.timezone # 输出变为: [Asia/Shanghai]
这个修改在系统重启后依然有效,因为它使用了 persist. 前缀。
（图片来源网络，侵删）
示例 3：通过属性控制服务
这是一个非常高级且强大的用法,我们可以通过设置 ctl. 属性来启动或停止系统服务。
假设系统有一个名为 my_service 的服务，定义在 init.rc 文件中：
# 在 init.rc 中定义服务
service my_service /system/bin/my_service_binary
class main
user root
group root
我们可以这样控制它：
# 需要 root 权限 su # 启动 my_service setprop ctl.start my_service # 停止 my_service setprop ctl.stop my_service
当 init 进程检测到 ctl.start 或 ctl.stop 属性被设置时，它会查找对应的服务名并执行相应的操作，执行完成后，init 会自动删除这些控制属性。
重要注意事项
- 权限要求：如前所述，
setprop几乎总是需要root权限，普通应用用户无法修改系统属性。 - 非持久性：如果你直接使用
setprop修改一个非persist.前缀的属性（debug.sf.hw），这个修改只会在当前会话中有效，一旦系统重启，属性值会恢复为默认值。- 临时调试：这对于临时开启或关闭某个功能进行调试非常有用，因为它不会对系统造成永久性改变。
ro.属性不可变：你绝对不能使用setprop修改任何以ro.开头的属性，系统会忽略这个命令，或者在某些情况下可能导致不稳定。- 性能影响：系统属性被设计为轻量级的键值对。不要在属性中存储大量数据（如几百KB的字符串），这会影响系统性能。
- 广播机制：当属性被修改时，系统会向所有监听该属性变化的组件广播一个
Intent，应用程序可以通过Intent.ACTION_BOOT_COMPLETED或监听特定属性的变化来做出响应。
与 getprop 的配合使用
setprop 和 getprop 是一对密不可分的命令。
setprop <key> <value>：设置属性。getprop <key>：获取指定属性的值。getprop：不带参数执行时，会列出所有的系统属性。
# 获取所有属性 getprop # 筛选出包含 "version" 的属性 getprop | grep version
在 Android 开发中的应用
对于 Android setprop 是一个非常强大的调试和测试工具。
- 开启/关闭日志：许多框架或库会检查特定的
debug.*属性来决定是否输出详细的日志。# 开启某个模块的详细日志 setprop debug.myapp.verbose 1
- 模拟不同设备配置：在测试应用时，可以临时修改
ro.product.model等属性，来模拟运行在不同型号设备上的行为。 - 绕过某些检查：在特定调试场景下，可以修改
ro.debuggable等属性（虽然通常需要重新编译系统才能永久生效）。 - 自动化测试：在编写 ADB 脚本或使用 Espresso 进行 UI 测试时，可以通过 ADB 执行
setprop来预先配置测试环境。
| 特性 | 描述 |
|---|---|
| 功能 | 在运行时设置 Android/Linux 系统属性。 |
| 权限 | 通常需要 root 权限。 |
| 语法 | setprop <key> <value> |
| 关键前缀 | ro. (只读), persist. (持久), ctl. (控制) |
| 主要用途 | 系统配置、服务控制、应用调试、临时测试。 |
| 对应命令 | getprop (用于读取属性) |
setprop 是一个深入系统底层的强大工具，无论是系统开发者还是高级 Android 应用开发者，都应该掌握它的使用方法。
