Android Studio使用Native C++模板新建项目无法调试如何解决

模板项目调试基础说明 #

官方原生C模板默认支持直接断点调试，多个稳定版Android Studio（含Giraffe、Hedgehog、Iguana）实测都可以直接命中Java/Kotlin层、C/C层断点，正常情况不需要额外做自定义配置。

无法调试的排查步骤 #

• 检查调试配置类型：打开运行栏旁的调试配置下拉框，选择Edit Configurations，进入对应项目配置的Debugger标签，必须将调试类型设置为Dual (Java + Native)，如果默认选中Java Only，会导致native层断点完全失效，也不会输出native相关日志。
• 确认设备调试权限：测试设备/模拟器需要开启USB调试、USB安装权限，国产定制系统额外需要开启允许调试应用、关闭权限监控相关开关，否则调试器无法正常附着到应用进程。
• 核对构建配置：打开模块级build.gradle文件，确认debug构建类型下保留debuggable true配置，ndk配置块中不要添加strip = true等删除调试符号的配置，默认模板不会自带这类配置，手动修改过构建规则需要回改。
• 清理缓存重构建：依次点击File -> Invalidate Caches...，勾选清理文件系统缓存和本地历史，重启Android Studio后重新同步Gradle、全量构建项目再调试，大部分无原因异常都是缓存冲突导致。
• 调整Logcat过滤规则：如果Logcat没有输出足够信息，先将日志过滤级别调整为Verbose，同时确认过滤规则是当前应用的包名，避免低级别日志或者其他应用日志把目标日志冲掉。

特殊情况处理 #

如果上述步骤都执行后仍无法调试，确认你使用的Android Studio是官方发布的稳定版，不要使用修改版、破解版；NDK版本优先使用模板默认匹配的版本，不要手动指定过新或过旧的NDK版本导致适配异常。

内容的提问来源于stack exchange，提问作者Śaeun acreáť