summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorTimur Pocheptsov <timur.pocheptsov@qt.io>2021-09-07 14:44:09 +0200
committerTimur Pocheptsov <timur.pocheptsov@qt.io>2021-09-07 16:11:57 +0200
commit5953696dbd294918baf33b26ccad526d3332f967 (patch)
treeb9d89028c30f7bff824a7c3e337751b8a8f22099
parent0e836b5a8b6d7c659a9540e2718918f8cfc28279 (diff)
Bluetooth docs: mention the Apple's specific requirements
Info.plist with a textual description of why and what Bluetooth is needed for by a Qt-based app is required on iOS. Pick-to: 5.15 6.2 Change-Id: If838b57d6c13da9aeaf436dd013bd8496984a8bb Reviewed-by: Alex Blasche <alexander.blasche@qt.io> Reviewed-by: Andreas Buhr <andreas.buhr@qt.io>
-rw-r--r--src/bluetooth/doc/src/bluetooth-le-overview.qdoc10
1 files changed, 10 insertions, 0 deletions
diff --git a/src/bluetooth/doc/src/bluetooth-le-overview.qdoc b/src/bluetooth/doc/src/bluetooth-le-overview.qdoc
index 2f6c4c91..6adc7b25 100644
--- a/src/bluetooth/doc/src/bluetooth-le-overview.qdoc
+++ b/src/bluetooth/doc/src/bluetooth-le-overview.qdoc
@@ -286,4 +286,14 @@ Low Energy devices.
In general characteristic and descriptor value updates on the peripheral device use the same
methods as connecting Bluetooth Low Energy devices.
+
+ \note To use QtBluetooth (in both central and peripheral roles) on iOS, you have to provide an Info.plist
+ file containing the usage description. According to the CoreBluetooth's documentation:
+
+ "Important
+
+ Your app will crash if its Info.plist doesn’t include usage description keys for the types of data
+ it needs to access. To access Core Bluetooth APIs on apps linked on or after iOS 13, include the
+ NSBluetoothAlwaysUsageDescription key. In iOS 12 and earlier, include NSBluetoothPeripheralUsageDescription
+ to access Bluetooth peripheral data."
*/