Flutter项目App Not Installed错误排查：三星Galaxy A31（Android12）安装失败

我开发的Flutter应用提交到安卓应用市场后，收到用户反馈：在三星Galaxy A31（Android 12）设备上安装时出现“App Not Installed”错误。我在多款不同设备上测试均能正常完成安装，现请求排查此问题的原因。

以下是项目的gradle配置代码：

def localProperties = new Properties()
def localPropertiesFile = rootProject.file('local.properties')
if (localPropertiesFile.exists()) {
    localPropertiesFile.withReader('UTF-8') { reader ->
        localProperties.load(reader)
    }
}

def flutterRoot = localProperties.getProperty('flutter.sdk')
if (flutterRoot == null) {
    throw new GradleException("Flutter SDK not found. Define location with flutter.sdk in the local.properties file.")
}

def flutterVersionCode = localProperties.getProperty('flutter.versionCode')
if (flutterVersionCode == null) {
    flutterVersionCode = '1'
}

def flutterVersionName = localProperties.getProperty('flutter.versionName')
if (flutterVersionName == null) {
    flutterVersionName = '1.0'
}

apply plugin: 'com.android.application'
apply plugin: 'kotlin-android'
apply from: "$flutterRoot/packages/flutter_tools/gradle/flutter.gradle"

def keystoreProperties = new Properties()
def keystorePropertiesFile = rootProject.file('key.properties')
if (keystorePropertiesFile.exists()) {
    keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
}


android {
    compileSdkVersion flutter.compileSdkVersion
    ndkVersion flutter.ndkVersion

    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }

    kotlinOptions {
        jvmTarget = '1.8'
    }

    sourceSets {
        main.java.srcDirs += 'src/main/kotlin'
    }

    defaultConfig {
        // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html).
        applicationId "com.octave.mathG"
        // You can update the following values to match your application needs.
        // For more information, see: https://docs.flutter.dev/deployment/android#reviewing-the-build-configuration.
        minSdkVersion 21
        targetSdkVersion 33
        versionCode flutterVersionCode.toInteger()
        versionName flutterVersionName
    }

   signingConfigs {
       release {
           keyAlias keystoreProperties['keyAlias']
           keyPassword keystoreProperties['keyPassword']
           storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
           storePassword keystoreProperties['storePassword']
       }
   }
   buildTypes {
       release {
           signingConfig signingConfigs.release
       }
   }
}

flutter {
    source '../..'
}

dependencies {
    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
}

可能的排查方向 #

• 签名冲突或验证问题：确认发布版APK使用了正确的签名密钥打包。三星部分设备对签名校验更严格，如果用户之前安装过同包名的debug签名/未签名版本，残留的应用会和当前release签名版本冲突，导致安装失败。建议让用户先卸载设备上同包名的所有残留应用，再尝试安装。
• Android 12安装权限限制：Android 12新增了应用安装权限要求，检查应用是否声明了REQUEST_INSTALL_PACKAGES权限。如果是应用市场分发，需确认市场是否适配了Android 12的安装机制；若用户是手动安装，需要开启对应渠道的“允许来自此来源的应用”权限。
• APK架构兼容性：三星Galaxy A31为arm64-v8a架构，检查APK是否包含该架构的so文件。Flutter默认生成多架构APK，但如果配置了ndk.abiFilters限制特定架构，可能导致不兼容。可以尝试生成通用APK测试，或确认gradle配置中未限制arm64-v8a架构。
• 版本或签名不兼容：用户设备上可能存在同一应用的旧版本，且旧版本的签名（如debug签名）与当前release签名不一致，或者版本代码低于已安装版本（手动安装时可能出现此情况）。建议让用户彻底卸载旧版本后重试。
• 存储问题：设备存储空间不足会直接导致安装失败，让用户检查剩余存储空间；另外Android 12对存储权限管控更严格，若应用安装时需要访问特定存储路径，可能因权限问题中断安装。
• Flutter版本兼容性：检查使用的Flutter版本是否存在Android 12的已知兼容bug，比如旧版本Flutter在处理Android 12包安装时的异常。尝试升级Flutter到最新稳定版后重新打包测试。

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