Flutter调试APK无法安装至Android设备问题求助

问题关键信息 #

• 直接通过Android Studio运行应用正常，但导出的调试APK无法在Android 12设备安装，Android 7设备可正常安装
• 升级代码版本、应用版本后问题依旧，新建Flutter项目导出的调试APK也存在相同问题
• 配置信息：flutter.versionCode=2、flutter.versionName=2.0.0、flutter.minSdkVersion=19、flutter.targetSdkVersion=30

解决方案 #

• 检查Android 12设备的安装权限
  Android 12对「未知来源应用安装」权限做了细化，需要给用来安装APK的应用（如文件管理器、浏览器）单独开启权限：
  进入设备设置 → 应用 → 选择对应安装工具 → 权限 → 安装未知应用 → 开启「允许此来源」。

• 适配Android 12的包可见性要求
  在android/app/src/main/AndroidManifest.xml中添加包可见性声明，即使targetSdkVersion低于31，Android 12也可能需要该配置来正常处理安装：

  <queries>
      <intent>
          <action android:name="android.intent.action.VIEW" />
          <data android:scheme="package" />
      </intent>
  </queries>
  

• 升级targetSdkVersion至31及以上
  修改android/local.properties中的配置：

  flutter.targetSdkVersion = 31
  

  同步项目后重新导出调试APK，Android 12对targetSdk低于31的应用有部分行为限制，升级后可规避此类问题。

• 验证调试APK的签名配置
  确保导出的调试APK使用了正确的调试签名：

  1. 检查android/app/build.gradle中的debug签名配置是否正确：

     signingConfigs {
         debug {
             storeFile file('debug.keystore')
             storePassword 'android'
             keyAlias 'androiddebugkey'
             keyPassword 'android'
         }
     }
     buildTypes {
         debug {
             signingConfig signingConfigs.debug
         }
     }
     

  2. 尝试用命令行导出调试APK：flutter build apk --debug，再安装生成的APK测试。

• 导出通用架构的APK
  如果设备是64位架构，尝试导出包含所有ABI的APK：

  flutter build apk --debug --split-per-abi=false
  

  安装该通用APK，排查是否是ABI兼容性导致的安装失败。

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