ios: improve BT alert message

On iOS, Bluetooth can be “off” for two different reasons:

1. System Bluetooth is turned off

2. Bluetooth permission is disabled specifically for BitBoxApp

This commit adds logic to distinguish between these cases and
shows the appropriate message for each.

Author: shonsirsha

CHANGELOG.md

@@ -10,6 +10,7 @@
 - Android: fix display of external links from Bitrefill
 - fix language sometimes not persistent across app restarts
 - Android: make the UI work with responsive font sizes and adhere to OS font size settings 
+- iOS: show different messages when Bluetooth is off vs. when Bluetooth permission for BitBoxApp is disabled.
 
 ## v4.49.0
 - Bundle BitBox02 Nova firmware version v9.24.0

backend/backend.go

@@ -112,6 +112,8 @@ var fixedURLWhitelist = []string{
 	"https://bitcoincore.org/en/2016/01/26/segwit-benefits/",
 	"https://en.bitcoin.it/wiki/Bech32_adoption",
 	"https://github.com/bitcoin/bips/",
+	// iOS app settings
+	"app-settings:",
 	// Others
 	"https://cointracking.info/import/bitbox/",
 }

backend/devices/bluetooth/bluetooth.go

@@ -69,6 +69,8 @@ type Peripheral struct {
 type State struct {
 	// BluetoothAvailable is false if bluetooth is powered off or otherwise unavailable.
 	BluetoothAvailable bool `json:"bluetoothAvailable"`
+	// BluetoothUnauthorized is true if the app does not have permission to use Bluetooth.
+	BluetoothUnauthorized bool `json:"bluetoothUnauthorized"`
 	// Scanning is true if we are currently scanning for peripherals.
 	Scanning    bool          `json:"scanning"`
 	Peripherals []*Peripheral `json:"peripherals"`

frontends/ios/BitBoxApp/BitBoxApp/BitBoxAppApp.swift

@@ -117,20 +117,29 @@ class GoEnvironment: NSObject, MobileserverGoEnvironmentInterfaceProtocol, UIDoc
 
     func systemOpen(_ urlString: String?) throws {
         guard let urlString = urlString else { return }
-        // Check if it's a local file path (not a URL)
-        var url: URL
-        if urlString.hasPrefix("/") {
-            // This is a local file path, construct a file URL
-            url = URL(fileURLWithPath: urlString)
-        } else if let potentialURL = URL(string: urlString), potentialURL.scheme != nil {
-            // This is already a valid URL with a scheme
-            url = potentialURL
-        } else {
-            // Invalid URL or path
-            return
-        }
-        // Ensure we run on the main thread
+
         DispatchQueue.main.async {
+            if urlString == "app-settings:" {
+                if let url = URL(string: UIApplication.openSettingsURLString) {
+                    // opens app settings page in the system settings
+                    UIApplication.shared.open(url)
+                }
+                return
+            }
+
+            // Check if it's a local file path (not a URL)
+            var url: URL
+            if urlString.hasPrefix("/") {
+                // This is a local file path, construct a file URL
+                url = URL(fileURLWithPath: urlString)
+            } else if let potentialURL = URL(string: urlString), potentialURL.scheme != nil {
+                // This is already a valid URL with a scheme
+                url = potentialURL
+            } else {
+                // Invalid URL or path
+                return
+            }
+
             if url.isFileURL {
                 // Local file path, use UIDocumentInteractionController
                 if let rootViewController = self.getRootViewController() {

frontends/ios/BitBoxApp/BitBoxApp/Bluetooth.swift

@@ -30,6 +30,7 @@ enum ConnectionState: String, Codable {
 
 struct State {
     var bluetoothAvailable: Bool
+    var bluetoothUnauthorized: Bool
     var scanning: Bool
     var discoveredPeripherals: [UUID: PeripheralMetadata]
 }
@@ -61,6 +62,7 @@ class BLEConnectionContext {
 class BluetoothManager: NSObject, ObservableObject, CBCentralManagerDelegate, CBPeripheralDelegate {
     private var state: State = State(
         bluetoothAvailable: false,
+        bluetoothUnauthorized: false,
         scanning: false,
         discoveredPeripherals: [:]
     )
@@ -124,12 +126,25 @@ class BluetoothManager: NSObject, ObservableObject, CBCentralManagerDelegate, CB
 
     func centralManagerDidUpdateState(_ central: CBCentralManager) {
         state.bluetoothAvailable = centralManager.state == .poweredOn
+
+        if #available(iOS 13.0, *) {
+            // user denied BT permission,
+            // or restricted by device policy
+            let authorization = CBManager.authorization
+            state.bluetoothUnauthorized = (authorization == .denied || authorization == .restricted)
+        }
+
         updateBackendState()
 
         switch central.state {
         case .poweredOn:
-            print("BLE: on")
-            restartScan()
+            if state.bluetoothUnauthorized {
+                print("BLE: on but permission denied")
+                handleDisconnect()
+            } else {
+                print("BLE: on")
+                restartScan()
+            }
         case .poweredOff, .unauthorized, .unsupported, .resetting, .unknown:
             print("BLE: unavailable or not supported")
             handleDisconnect()
@@ -409,6 +424,7 @@ class BluetoothManager: NSObject, ObservableObject, CBCentralManagerDelegate, CB
 
         struct StateJSON: Codable {
             let bluetoothAvailable: Bool
+            let bluetoothUnauthorized: Bool
             let scanning: Bool
             let peripherals: [PeripheralJSON]
         }
@@ -425,6 +441,7 @@ class BluetoothManager: NSObject, ObservableObject, CBCentralManagerDelegate, CB
 
         let state = StateJSON(
             bluetoothAvailable: state.bluetoothAvailable,
+            bluetoothUnauthorized: state.bluetoothUnauthorized,
             scanning: state.scanning,
             peripherals: peripherals
         )

frontends/web/src/api/bluetooth.ts

@@ -31,11 +31,13 @@ export type TPeripheral = {
 
 type TBluetoothState = {
   bluetoothAvailable: boolean;
+  bluetoothUnauthorized: boolean;
   scanning: boolean;
   peripherals: TPeripheral[];
 };
 
 export const getState = (): Promise<TBluetoothState> => {
+
   return apiGet('bluetooth/state');
 };
 

frontends/web/src/components/bluetooth/bluetooth.module.css

@@ -24,3 +24,20 @@
     text-align: center;
   }
 }
+
+.bluetoothDisabledContainer {
+  align-items: start;
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+
+.bluetoothDisabledTitle {
+  font-weight: 600;
+}
+
+.link {
+  font-weight: 600;
+  margin-top: var(--space-quarter);
+  text-decoration: none;
+}

frontends/web/src/components/bluetooth/bluetooth.tsx

@@ -20,6 +20,7 @@ import { useSync } from '@/hooks/api';
 import { connect, getState, syncState, TPeripheral } from '@/api/bluetooth';
 import { runningInIOS } from '@/utils/env';
 import { Message } from '@/components/message/message';
+import { A } from '@/components/anchor/anchor';
 import { ActionableItem } from '@/components/actionable-item/actionable-item';
 import { Badge } from '@/components/badge/badge';
 import { HorizontallyCenteredSpinner, SpinnerRingAnimated } from '@/components/spinner/SpinnerAnimation';
@@ -68,10 +69,36 @@ const BluetoothInner = ({ peripheralContainerClassName }: Props) => {
   if (!state) {
     return null;
   }
+
+  if (state.bluetoothUnauthorized) {
+    return (
+      <Message type="warning">
+        <div className={styles.bluetoothDisabledContainer}>
+          <span className={styles.bluetoothDisabledTitle}>
+            {t('bluetooth.disabledPermissionTitle')}
+          </span>
+          <span >
+            {t('bluetooth.disabledPermissionDescription')}
+          </span>
+          <A className={styles.link} href="app-settings:">
+            Enable
+          </A>
+        </div>
+      </Message>
+    );
+  }
+
   if (!state.bluetoothAvailable) {
     return (
       <Message type="warning">
-        {t('bluetooth.enable')}
+        <div className={styles.bluetoothDisabledContainer}>
+          <span className={styles.bluetoothDisabledTitle}>
+            {t('bluetooth.disabledGloballyTitle')}
+          </span>
+          <span >
+            {t('bluetooth.disabledGloballyDescription')}
+          </span>
+        </div>
       </Message>
     );
   }

frontends/web/src/locales/en/app.json

@@ -378,7 +378,10 @@
     "connected": "connected",
     "connectionFailed": "failed",
     "connectionIssues": "Having connection issues?",
-    "enable": "Please turn on Bluetooth",
+    "disabledGloballyDescription": "Please turn on Bluetooth to connect to your BitBox.",
+    "disabledGloballyTitle": "Bluetooth access is disabled.",
+    "disabledPermissionDescription": "Please allow Bluetooth to connect to your BitBox.",
+    "disabledPermissionTitle": "Bluetooth access is disabled for BitBoxApp.",
     "select": "Select your BitBox"
   },
   "bootloader": {
@@ -1993,4 +1996,4 @@
     "message": "Please connect your BitBox and tap the side to continue.",
     "title": "Welcome"
   }
-}
+}