预构建Expo React Native项目在Android Studio模拟器运行安装失败的解决

模拟器层面问题排查 #

• 重启模拟器：直接关闭模拟器后重新打开，多数临时状态异常能通过这个操作解决
• 更换新模拟器测试：创建模拟器时选择与项目targetSdkVersion匹配的API级别，避免版本不兼容问题
• 检查模拟器存储空间：进入模拟器「设置-存储」查看剩余空间，若不足可清理垃圾，或在创建模拟器时调大存储分配额度
• 关闭模拟器快速启动：在模拟器开发者选项中关闭该功能，重启模拟器后再尝试安装

项目构建配置问题 #

• 核对版本兼容性：打开模块级build.gradle，确认minSdkVersion、targetSdkVersion不高于模拟器的API版本
• 清理后重新构建：在Android Studio中点击「Build > Clean Project」，再执行「Build > Rebuild Project」；也可在项目根目录运行命令./gradlew clean build（Windows环境用gradlew.bat clean build）
• 检查Debug签名配置：默认Android Studio会自动生成Debug keystore，若手动修改过签名配置，需确认build.gradle中的签名路径、密码均正确

Expo预构建相关问题 #

• 彻底重新预构建：先删除项目根目录的android文件夹，再执行npx expo prebuild --clean，全程留意预构建过程是否有报错
• 同步项目依赖：先运行npx expo install确保所有依赖安装到位，再执行预构建操作
• 检查包名规范：打开app.json/app.config.js，确认Android配置中的package字段为小写字母加点分隔的格式，不能包含特殊字符

Android Studio环境问题 #

• 更新至最新稳定版：旧版本Android Studio可能与新版Expo、React Native存在兼容性问题
• 检查SDK工具完整性：打开SDK Manager，确保已安装对应版本的Android SDK Platform、Build-Tools，若项目需要NDK也需一并安装
• 重启Android Studio：缓存异常也可能导致安装失败，重启后再尝试运行项目

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