Android Studio编译完成却无法在真机运行，求助排查（附主Activity XML代码）

嘿，我之前也碰到过编译过了但真机跑不起来的糟心事，结合你给出的XML片段，咱们一步步排查看看：

• 先补全并检查XML语法
  你贴的XML代码末尾是android:layout_width="match_pa...，明显没写完，大概率是XML文件存在未闭合的标签、属性拼写错误（比如match_parent没写全）这类问题。哪怕Android Studio编译提示“完成”，资源文件的语法错误也可能导致安装包异常。
  建议先把整个XML文件补全，用Android Studio的快捷键Ctrl+Alt+L（Mac是Cmd+Opt+L）自动格式化代码，语法错误会直接标红提示，把这些问题先修复掉。

• 确认真机的调试连接状态

  • 检查手机是否开启了USB调试模式：一般是连续点击系统版本号7次打开开发者选项，然后找到USB调试并开启；
  • 连接电脑后，手机会弹出“允许此设备调试”的弹窗，一定要选择「允许」（最好勾选“始终允许此计算机”）；
  • 看看Android Studio的设备列表能不能识别到你的真机，如果识别不到，试试换个USB线/端口，或者重装对应品牌的手机USB驱动。

• 查看安装失败的具体报错
  编译完成≠安装成功，你可以打开Android Studio底部的「Run」控制台，看看有没有明确的报错信息：

  • 签名问题：如果是debug包，确认默认的debug keystore没问题；如果是release包，检查签名配置是否正确；
  • 版本兼容性：看看APP的minSdkVersion是不是高于真机的Android版本？比如真机是Android 10（API 29），但你的minSdk设为30，那肯定装不上；
  • 存储空间：手机内存不足也会导致安装失败，去手机设置里看看剩余空间够不够。

• 清理缓存后重建项目
  有时候缓存会搞出莫名其妙的问题，试试这几步：

  • 点击「Build > Clean Project」，再点击「Build > Rebuild Project」；
  • 或者直接删除项目根目录下的.gradle和build文件夹，然后点击「File > Sync Project with Gradle Files」重新同步。

• 检查MainActivity的注册信息
  哪怕编译通过，如果MainActivity没在AndroidManifest.xml里正确注册，也会启动失败。确认你的清单文件里有类似这样的代码：

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

  注意Android 12及以上版本，启动Activity必须添加android:exported="true"属性。

如果这些方法都试过还是不行，把「Run」控制台的完整报错信息贴出来，这样能更精准地定位问题~

内容的提问来源于stack exchange，提问作者Liew Syet Chau