Android应用默认启用自启动及BOOT_COMPLETED广播接收器问题排查

已在AndroidManifest.xml中声明RECEIVE_BOOT_COMPLETED权限并配置AlarmBroadcastReceiver，但设备重启后必须手动启动一次应用，接收器才能正常工作。同时希望实现应用默认启用自启动权限，无需用户手动操作。

现有代码 #

AndroidManifest.xml片段 #

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:dist="http://schemas.android.com/apk/distribution"
    xmlns:tools="http://schemas.android.com/tools">

    <uses-sdk />

    <dist:module dist:instant="true" />

    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
    <!-- 其他权限省略 -->

    <application
        android:name=".HealthCareApp"
        android:allowBackup="true"
        android:fullBackupContent="@xml/backup_rules"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:networkSecurityConfig="@xml/network_security_config"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme"
        tools:targetApi="n">

        <receiver
            android:name=".feature.scheduler.services.AlarmBroadcastReceiver"
            android:exported="false">
            <intent-filter>
                <action android:name="android.intent.action.BOOT_COMPLETED" />
                <action android:name="android.intent.action.MY_PACKAGE_REPLACED" />
                <action android:name="android.intent.action.TIMEZONE_CHANGED" />
            </intent-filter>
        </receiver>

    </application>

</manifest>

AlarmBroadcastReceiver代码 #

@AndroidEntryPoint
class AlarmBroadcastReceiver : BroadcastReceiver() {
    @Inject
    lateinit var stateManager: StateManager
    override fun onReceive(context: Context?, intent: Intent?) {
        when (intent?.action) {
            ACTION_MY_PACKAGE_REPLACED -> {
                startRescheduleAlarmsService(context!!)
            }

            ACTION_BOOT_COMPLETED -> {
                startRescheduleAlarmsService(context!!)
            }
        }
    }

    private fun startRescheduleAlarmsService(context: Context) {
        Log.d("TAG", "startRescheduleAlarmsService: ")
        val toastText = String.format("Alarm Reboot")
        Toast.makeText(context, toastText, Toast.LENGTH_SHORT).show()
        stateManager.rescheduleAlarm(context)
    }
}

解决方案 #

1. 修复BroadcastReceiver的exported属性 #

BOOT_COMPLETED是系统发送的隐式广播，Android 12（API 31）及以上版本要求接收此类系统隐式广播的接收器必须设置android:exported="true"，否则系统无法将广播传递给应用。修改Manifest中的接收器配置：

<receiver
    android:name=".feature.scheduler.services.AlarmBroadcastReceiver"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.BOOT_COMPLETED" />
        <action android:name="android.intent.action.MY_PACKAGE_REPLACED" />
        <action android:name="android.intent.action.TIMEZONE_CHANGED" />
    </intent-filter>
</receiver>

2. 适配Android 10+的启动限制 #

从Android 10（API 29）开始，从未启动过的应用即使声明了RECEIVE_BOOT_COMPLETED权限，也无法接收BOOT_COMPLETED广播。这是系统的安全和省电策略，无法绕过：

• 首次安装应用后，必须由用户手动启动一次，后续重启设备才能正常触发广播。
• 可以在应用首次启动时引导用户完成初始化，确保广播接收器处于可用状态。

3. 自启动权限的处理（无法默认开启） #

各Android厂商（如Realme、小米、华为等）的自启动权限属于定制化的省电/隐私策略，没有公开API可以自动为应用开启该权限。只能通过以下方式优化用户体验：

• 在应用首次启动时，弹窗说明开启自启动权限的必要性，引导用户手动跳转至对应设置页面。
• 跳转自启动设置页面的示例代码：

fun openAutoStartSettings(context: Context) {
    val intent = Intent()
    val packageName = context.packageName
    when {
        // Realme/Oppo
        Build.MANUFACTURER.lowercase().contains("realme") || Build.MANUFACTURER.lowercase().contains("oppo") -> {
            intent.setClassName("com.coloros.safecenter", "com.coloros.safecenter.permission.startup.StartupAppListActivity")
        }
        // 小米
        Build.MANUFACTURER.lowercase().contains("xiaomi") -> {
            intent.setClassName("com.miui.securitycenter", "com.miui.permcenter.autostart.AutoStartManagementActivity")
        }
        // 华为
        Build.MANUFACTURER.lowercase().contains("huawei") -> {
            intent.setClassName("com.huawei.systemmanager", "com.huawei.systemmanager.startupmgr.ui.StartupNormalAppListActivity")
        }
        // 其他厂商可补充对应包名和类名
        else -> {
            intent.action = Settings.ACTION_APPLICATION_DETAILS_SETTINGS
            intent.data = Uri.fromParts("package", packageName, null)
        }
    }
    try {
        context.startActivity(intent)
    } catch (e: ActivityNotFoundException) {
        // 跳转失败时打开应用详情页
        intent.action = Settings.ACTION_APPLICATION_DETAILS_SETTINGS
        intent.data = Uri.fromParts("package", packageName, null)
        context.startActivity(intent)
    }
}

注：部分厂商的自启动设置页面路径可能会随系统版本变更，需要针对不同机型和系统版本做适配测试。

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