kmp-ble-macos/com.atruedev.kmpble.macos/Macos

Macos

object Macos

macOS CoreBluetooth helpers for the kmp-ble-macos JVM backend.

Properties

const val BACKEND_ID: String

com.atruedev.kmpble.backend.BleBackend.id of this backend, for -Dkmpble.backend=macos.

ERROR_ADAPTER_OFF

const val ERROR_ADAPTER_OFF: Int

Scan / connect error code: the Bluetooth adapter is powered off.

ERROR_NATIVE_UNAVAILABLE

const val ERROR_NATIVE_UNAVAILABLE: Int

The native library could not be loaded.

ERROR_UNAUTHORIZED

const val ERROR_UNAUTHORIZED: Int

The user or MDM denied Bluetooth access for this process (TCC).

ERROR_UNSUPPORTED

const val ERROR_UNSUPPORTED: Int

This Mac has no Bluetooth LE controller.

ERROR_USAGE_DESCRIPTION_MISSING

const val ERROR_USAGE_DESCRIPTION_MISSING: Int

The app bundle's Info.plist lacks NSBluetoothAlwaysUsageDescription.

LIBRARY_PATH_PROPERTY

const val LIBRARY_PATH_PROPERTY: String

Optional absolute path of a libkmpble_macos.dylib to load instead of the bundled one.

USAGE_DESCRIPTION_CHECK_PROPERTY

const val USAGE_DESCRIPTION_CHECK_PROPERTY: String

Set to false to skip the pre-flight check that refuses to start CoreBluetooth when the app macOS holds responsible for this process has no NSBluetoothAlwaysUsageDescription.

Functions

fun isMacosArm64(): Boolean

True on macOS running on Apple silicon, the only architecture this backend ships for.

isNativeLibraryBundled

fun isNativeLibraryBundled(): Boolean

True when the jar carries the native CoreBluetooth shim (it is built on macOS hosts only).