Platform notes

The package includes native libraries for all five targets below and is validated with Unity 6.3 LTS (6000.3.24f1) and 6.6 (6000.6.4f1).

Native builds and package audits cover every target. Representative Unity binding acceptance includes 39 managed tests, macOS ARM64 and x86_64 IL2CPP players, high managed stripping, domain reload disabled, and real GATT operations on macOS and a physical iPhone. SimpleBLE's native backends are tested separately.

iOS simulators, Mac Catalyst, tvOS, Linux ARM64, WebGL and consoles are outside this package's target set. Background Bluetooth behavior depends on the OS and the consuming application's configuration.

Windows

Turn on Bluetooth in Windows before scanning. Both the Editor and the built player use the host's Bluetooth adapter.

macOS

In Project Settings > Player > macOS > Other Settings, set the minimum version to 14.0 or later and provide a Bluetooth Usage Description explaining your app's use of Bluetooth. The package checks both settings before building and writes the description to NSBluetoothAlwaysUsageDescription in the player's Info.plist. Sandboxed applications also need the Bluetooth entitlement (com.apple.security.device.bluetooth) in their signing configuration.

Call await Bluetooth.InitializeAsync() on Unity's main thread before getting adapters. Allow Bluetooth access when macOS prompts. If access was denied, check System Settings > Privacy & Security > Bluetooth. Editor permission belongs to Unity itself; the project's usage description configures its built player. Verify the installed Editor's Info.plist contains a Bluetooth usage description before scanning hardware.

The macOS Editor uses the host's CoreBluetooth backend, including when iOS is the selected build target. Test an iOS player's behavior on the physical device.

iOS

Install iOS Build Support, select iOS in Build Profiles, and set the minimum iOS version to 15.0 or later with Device SDK selected. Use IL2CPP and a physical ARM64 iPhone or iPad. The package rejects simulator builds.

The build callback links Foundation and CoreBluetooth into UnityFramework and adds NSBluetoothAlwaysUsageDescription to the exported Info.plist if absent. Replace the default description with your app's actual use of Bluetooth before deploying; an existing nonempty description is preserved. Background Bluetooth modes are not enabled automatically.

Open the exported Unity-iPhone.xcodeproj in Xcode, select your development team under Signing & Capabilities, select a connected device, then build and run. Call await Bluetooth.InitializeAsync() before getting adapters. CoreBluetooth requests consent when the native adapter is first created; InitializeAsync does not display the Apple permission dialog itself.

Keep both managed DLLs and their platform importer settings. macOS uses the dynamic binding; iOS uses the binding compiled for static linking to __Internal. Only one is enabled for each target. Test scanning, connection, GATT operations, notifications, disconnection and cleanup on actual hardware before distribution.

Android

In the Android Player settings, select IL2CPP, enable ARM64, and set the minimum API level to Android 12 (API 31) or later. Install the build on a device with BLE hardware.

Bluetooth.InitializeAsync() requests BLUETOOTH_SCAN and BLUETOOTH_CONNECT. When hosting a local peripheral, call it with advertise: true to request BLUETOOTH_ADVERTISE as well. The package supplies the manifest declarations. Denied permissions raise UnauthorizedAccessException; the user can grant them in the app's Android settings before retrying.

The manifest uses neverForLocation for scanning. Android can filter some BLE beacons with this setting. If your application derives location from scans, configure its location permissions and manifest for that use case instead.

An Android build selected in the Windows Editor still uses the Windows Bluetooth backend during Play mode. Run the player on the Android device to use its radio.

Linux

Install the distribution's bluez and libdbus-1-3 packages, ensure the system D-Bus and Bluetooth services are running, and enable the adapter before scanning. For example, check systemctl status bluetooth and bluetoothctl show. The Editor and player use the host's BlueZ adapter and system D-Bus access policy; Bluetooth.InitializeAsync() does not install services or grant Linux permissions.

Select Linux x86_64 as the player target. For IL2CPP builds, install Unity's Linux Build Support (IL2CPP) module. Both Linux plugins must be included: libsimplecble.so and libsimpleble.so. Keep them together in the built player's *_Data/Plugins/x86_64 directory. D-Bus and the C/C++ runtimes come from the OS. Do not rename the plugins or replace them with versioned symlinks.

The native build baseline is Ubuntu 22.04. Unity's 6.3 requirements and 6.6 requirements list Ubuntu 22.04 and 24.04 for desktop Linux. Other distributions and Linux ARM64 are not part of this package's current validation scope.