Imported from sub4ikgg/alertoid-connect (core/ble/src/androidMain/AGENTS.md). Install upstream with npx skills add sub4ikgg/alertoid-connect --skill androidMain. Copyright stays with the author.

core:ble · androidMain

Name: androidMain
Author: sub4ikgg

Purpose

Android actual implementations of all BLE interfaces. Uses Android BLE APIs directly. All classes here fulfill expect declarations from commonMain.

Key Files

File	Description
`BleContext.kt`	Holds `Context` reference for BLE operations; must be initialised before BLE singletons are used
`getBlePermissions.android.kt`	Returns `BLUETOOTH_SCAN`, `BLUETOOTH_CONNECT`, `ACCESS_FINE_LOCATION` (pre-12)
`isBlePermissionsGranted.android.kt`	Checks runtime BLE permission grants
scanner/
`AndroidAlertoidScanner.kt`	Scans for devices filtering by service UUID; uses coroutines + Android BLE scan callbacks
`provideScanner.android.kt`	`actual fun provideScanner()` — returns singleton `AndroidAlertoidScanner`
connector/
`AndroidAlertoidConnector.kt`	Manages GATT connection lifecycle; auto-reconnects up to 3× with 5 s timeout; emits `AlertoidConnectorStatus`
`provideAlertoidConnector.android.kt`	`actual fun provideAlertoidConnector()`
shared/
`SharedBle.kt`	Utility: `awaitCharacteristicRead(uuid)` — suspends using `CompletableDeferred` until GATT read callback fires
util/
`WriteCharacteristicCompat.kt`	Compat wrapper for GATT characteristic writes (API 33+ vs older API)
configurator/wifi/
`AndroidAlertoidWifiConfigurator.kt`	Writes SSID + passphrase to device via GATT characteristic write
`provideAlertoidWifiConfigurator.android.kt`	`actual fun`
configurator/url/
`AndroidAlertoidUrlConfigurator.kt`	Writes URL config to device via GATT write
`AndroidAlertoidUrlConfigurationReader.kt`	Reads current URL config via `SharedBle.awaitCharacteristicRead()`
`provideAlertoidUrlConfigurator.android.kt` / `provideAlertoidUrlConfigurationReader.android.kt`	`actual fun` factories

For AI Agents

BleContext must be initialised in MainActivity.onCreate() before any BLE singleton is used
AndroidAlertoidConnector must be register()-ed in onCreate and unregister()-ed in onDestroy
Never use runBlocking on the main thread for GATT operations — use scope.launch + SharedBle.awaitCharacteristicRead()
WriteCharacteristicCompat handles the API-level difference for writeCharacteristic; always use it instead of calling the method directly

{ "ocm": "1", "id": "sub4ikgg-alertoid-connect-androidmain", "kind": "skill", "name": "androidMain", "description": " ", "publisher": "sub4ikgg", "version": "1.0.0", "capabilities": { "domains": [ "math" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ " " ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/sub4ikgg/alertoid-connect", "path": "core/ble/src/androidMain/AGENTS.md", "ref": "24c0667bcda1d5826bd05d05b72200c4f58dcc06", "url": "https://github.com/sub4ikgg/alertoid-connect/blob/24c0667bcda1d5826bd05d05b72200c4f58dcc06/core/ble/src/androidMain/AGENTS.md", "key": "sub4ikgg/alertoid-connect/core/ble/src/androidMain/AGENTS.md" } }, "instructions": "\n\n\n# core:ble · androidMain\n\n## Purpose\nAndroid `actual` implementations of all BLE interfaces. Uses Android BLE APIs directly. All classes here fulfill `expect` declarations from `commonMain`.\n\n## Key Files\n\n| File | Description |\n|------|-------------|\n| `BleContext.kt` | Holds `Context` reference for BLE operations; must be initialised before BLE singletons are used |\n| `getBlePermissions.android.kt` | Returns `BLUETOOTH_SCAN`, `BLUETOOTH_CONNECT`, `ACCESS_FINE_LOCATION` (pre-12) |\n| `isBlePermissionsGranted", "cost": { "context_tokens": 618 } }

androidMain

About

core:ble · androidMain

Purpose

Key Files

For AI Agents

Use it

Manifest

Reviews