Android设备无法安装APK文件 仅AVD和开发设备可正常运行

问题排查与解决方案 #

1. 签名/包版本冲突排查 #

• 先确认你分发的不是Android Studio默认生成的调试签名APK，这类APK使用AS自动生成的临时测试签名，多数设备会禁止安装，且同包名不同签名的APK无法覆盖安装，需要先卸载目标设备上的同包名旧应用再尝试安装。
• 你当前build.gradle中未配置release版本的签名信息，未签名的release包系统默认禁止安装，需要在android代码块中添加签名配置：

android {
    // 新增签名配置
    signingConfigs {
        release {
            storeFile file("你的签名文件路径.jks")
            storePassword "签名文件密码"
            keyAlias "签名别名"
            keyPassword "别名密码"
        }
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
            // 关联release签名
            signingConfig signingConfigs.release
        }
    }
    // 原有配置保留
}

2. 系统版本与权限排查 #

• 你配置的minSdk 21对应Android 5.0，低于该版本的设备无法安装，先确认目标设备系统版本≥Android 5.0。
• 确认目标设备已开启「允许安装未知来源应用」权限，部分品牌设备的安全管家会拦截未上架应用，可临时关闭安全检测后重试。

3. ABI架构适配排查 #

如果你的应用包含原生so库，未适配目标设备的CPU架构会导致安装失败，可在defaultConfig代码块中添加全架构适配配置：

defaultConfig {
    applicationId "com.example.sangeetplayer"
    minSdk 21
    targetSdk 30
    versionCode 1
    versionName "1.0"
    testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    // 新增ABI适配
    ndk {
        abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
    }
}

4. Android 12+兼容排查 #

如果目标设备是Android 12（API 31）及以上版本，需要检查AndroidManifest.xml中所有带<intent-filter>的四大组件（Activity、Service、BroadcastReceiver、ContentProvider），必须显式声明android:exported属性，示例：

<activity
    android:name=".MainActivity"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

5. 精准定位报错 #

如果以上操作都无效，可通过adb命令安装APK查看具体报错信息，命令为：
adb install 你的应用.apk
adb返回的报错信息可以直接定位是签名、架构、清单文件还是权限问题。

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