Android应用AutoStart需上滑唤醒才生效，如何优化及实现Kiosk模式？

我正在基于Kotlin、SDK 33开发Android应用，当前实现的AutoStart模式仅在用户从待机屏幕上滑退出待机状态时生效。请问需修改哪些代码才能让设备无需上滑直接启动应用？另外我还需实现Kiosk模式以限制仅使用该应用，是否Kiosk模式可完善AutoStart功能？

Manifest 代码：

<receiver
    android:name=".receiver.BootReceiver"
    android:enabled="true"
    android:exported="false">
    <intent-filter>
        <action android:name="android.intent.action.BOOT_COMPLETED" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</receiver>

Boot Receiver 代码：

class BootReceiver : BroadcastReceiver() {
    override fun onReceive(context: Context?, intent: Intent?) {
        if (intent?.action.equals(Intent.ACTION_BOOT_COMPLETED)) {
            val launchIntent = Intent(context, MainActivity::class.java)
            launchIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
            context?.startActivity(launchIntent)
        }
    }
}

一、实现无需上滑直接启动应用 #

当前代码仅监听BOOT_COMPLETED广播，但Android 10+（SDK 29及以上）系统启动后直接进入锁屏，startActivity无法直接唤醒屏幕并绕过锁屏，需做以下修改：

1. 添加必要权限
   在Manifest中补充权限：

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

2. 更新BootReceiver逻辑
   启动Activity前先处理屏幕唤醒与锁屏解除：

class BootReceiver : BroadcastReceiver() {
    override fun onReceive(context: Context?, intent: Intent?) {
        if (intent?.action == Intent.ACTION_BOOT_COMPLETED) {
            context?.let { ctx ->
                // 解除锁屏（适配Android 11及以下）
                val keyguardManager = ctx.getSystemService(Context.KEYGUARD_SERVICE) as KeyguardManager
                keyguardManager.requestDismissKeyguard(null, null)

                // 唤醒屏幕
                val powerManager = ctx.getSystemService(Context.POWER_SERVICE) as PowerManager
                val wakeLock = powerManager.newWakeLock(
                    PowerManager.FULL_WAKE_LOCK or PowerManager.ACQUIRE_CAUSES_WAKEUP,
                    "MyApp:WakeLockTag"
                )
                wakeLock.acquire(10000) // 持有10秒足够应用启动

                // 启动主Activity，添加额外Flags确保栈顶显示
                val launchIntent = Intent(ctx, MainActivity::class.java)
                launchIntent.addFlags(
                    Intent.FLAG_ACTIVITY_NEW_TASK or
                    Intent.FLAG_ACTIVITY_CLEAR_TOP or
                    Intent.FLAG_ACTIVITY_EXCLUDE_FROM_RECENTS
                )
                ctx.startActivity(launchIntent)

                // 释放唤醒锁
                if (wakeLock.isHeld) {
                    wakeLock.release()
                }
            }
        }
    }
}

3. 适配Android 12+（SDK 31+）
   Android 12及以上DISABLE_KEYGUARD权限废弃，需在MainActivity的Manifest声明中添加属性：

<activity
    android:name=".MainActivity"
    android:showWhenLocked="true"
    android:turnScreenOn="true">
    <!-- 其他原有配置 -->
</activity>

同时在MainActivity的onCreate中补充逻辑：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // 适配Android 12+的锁屏解锁
    setShowWhenLocked(true)
    setTurnScreenOn(true)
    val keyguardManager = getSystemService(Context.KEYGUARD_SERVICE) as KeyguardManager
    keyguardManager.requestDismissKeyguard(this, null)
}

二、Kiosk模式对AutoStart的完善作用 #

Kiosk模式（单应用锁定模式）不仅能限制用户仅使用你的应用，还能从系统层面强化AutoStart效果：

• 自动启动保障：设备重启后，系统会自动拉起指定的Kiosk应用，无需依赖BOOT_COMPLETED广播的自定义处理，启动可靠性更高。
• 绕过锁屏：开启Kiosk模式后，多数设备（尤其是定制化系统如EMUI、MIUI）会直接跳过锁屏进入应用，无需额外处理唤醒与解锁逻辑。
• 持久前台锁定：Kiosk模式会禁用Home键、Recent键，用户无法退出应用，确保应用始终处于前台，完美匹配AutoStart的需求。

实现Kiosk模式核心步骤 #

1. 添加设备管理员组件
   在Manifest中注册设备管理员接收器：

<receiver
    android:name=".receiver.DeviceAdminReceiver"
    android:permission="android.permission.BIND_DEVICE_ADMIN">
    <meta-data
        android:name="android.app.device_admin"
        android:resource="@xml/device_admin" />
    <intent-filter>
        <action android:name="android.app.action.DEVICE_ADMIN_ENABLED" />
    </intent-filter>
</receiver>

创建res/xml/device_admin.xml配置文件：

<device-admin xmlns:android="http://schemas.android.com/apk/res/android">
    <uses-policies>
        <limit-password />
        <force-lock />
        <wipe-data />
    </uses-policies>
</device-admin>

2. 启用单应用锁定模式
   在应用中请求设备管理员权限后，开启Kiosk模式：

private const val REQUEST_CODE_ENABLE_ADMIN = 1001

// 调用此方法启动Kiosk模式配置
fun setupKioskMode() {
    val devicePolicyManager = getSystemService(Context.DEVICE_POLICY_SERVICE) as DevicePolicyManager
    val componentName = ComponentName(this, DeviceAdminReceiver::class.java)

    if (devicePolicyManager.isAdminActive(componentName)) {
        // 已获取权限，启用单应用锁定
        val intent = Intent(DevicePolicyManager.ACTION_SET_LOCK_TASK_PACKAGE)
        intent.putExtra(DevicePolicyManager.EXTRA_PACKAGE_NAME, packageName)
        startActivity(intent)
        // 启动锁定任务
        startLockTask()
    } else {
        // 请求设备管理员权限
        val intent = Intent(DevicePolicyManager.ACTION_ADD_DEVICE_ADMIN)
        intent.putExtra(DevicePolicyManager.EXTRA_DEVICE_ADMIN, componentName)
        intent.putExtra(DevicePolicyManager.EXTRA_ADD_EXPLANATION, "需要设备管理员权限以启用Kiosk模式")
        startActivityForResult(intent, REQUEST_CODE_ENABLE_ADMIN)
    }
}

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