Add the ability to specify bluetooth permission

changes/2522.feature.rst

@@ -0,0 +1 @@
+Add the ability to specify bluetooth permission.

docs/reference/configuration.rst

@@ -555,6 +555,10 @@ starting from least to most specific, with the most specific taking priority.
 
 Briefcase maintains a set of cross-platform permissions:
 
+.. attribute:: permission.bluetooth
+
+Permission to connect to an external device via Bluetooth.
+
 .. attribute:: permission.camera
 
 Permission to access the camera to take photos or video.

src/briefcase/commands/create.py

@@ -188,6 +188,7 @@ def _x_permissions(self, app: AppConfig):
         return {
             key: app.permission.pop(key, None)
             for key in [
+                "bluetooth",
                 "camera",
                 "microphone",
                 "coarse_location",

src/briefcase/platforms/android/gradle.py

@@ -245,6 +245,12 @@ def permissions_context(self, app: AppConfig, x_permissions: dict[str, str]):
         # Default feature usage for all Android apps
         features = {}
 
+        if x_permissions["bluetooth"]:
+            permissions["android.permission.BLUETOOTH"] = True
+            permissions["android.permission.BLUETOOTH_ADMIN"] = True
+            permissions["android.permission.BLUETOOTH_CONNECT"] = True
+            permissions["android.permission.BLUETOOTH_SCAN"] = True
+
         if x_permissions["camera"]:
             permissions["android.permission.CAMERA"] = True
             features["android.hardware.camera"] = False

tests/platforms/android/gradle/test_create.py

@@ -421,6 +421,24 @@ def test_extract_packages(create_command, first_app_config, test_sources, expect
                 "features": {},
             },
         ),
+        # Bluetooth permissions
+        (
+            {
+                "bluetooth": "I need to connect to bluetooth device",
+            },
+            {},
+            {
+                "permissions": {
+                    "android.permission.ACCESS_NETWORK_STATE": True,
+                    "android.permission.BLUETOOTH": True,
+                    "android.permission.BLUETOOTH_ADMIN": True,
+                    "android.permission.BLUETOOTH_CONNECT": True,
+                    "android.permission.BLUETOOTH_SCAN": True,
+                    "android.permission.INTERNET": True,
+                },
+                "features": {},
+            },
+        ),
         # Override and augment by cross-platform definitions
         (
             {