Android Beacon Library后台检测iBeacon后无法唤起应用至前台

能正常弹出Toast说明信标检测回调逻辑完全正常，应用未被系统杀死，无法唤起前台是以下几个原因共同导致的：

• Android 10（API 29）及以上版本新增了后台启动Activity限制：应用处于后台时默认不允许直接启动Activity，系统会直接拦截startActivity调用避免打扰用户，这是最核心的原因。
• 配置错误：launchMode是Activity专属属性，写在<application>标签上完全不生效；启动Activity时仅添加FLAG_ACTIVITY_NEW_TASK标记不足，在应用任务栈被清空（比如按返回键退出）的场景下无法正常唤起。
• 系统与ROM额外限制：Android 12+进一步收紧了后台启动权限，小米、华为、OPPO、vivo等国产ROM还会额外增加后台弹出界面的拦截规则，未手动授权的情况下会直接阻断启动。

按照以下步骤逐一调整即可：

1. 修正基础配置与启动逻辑 #

首先删掉<application>标签上无效的android:launchMode="singleInstance"配置，该属性只有配置在<activity>标签下才会生效，写在application层可能引发不可预期的兼容问题。
然后修改启动应用的方法，补全Intent标记，同时改用Application上下文避免Activity销毁后引发异常：

fun bringAppToFront(){
    val intent = Intent(applicationContext, MainActivity::class.java).apply {
        flags = Intent.FLAG_ACTIVITY_NEW_TASK or
                Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED or
                Intent.FLAG_ACTIVITY_REORDER_TO_FRONT
    }
    applicationContext.startActivity(intent)
}

2. 适配高版本Android后台启动限制 #

原生Android从API29开始仅允许特定场景的后台Activity启动，普通应用选以下一种方案适配即可：

方案A：高优先级全屏通知（兼容性最优，无需特殊权限） #

使用全屏通知是官方推荐的后台唤起方案，效果和来电、闹钟提醒一致，既可以直接拉起应用到前台，也会在通知栏保留入口供用户手动点击，仅需要申请通知权限（Android13+需动态申请POST_NOTIFICATIONS）。
替换你didEnterRegion中的直接唤起逻辑为通知唤起：

override fun didEnterRegion(region: Region?) {
    Log.d(TAG, "did enter region.")
    // 构建跳转Intent
    val launchIntent = Intent(applicationContext, MainActivity::class.java).apply {
        flags = Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TOP
    }
    val pendingIntent = PendingIntent.getActivity(
        applicationContext,
        0,
        launchIntent,
        PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
    )

    // 初始化通知管理器与渠道（Android8+必须创建通知渠道）
    val notificationManager = getSystemService(NotificationManager::class.java)
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        val alertChannel = NotificationChannel(
            "beacon_alert",
            "信标检测提醒",
            NotificationManager.IMPORTANCE_HIGH
        )
        notificationManager.createNotificationChannel(alertChannel)
    }

    // 构建高优先级全屏通知
    val notification = NotificationCompat.Builder(applicationContext, "beacon_alert")
        .setSmallIcon(R.mipmap.ic_launcher)
        .setContentTitle("检测到目标信标")
        .setContentText("点击返回应用")
        .setPriority(NotificationCompat.PRIORITY_HIGH)
        .setCategory(NotificationCompat.CATEGORY_ALARM)
        .setFullScreenIntent(pendingIntent, true)
        .setAutoCancel(true)
        .build()

    notificationManager.notify(1001, notification)

    runOnUiThread {
        Toast.makeText(this@MainActivity, "Beacon found", Toast.LENGTH_SHORT).show()
    }
}

方案B：申请悬浮窗权限（适合必须无操作直接唤起的场景） #

拥有悬浮窗权限的应用不受后台启动Activity限制，可以直接调用修改后的bringAppToFront()方法唤起应用。需要在启动扫描前引导用户手动授权：

// Android6+检查悬浮窗权限
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M && !Settings.canDrawOverlays(this)) {
    val permIntent = Intent(
        Settings.ACTION_MANAGE_OVERLAY_PERMISSION,
        Uri.parse("package:$packageName")
    )
    startActivityForResult(permIntent, 1002)
}

用户授权后即可正常后台唤起。

3. 国产ROM额外适配 #

小米、华为、OPPO、vivo等国产ROM会在原生系统限制之外增加自启动、后台弹出界面的额外拦截，需要在应用中增加引导页，提示用户手动开启以下权限：

• 自启动权限
• 后台弹出界面权限
• 后台活动无限制权限
  否则即使完成上述适配，在部分机型上依然会被系统拦截。

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