DFU over USB support for Android (betaflight#4990)

Author: haslinghuis

DFU_ANDROID_IMPLEMENTATION.md

@@ -50,6 +50,15 @@
                 <action android:name="com.betaflight.USB_PERMISSION" />
             </intent-filter>
         </receiver>
+
+        <!-- Explicit receiver for DFU USB permission on Android 14+ -->
+        <receiver
+            android:name="betaflight.app.protocols.dfu.DfuUsbPermissionReceiver"
+            android:exported="false">
+            <intent-filter>
+                <action android:name="com.betaflight.DFU_USB_PERMISSION" />
+            </intent-filter>
+        </receiver>
     </application>
 
     <!-- Permissions -->

android/app/src/main/AndroidManifest.xml

@@ -1,18 +1,43 @@
 package betaflight.app;
 
+import android.content.Intent;
+import android.hardware.usb.UsbManager;
 import android.os.Bundle;
 
 import betaflight.app.protocols.serial.BetaflightSerialPlugin;
 import com.getcapacitor.BridgeActivity;
 import betaflight.app.protocols.tcp.BetaflightTcpPlugin;
 import betaflight.app.protocols.ble.BetaflightBlePlugin;
+import betaflight.app.protocols.dfu.BetaflightDfuPlugin;
 
 public class MainActivity extends BridgeActivity {
   @Override
   public void onCreate(Bundle savedInstanceState) {
     registerPlugin(BetaflightSerialPlugin.class);
     registerPlugin(BetaflightBlePlugin.class);
     registerPlugin(BetaflightTcpPlugin.class);
+    registerPlugin(BetaflightDfuPlugin.class);
+
+    // If started or recreated by a USB device attachment intent (e.g. the FC
+    // re-enumerates after DFU flash), replace it with a plain launcher intent
+    // BEFORE super.onCreate → BridgeActivity.load() processes it.
+    // USB events are already handled by plugin BroadcastReceivers; without this
+    // guard, Capacitor recreates the WebView and the app appears to restart.
+    if (getIntent() != null
+        && UsbManager.ACTION_USB_DEVICE_ATTACHED.equals(getIntent().getAction())) {
+      setIntent(new Intent(Intent.ACTION_MAIN).addCategory(Intent.CATEGORY_LAUNCHER));
+    }
+
     super.onCreate(savedInstanceState);
   }
+
+  @Override
+  protected void onNewIntent(Intent intent) {
+    if (intent != null
+        && UsbManager.ACTION_USB_DEVICE_ATTACHED.equals(intent.getAction())) {
+      setIntent(intent);
+      return;
+    }
+    super.onNewIntent(intent);
+  }
 }