应用模拟器构建成功但输出黑屏的问题排查求助

• 检查启动Activity配置：打开AndroidManifest.xml，确认主Activity的<intent-filter>包含正确的启动配置：

  <intent-filter>
      <action android:name="android.intent.action.MAIN" />
      <category android:name="android.intent.category.LAUNCHER" />
  </intent-filter>
  

  缺失这段配置会导致模拟器无法识别启动入口，引发黑屏。

• 验证布局加载逻辑：确认主Activity的onCreate方法中正确调用setContentView(R.layout.你的布局文件名)，检查布局文件名拼写是否与实际文件一致，避免因布局加载失败导致黑屏。

• 清理缓存与重建项目：

  1. 关闭模拟器，在AVD管理器中选中对应设备，点击Wipe Data清除模拟器数据；
  2. 执行Build > Clean Project，再运行Build > Rebuild Project重新构建项目。

• 检查权限声明：若应用依赖特定权限（如网络、存储），需在AndroidManifest.xml中提前声明，例如网络权限：

  <uses-permission android:name="android.permission.INTERNET" />
  

  权限缺失可能导致应用初始化失败，出现黑屏。

• 查看Logcat错误日志：打开Android Studio底部的Logcat面板，筛选Error级别日志，查找应用启动过程中的异常（如空指针、资源加载失败），这些是黑屏的核心诱因。

• 匹配模拟器系统版本：确认模拟器的系统版本不低于应用build.gradle中设置的minSdkVersion，版本不兼容会导致应用无法正常初始化，更换符合版本要求的模拟器重试。

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