如何诊断KivyMD应用在Android模拟器启动时崩溃的问题

核心错误定位 #

从提供的崩溃日志可直接定位触发点：java.lang.NullPointerException: Attempt to get length of null array 出现在 MainActivity.java 第81行的onResume生命周期方法中。这个Activity是python-for-android打包时自动生成的，空数组异常通常和权限请求、硬件资源加载、应用资源初始化三类逻辑相关。

排查步骤 #

• 核对权限配置
  你的应用名facefinder大概率涉及相机、本地存储读写能力，先检查buildozer.spec文件中的android.permissions配置项，确认是否添加了CAMERA、READ_EXTERNAL_STORAGE、WRITE_EXTERNAL_STORAGE权限。配置缺失时，打包生成的Activity请求权限时会拿到空权限列表，直接触发空数组异常。可以临时将该项配置为android.permissions = * 授予所有权限测试，快速验证是否为权限原因。
• 检查模拟器硬件配置
  打开模拟器的高级设置，确认是否开启了相机模拟、存储读写权限，若模拟器完全禁用了相机硬件，应用启动时尝试获取相机设备列表会返回空数组，直接触发崩溃。同时确认模拟器的安卓系统版本，和buildozer.spec中指定的android.api版本兼容性，比如指定编译API等级为33，模拟器使用安卓9（API28）时，部分权限逻辑不兼容也会触发该问题。
• 核对打包资源配置
  检查应用用到的所有外部资源（包括字体、图片、人脸识别模型文件等），是否在buildozer.spec的source.include_exts、source.include_dirs配置项中声明，若资源没有被打包进APK，启动阶段加载资源时返回空数组也会触发该错误。
• 最小demo验证排除业务代码问题
  先打包一个仅显示Hello World的最小KivyMD应用，使用和原项目完全相同的打包配置，如果最小demo可以正常运行，说明问题出在业务初始化逻辑中，可逐段注释原应用的初始化代码（尤其是相机、本地文件读取相关的逻辑），打包测试直到定位到触发崩溃的代码段。
• Python层异常捕获验证
  可在Kivy应用入口的build()方法外层套try-catch逻辑，将所有异常输出到logcat，很多时候Java层的空指针是Python层初始化失败传递了空参数导致的，捕获Python层异常可以更快定位问题。

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