FlutterBleLib 常见问题解决方案

FlutterBleLib 常见问题解决方案

FlutterBleLib Bluetooth Low Energy library for Flutter with support for simulating peripherals 项目地址: https://gitcode.com/gh_mirrors/fl/FlutterBleLib

1. 项目基础介绍和主要编程语言

FlutterBleLib 是一个适用于 Flutter 的蓝牙低功耗（BLE）库，它支持模拟外设，可以让开发者在不使用实体智能手机或 BLE 外设的情况下进行开发，并且能够在自动化测试中使用生产环境中的 BLE 相关代码。该库内部使用了 Polidea 的 MultiPlatformBleAdapter，这个适配器基于 RxAndroidBle 和 RxBluetoothKit。主要编程语言为 Dart，它是 Flutter 开发的官方语言。

2. 新手使用时需特别注意的问题及解决步骤

问题一：如何在项目中集成 FlutterBleLib

解决步骤：

1. 在项目的 pubspec.yaml 文件中添加依赖：

   dependencies:
     flutter_ble_lib: ^最新版本号
   

2. 运行 flutter pub get 命令来安装库。
3. 根据官方文档，对 Android 和 iOS 环境进行相应配置。

问题二：如何在 Android 设备上设置最低 SDK 版本

解决步骤：

1. 打开 Android 项目目录下的 android/app/build.gradle 文件。
2. 找到 defaultConfig 部分，并设置 minSdkVersion 至少为 18：

   android {
       defaultConfig {
           minSdkVersion 18 // 设置最低 SDK 版本为 18
       }
   }
   

3. 因为 BLE 在 API 18 以上版本才支持，所以需要设置最低 SDK 版本。

问题三：如何在 iOS 设备上配置蓝牙权限

解决步骤：

1. 打开 iOS 项目目录，运行 pod install 命令来安装依赖。
2. 在 ios/Runner/Info.plist 文件中添加以下键值对，以描述使用蓝牙的目的：

   <key>NSBluetoothAlwaysUsageDescription</key>
   <string>这里是你的应用需要使用蓝牙的描述信息</string>
   

3. 如果应用需要后台支持，还需要添加 UIBackgroundModes 键，并在数组中包含 bluetooth-central：

   <key>UIBackgroundModes</key>
   <array>
       <string>bluetooth-central</string>
   </array>
   

4. 确保这些配置正确无误，以避免运行时权限问题。

以上是针对新手在使用 FlutterBleLib 时可能会遇到的一些常见问题及解决步骤。如果在使用过程中遇到其他问题，可以查看项目官方文档或通过 GitHub 提交 Issue 寻求帮助。

FlutterBleLib Bluetooth Low Energy library for Flutter with support for simulating peripherals 项目地址: https://gitcode.com/gh_mirrors/fl/FlutterBleLib