Android 14应用安装失败求助：SDK版本不兼容问题排查

应用在多数设备运行正常，但升级到Android 14的用户遇到安装失败，提示「应用未安装，因为该应用与您的手机不兼容」，结合你提供的SDK配置（minSdkVersion=16、compileSdkVersion=28、targetSdkVersion=26），以下是具体解决思路：

1. 升级Gradle构建工具版本 #

你当前使用的com.android.tools.build:gradle:1.1.0是非常老旧的版本，完全不支持Android 14（API 34）的编译与兼容逻辑，这是导致安装失败的核心原因之一。同时jcenter()仓库已废弃，需要替换为活跃的仓库：

buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        // 替换为支持Android 14的Gradle插件版本，比如7.4.2
        classpath 'com.android.tools.build:gradle:7.4.2'
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

注意：升级Gradle插件后，需要同步项目根目录的gradle/wrapper/gradle-wrapper.properties，将distributionUrl对应到匹配的Gradle版本（比如7.4.2插件对应Gradle 7.5）

2. 统一并调整SDK版本配置 #

Android 14对低版本SDK的应用有更严格的兼容限制，建议调整SDK版本并保证配置一致：
在build.gradle的android块中添加defaultConfig，统一管理SDK版本（优先级高于AndroidManifest.xml的配置）：

android {
    // ... 原有配置
    defaultConfig {
        // 根据需求调整minSdk，建议至少提升到23以适配Android 14的基础兼容要求
        minSdkVersion 23
        // 升级targetSdk到34（Android 14）或至少31以上，适配系统行为变更
        targetSdkVersion 34
        // 保持compileSdk与targetSdk一致或更高，这里设为34
        compileSdkVersion 34
    }
    // ... 原有配置
}

同时可以移除AndroidManifest.xml中重复的<uses-sdk>配置，避免冲突。

3. 替换老旧依赖库 #

你当前使用的com.android.support:support-v4:23.0.0属于已废弃的旧支持库，在Android 14上存在兼容风险，建议迁移到AndroidX：

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    // 替换为AndroidX的核心库版本
    implementation 'androidx.core:core:1.12.0'
}

4. 验证与测试 #

• 修改配置后，执行Clean Project和Rebuild Project，确保无编译错误
• 在Android 14设备上测试安装与运行，确认问题解决
• 若仍需支持Android 6.0（API 23）以下的设备，需针对性测试低版本系统的兼容性，必要时保留minSdk=16但排查是否有依赖或API调用在Android 14上触发兼容性限制

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