Android 9 TV真机重启APP无法自启，模拟器正常问题排查

问题背景 #

开发的Android 9应用在TV模拟器中重启后，可通过AssistantReceiver正常接收ACTION_BOOT_COMPLETED广播并自动启动；但在真实Android 9 TV设备上，重启后应用无法自动打开，推测广播接收器未正常工作。

相关代码及配置 #

AssistantReceiver.java #

public class AssistantReceiver extends BroadcastReceiver {    
    @Override
    public void onReceive(Context context, Intent intent) {
        if (intent.getAction().equals(Intent.ACTION_BOOT_COMPLETED))
            context.startActivity(context.getPackageManager().getLaunchIntentForPackage(context.getPackageName()));
    }
}

AndroidManifest.xml #

<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/Theme.App">
        <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>
        <receiver
            android:name=".AssistantReceiver"
            android:exported="true">
            <intent-filter>
                <action android:name="android.intent.action.BOOT_COMPLETED" />
            </intent-filter>
        </receiver>
    </application>
</manifest>

差异原因及遗漏配置分析 #

• 应用未被手动启动过：Android 3.1及以上系统有强制限制，新安装的应用必须被用户手动启动一次，才能接收开机广播。模拟器中你可能已经手动打开过应用，但真机若首次安装后直接重启，接收器不会触发。解决：先手动打开一次应用，再重启测试。
• TV设备的后台权限限制：多数Android TV厂商会做后台优化，默认禁止未加入白名单的应用接收开机广播。需要在设备的「应用管理」中开启对应应用的「自启动权限」，同时关闭「省电模式」「后台冻结」等限制项。
• 启动Activity缺少必要标记：在BroadcastReceiver中启动Activity必须添加FLAG_ACTIVITY_NEW_TASK标记，否则真机可能因上下文栈问题启动失败。修改代码如下：

  if (intent.getAction().equals(Intent.ACTION_BOOT_COMPLETED)) {
      Intent launchIntent = context.getPackageManager().getLaunchIntentForPackage(context.getPackageName());
      if (launchIntent != null) {
          launchIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
          context.startActivity(launchIntent);
      }
  }
  

• 广播接收器优先级不足：部分真机中，系统会优先分发广播给优先级高的接收器，可在intent-filter中添加最高优先级配置：

  <receiver
      android:name=".AssistantReceiver"
      android:exported="true">
      <intent-filter android:priority="1000">
          <action android:name="android.intent.action.BOOT_COMPLETED" />
      </intent-filter>
  </receiver>
  

• 系统初始化延迟导致Intent获取失败：部分真机发送ACTION_BOOT_COMPLETED时，PackageManager尚未完全初始化，会导致getLaunchIntentForPackage返回null。可添加延迟处理：

  if (intent.getAction().equals(Intent.ACTION_BOOT_COMPLETED)) {
      new Handler(Looper.getMainLooper()).postDelayed(() -> {
          Intent launchIntent = context.getPackageManager().getLaunchIntentForPackage(context.getPackageName());
          if (launchIntent != null) {
              launchIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
              context.startActivity(launchIntent);
          }
      }, 2000);
  }
  

总结 #

优先排查应用是否被手动启动过、真机的自启动权限是否开启；其次修复启动Activity的标记缺失问题，最后再考虑广播优先级和延迟处理的优化。

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