理解USB设备连接事件与应用行为
当android应用程序需要与usb设备进行交互时，通常会在其androidmanifest.xml中注册一个intent-filter，以监听android.hardware.usb.action.usb_device_attached广播。这使得系统能够在兼容的usb设备连接时，启动或将应用程序带到前台。
然而，在默认的Activity启动模式下，当应用程序已经在运行中，而同一个（或不同的）USB设备被断开再重新连接时，系统可能会尝试创建一个新的Activity实例来处理传入的USB_DEVICE_ATTACHED意图。这种行为会导致应用程序从用户的角度看像是“重启”了，丢失了当前状态，从而带来不佳的用户体验。
理想的行为是：如果应用程序未运行，则在设备连接时启动；如果应用程序已在运行，则应继续工作，并仅接收到有关新连接的通知，而不是重新启动。
解决方案：配置Activity的launchMode为singleTop
Android Activity的launchMode属性定义了系统如何启动Activity的实例。针对上述问题，将目标Activity的android:launchMode属性设置为singleTop是有效的解决方案。
当一个Activity被设置为singleTop启动模式时，如果该Activity的实例已经在任务栈的顶部，并且系统试图再次启动它（例如，通过一个新的Intent），系统将不会创建该Activity的新实例。相反，它会将新的Intent传递给现有的Activity实例，通过调用其onNewIntent(Intent intent)方法。
这样，应用程序就能在不重启的情况下，接收并处理新的USB连接事件。
android:exported="true">
重要提示：从Android 12 (API level 31) 开始，如果Activity包含 intent-filter 且不属于 android.intent.action.MAIN 或 android.intent.category.LAUNCHER 类别，则必须显式设置 android:exported="true"，否则应用将无法被外部组件（如USB服务）启动。
处理新的USB连接意图：实现onNewIntent()
仅仅设置launchMode="singleTop"是不够的，您还需要在Activity中重写onNewIntent(Intent intent)方法，以实际处理传入的USB连接意图。
在这个方法中，您可以获取到新的Intent，并从中提取USB设备的相关信息（例如通过UsbManager.getDeviceList()或从Intent的extra中获取UsbDevice对象）。然后，您可以根据这些信息更新UI、重新初始化串口连接或执行其他必要的业务逻辑。
import android.content.Intent;
import android.hardware.usb.UsbDevice;
import android.hardware.usb.UsbManager;
import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;
import android.util.Log;
public class YourMainActivity extends AppCompatActivity {
private static final String TAG = "USB_APP";
private UsbManager usbManager;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
usbManager = (UsbManager) getSystemService(USB_SERVICE);
// 初始启动时处理USB连接
handleUsbIntent(getIntent());
}
@Override
protected void onNewIntent(Intent intent) {
super.onNewIntent(intent);
// 将新的Intent设置为当前Activity的Intent，以便后续调用getIntent()获取的是最新的
setIntent(intent);
handleUsbIntent(intent);
}
private void handleUsbIntent(Intent intent) {
if (intent != null) {
String action = intent.getAction();
if (UsbManager.ACTION_USB_DEVICE_ATTACHED.equals(action)) {
UsbDevice device = intent.getParcelableExtra(UsbManager.EXTRA_DEVICE);
if (device != null) {
Log.d(TAG, "USB Device Attached: " + device.getDeviceName());
// 在这里处理USB设备的连接逻辑，例如：
// 1. 检查并请求USB设备权限
// 2. 查找并打开对应的串口设备
// 3. 更新UI显示连接状态
// 4. 重新初始化通信通道
// 示例：请求权限
if (!usbManager.hasPermission(device)) {
// 通常需要一个PendingIntent来处理权限请求结果
// PendingIntent permissionIntent = PendingIntent.getBroadcast(this, 0, new Intent(ACTION_USB_PERMISSION), 0);
// usbManager.requestPermission(device, permissionIntent);
Log.d(TAG, "Requesting permission for device: " + device.getDeviceName());
} else {
Log.d(TAG, "Permission already granted for device: " + device.getDeviceName());
// 设备已连接且有权限，可以开始通信
// 例如：初始化串口
}
}
} else if (UsbManager.ACTION_USB_DEVICE_DETACHED.equals(action)) {
UsbDevice device = intent.getParcelableExtra(UsbManager.EXTRA_DEVICE);
if (device != null) {
Log.d(TAG, "USB Device Detached: " + device.getDeviceName());
// 处理设备断开逻辑，例如关闭串口，更新UI
}
}
}
}
// ... 其他Activity生命周期方法和业务逻辑 ...
}重要提示：在onNewIntent()中调用setIntent(intent)是一个好习惯，它确保了后续对getIntent()的调用会返回最新的Intent，而不是最初启动Activity的Intent。
注意事项与最佳实践
权限管理：与USB设备交互通常需要android.hardware.usb.host特性声明以及用户授予的运行时权限。确保在连接设备前检查并请求权限。权限请求通常通过UsbManager.requestPermission()方法完成，并监听一个自定义的广播来获取用户授权结果。
-
设备过滤：在res/xml/device_filter.xml中定义USB设备过滤器是最佳实践。这允许您指定应用程序感兴趣的USB设备，避免系统向用户显示不必要的应用选择器。
生命周期管理：当Activity被singleTop模式复用时，onCreate()、onStart()等方法不会再次调用，但onNewIntent()会被调用。确保您的USB设备初始化（如打开串口）和释放（如关闭串口）逻辑能够正确地在onCreate()（首次启动）和onNewIntent()（后续意图）中被处理，并在onDestroy()或onStop()等生命周期方法中正确释放资源，以避免内存泄漏或资源占用。
用户体验：即使应用程序没有重启，也应提供清晰的用户反馈，例如通过Toast消息、UI状态更新或日志记录等，告知用户USB设备的连接或断开状态，确保用户了解当前设备的交互情况。
总结
通过将Android Activity的launchMode设置为singleTop，并正确实现onNewIntent()方法，可以有效解决应用程序在处理USB设备连接事件时，因设备重连而导致的意外重启问题。这种方法不仅提升了应用程序的稳定性和用户体验，也使得USB设备的管理更加灵活和高效。在开发涉及USB通信的Android应用程序时，理解并运用Activity的启动模式是至关重要的一环。
