使用Layout Inspector查看Compose应用时仅显示视图系统树无Composables树如何解决

问题根因 #

你遇到的报错核心是Layout Inspector需要写入系统全局调试参数来识别Compose布局，但是当前设备没有授予adb对应的WRITE_SECURE_SETTINGS权限，导致参数写入失败，无法加载Compose布局树，仅能显示原生View体系的结构。

解决方案 #

步骤1：授予应用所需权限 #

确保设备已经开启开发者选项、USB调试，且已和Android Studio正常连接，打开终端执行以下adb命令，将命令中的包名替换为你自己的应用包名：
adb shell pm grant com.example.statecodelab android.permission.WRITE_SECURE_SETTINGS
执行完成后重启Layout Inspector即可正常加载Compose布局树。

步骤2：兼容异常场景的补充方案 #

如果执行完上述命令依旧无法查看，可依次排查以下配置：

• 确认你的Android Studio版本为Arctic Fox 2020.3.1及以上，低于该版本原生不支持Compose布局检查
• 确认项目中Compose版本为1.0.0及以上正式版，早期alpha、beta版本存在Layout Inspector适配缺陷
• 检查项目模块级build.gradle配置，确保已开启Compose支持：

android {
    buildFeatures {
        compose true
    }
    buildTypes {
        debug {
            debuggable true
        }
    }
    composeOptions {
        kotlinCompilerExtensionVersion = "你的Compose版本号"
    }
}

• 如果你使用的是小米、华为等定制ROM的真机，需要手动到开发者选项中开启「USB调试（安全设置）」「允许USB调试修改系统设置」类的开关，部分厂商会默认拦截adb修改系统设置的请求
• 若以上操作都无效，可以换用官方Android AOSP模拟器运行应用，原生系统无权限限制，可直接正常查看Compose布局树

步骤3：确认Layout Inspector开关 #

打开Layout Inspector面板右上角的设置菜单，确认Enable Compose Inspector选项处于勾选状态。

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