Android Studio中搭载LineageOS的真机无法使用App Inspection问题

以下是针对该问题的实用排查和解决步骤：

• 确认应用的可调试状态
  确保部署的是debug变体应用：

  • 检查AndroidManifest.xml中是否包含 <application android:debuggable="true">（debug变体默认自动添加，手动修改过需确认）
  • 查看模块build.gradle文件，debug闭包中是否存在debuggable true（默认开启，release变体默认关闭）

• 开启LineageOS专属调试权限
  LineageOS开发者选项有额外限制，需完成以下操作：

  • 进入「设置 → 系统 → 开发者选项」，开启USB调试（安全设置）（默认关闭，需允许通过USB调试修改权限/模拟输入）
  • 在「调试应用」选项中选中目标App，按需勾选「等待调试器」
  • 启动App后，回到「选择调试应用」，确认能看到该App的运行进程

• 验证ADB连接与进程状态
  用ADB命令确认设备连接和进程权限：

  • 执行 adb devices，确保设备处于「device」授权状态
  • 执行 adb shell dumpsys package <你的包名> | grep debuggable，输出需为debuggable=true
  • 执行 adb shell ps | grep <你的包名>，确认进程正在运行

• 处理LineageOS的隐私/安全限制

  • 进入「设置 → 隐私 → 隐私保护」，找到Android Studio相关权限，允许其访问设备调试接口
  • 尝试开启「开发者选项 → 启用ADB网络调试」，通过adb connect <设备IP>:5555用无线ADB连接设备，规避USB调试的潜在冲突

• Root设备的额外调试配置
  若设备已Root，执行以下操作：

  • 运行 adb root 获取ADB的Root权限，随后重启ADB服务：adb kill-server && adb start-server
  • 检查进程调试权限：adb shell su -c "cat /proc/<进程ID>/status | grep CapEff"，确保输出包含0x0000000000000004（对应CAP_SYS_PTRACE权限）

• 重置Android Studio的App Inspection缓存

  • 关闭Android Studio，删除用户目录下的.android/app-inspection文件夹（Windows：C:\Users\<用户名>\.android，Mac：~/Library/Android/sdk/.android）
  • 或通过「File → Invalidate Caches...」，勾选「Clear file system cache and local history」后重启AS

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