如何避免USB设备触发Android Activity的重复暂停/恢复周期？

配置了singleInstance启动模式的MainActivity，首次插入USB设备时系统提示选择应用符合预期，但设备拔出后重新插入，前台的MainActivity会连续触发三次暂停/恢复循环。

问题根源 #

1. Intent Filter冲突：主启动入口（MAIN/LAUNCHER）与USB设备连接（USB_DEVICE_ATTACHED）的Action共用同一个Intent Filter，导致系统处理USB事件时多次匹配该Filter，触发Activity调度。
2. singleInstance调度特性：该启动模式下Activity处于独立任务栈，系统每次发送USB Intent时都会触发任务栈前台调度，叠加重复Intent后放大了生命周期回调次数。

解决方案 #

1. 拆分Intent Filter，消除匹配冲突 #

将应用启动入口和USB设备连接的Intent Filter分开，避免系统重复匹配包含LAUNCHER的Filter：

<activity
    android:name=".MainActivity"
    android:configChanges="orientation|keyboardHidden|screenSize"
    android:directBootAware="true"
    android:exported="true"
    android:icon="@mipmap/ic_launcher_round"
    android:launchMode="singleInstance">
    <!-- 仅作为应用启动入口的Filter -->
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
    <!-- 单独处理USB设备连接的Filter -->
    <intent-filter>
        <action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
    </intent-filter>

    <meta-data
        android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED"
        android:resource="@xml/usb_device_filter" />
</activity>

2. 代码层过滤重复USB Intent #

利用onNewIntent()接收USB Intent，添加重复请求判断，避免触发不必要的生命周期回调：

public class MainActivity extends AppCompatActivity {
    private boolean isCurrentUsbHandled = false;
    private UsbDevice lastHandledDevice;

    @Override
    protected void onNewIntent(Intent intent) {
        super.onNewIntent(intent);
        String action = intent.getAction();
        if (Intent.ACTION_USB_DEVICE_ATTACHED.equals(action)) {
            UsbDevice currentDevice = intent.getParcelableExtra(UsbManager.EXTRA_DEVICE);
            // 过滤同一设备的重复请求
            if (currentDevice != null && !isCurrentUsbHandled && !currentDevice.equals(lastHandledDevice)) {
                processUsbDevice(currentDevice);
                lastHandledDevice = currentDevice;
                isCurrentUsbHandled = true;
            }
            // 延迟重置标记，不影响下次设备连接
            new Handler(Looper.getMainLooper()).postDelayed(() -> {
                isCurrentUsbHandled = false;
                lastHandledDevice = null;
            }, 1500);
        }
    }

    @Override
    protected void onResume() {
        super.onResume();
        // 页面恢复时重置状态标记
        isCurrentUsbHandled = false;
    }

    private void processUsbDevice(UsbDevice device) {
        // 你的USB设备业务处理逻辑
    }
}

3. 调整启动模式（可选） #

如果业务场景允许，将singleInstance改为singleTask。该模式同样保证单实例，但任务栈调度逻辑更灵活，能减少独立任务栈带来的额外系统回调：

android:launchMode="singleTask"

总结 #

通过拆分Intent Filter减少系统匹配冲突、代码层过滤重复Intent、调整启动模式这几种方式，可有效避免USB设备重插时出现的无意义暂停/恢复循环。

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