Flutter Android插件：Android 11后台PackageInstaller无安装弹窗问题

问题根源 #

Android 11（API 30）新增了后台启动Activity的严格限制，普通应用处于后台时，无法直接通过startActivity()启动需要用户交互的系统Activity（包括APK安装弹窗）。你当前使用的ACTION_INSTALL_PACKAGE属于旧API，无法绕过这一限制。

解决方案：使用PackageInstaller API替代 #

Android官方推荐使用PackageInstaller API处理APK安装，它能更好适配Android 11+的后台启动规则，具体步骤如下：

1. 声明并请求必要权限
   在AndroidManifest.xml中添加安装权限：

<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />

针对Android 8.0+，需要动态请求权限：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O && !context.packageManager.canRequestPackageInstalls()) {
    val intent = Intent(Settings.ACTION_MANAGE_UNKNOWN_APP_SOURCES)
        .setData(Uri.parse("package:${context.packageName}"))
        .addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
    context.startActivity(intent)
    return
}

2. 用PackageInstaller实现后台安装逻辑
   替换原有代码，改用以下实现：

val apkFile = File(filePath)
val packageInstaller = context.packageManager.packageInstaller

// 1. 创建安装会话
val params = PackageInstaller.SessionParams(PackageInstaller.SessionParams.MODE_FULL_INSTALL)
val sessionId = packageInstaller.createSession(params)
val session = packageInstaller.openSession(sessionId)

// 2. 将APK写入会话
val inputStream = FileInputStream(apkFile)
val outputStream = session.openWrite("apk", 0, apkFile.length())
inputStream.copyTo(outputStream)
session.fsync(outputStream)
inputStream.close()
outputStream.close()

// 3. 提交会话并触发安装流程
val intent = Intent(context, InstallResultReceiver::class.java)
val pendingIntent = PendingIntent.getBroadcast(
    context,
    sessionId,
    intent,
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
        PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_MUTABLE
    } else {
        PendingIntent.FLAG_UPDATE_CURRENT
    }
)
session.commit(pendingIntent.intentSender)
session.close()

3. 创建广播接收器接收安装结果
   需要实现一个BroadcastReceiver处理安装完成后的回调：

class InstallResultReceiver : BroadcastReceiver() {
    override fun onReceive(context: Context?, intent: Intent?) {
        val status = intent?.getIntExtra(PackageInstaller.EXTRA_STATUS, PackageInstaller.STATUS_FAILURE)
        when (status) {
            PackageInstaller.STATUS_SUCCESS -> {
                // 处理安装成功逻辑
            }
            else -> {
                val errorMsg = intent?.getStringExtra(PackageInstaller.EXTRA_STATUS_MESSAGE)
                // 处理安装失败逻辑
            }
        }
    }
}

同时在AndroidManifest.xml中注册该接收器：

<receiver android:name=".InstallResultReceiver" />

关键说明 #

• PackageInstaller通过PendingIntent触发安装流程，这种方式不受Android 11后台启动Activity限制影响，系统会负责展示安装弹窗。
• Android 12+（API 31）需为PendingIntent指定FLAG_MUTABLE或FLAG_IMMUTABLE，这里因需接收结果使用FLAG_MUTABLE。
• 原FileProvider的配置保持不变，确保APK文件的Uri权限正确。

内容的提问来源于stack exchange，提问作者Phong Nguyễn