Android开源项目中'ro.boot.bootreason'属性的设置与计算逻辑问询

设置位置 #

• 该属性是在Bootloader启动阶段由硬件厂商的bootloader程序写入内核启动参数的，不属于Android系统应用层配置。
• 不同芯片平台（如高通、联发科）的实现细节有差异，但核心逻辑一致：bootloader会检测开机的硬件触发源（比如USB供电、电源键、闹钟唤醒等），如果判定是USB供电触发的开机，就会将androidboot.bootreason=usb添加到传给内核的cmdline参数列表中。
• 你可以执行命令 cat /proc/cmdline 查看当前设备的内核启动参数，直接确认该属性的存在状态。

计算与判定逻辑 #

• Android系统上层获取启动原因时，会先读取内核cmdline中的androidboot.bootreason值，再结合系统层的补充逻辑（比如关机前的状态记录、用户操作痕迹），最终生成返回给应用的启动原因标识。
• Android 10与11的差异根源：
  • Android 11对启动原因的判定逻辑做了补充优化：当设备通过USB供电触发开机，但关机前是用户主动执行关机操作的场景，部分厂商的实现会优先返回userrequested，而非直接沿用bootloader传入的usb值；而Android 10的多数实现会直接返回bootloader传入的原始值，没有额外修正逻辑。
  • 在USB连接触发自动唤醒（如充电自动开机）的场景下，Android 10通常直接标记为USB启动，而Android 11会结合关机前的状态，判断是否属于用户间接触发的启动，进而调整返回结果。
• 业务适配建议：不要仅依赖单一的启动原因字段做逻辑判断，建议结合android.intent.action.BOOT_COMPLETED广播的附加信息，或读取/sys/power/state、/proc/last_kmsg等系统文件的辅助信息来综合判定启动场景。

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