# flutter_esp_ble_prov

**Repository Path**: breakfly/flutter_esp_ble_prov

## Basic Information

- **Project Name**: flutter_esp_ble_prov
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-07-29
- **Last Updated**: 2024-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


# flutter_esp_ble_prov

Plugin for provisioning ESP32 Devices over BLE (Bluetooth Low Energy).

This library uses Espressif-provided provisioning libraries for their custom
protocol over BLE.

See the example.

## Requirements

## iOS
 - iOS 13.0+

Add to your Info.plist Bluetooth permissions
```
<key>NSBluetoothAlwaysUsageDescription</key>
<string>Our app uses bluetooth to find, connect and transfer data between different devices</string>
```

## Android

In your `android/app/build.gradle` make sure your minSdkVersion it's 23 or above.

Add to `androud/build.gradle` repositories the following repository `maven { url ("https://jitpack.io/") }`
It should look something like this:

```
allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url ("https://jitpack.io/") }
    }
}
```

Bluetooth permissions on Android changed at S (31) so some creative behaviour is
required in the manifest. This is all [documented](https://developer.android.com/guide/topics/connectivity/bluetooth/permissions) which the library requests on your behalf.

# Notes

## Library embedding

Currently we embed the Espressif Android library in libs because Jitpack
fetching doesn't work and we can't 

## Alternative Library

*  https://pub.dev/packages/esp_bluetooth_provisioning This plugin uses
   Espressif's libraries but has no source repository, is unmaintained,
   and therefore not null safe etc. I would happily fix it if it had a
   repo.

*  https://pub.dev/packages/esp_provisioning This plugin reimplements
   Espressif's protocols in Dart, which is no doubt a highly worthy
   ambition, but has a bunch of dependency on Flutter libraries like the
   Bluetooth library and incurs a huge maintenance burden, which with