Flutter构建APK报错求助：真机安装失败，模拟器运行正常

1. 对齐Android SDK相关版本配置 #

• 打开项目下的android/build.gradle文件，确保compileSdkVersion、targetSdkVersion和buildToolsVersion使用匹配的稳定版本（比如33或34）：

  android {
      compileSdkVersion 34
      buildToolsVersion "34.0.0"
  
      defaultConfig {
          targetSdkVersion 34
          // 保留其他原有配置
      }
  }
  

• 打开Android Studio的SDK管理器，确认对应版本的构建工具已安装完成。

2. 更新Gradle相关版本 #

• 在android/build.gradle的dependencies块中，将Gradle插件更新到稳定版：

  dependencies {
      classpath "com.android.tools.build:gradle:7.4.2" // 可使用更高稳定版本
      classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
  }
  

• 同步项目后，若提示Gradle版本不兼容，在android/gradle/wrapper/gradle-wrapper.properties中指定匹配的Gradle版本：

  distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip
  

3. 清理缓存后重新构建 #

• 依次执行以下命令清理项目缓存并重新打包：

  flutter clean
  flutter pub get
  flutter build apk --release
  

4. 检查真机安装设置 #

• 确保真机已开启「允许安装未知来源应用」的权限；
• 若真机CPU架构特殊，可生成分架构APK后选择对应版本安装：

  flutter build apk --split-per-abi
  

5. 通过日志定位具体问题 #

• 若以上步骤无效，用adb命令查看安装失败的详细日志：

  adb install -r app-release.apk
  

根据日志里的具体报错（比如签名错误、权限冲突、架构不兼容）针对性解决。

内容的提问来源于stack exchange，提问作者jhancarlos lenis arango