PhilipsHue/flutter_reactive_ble 项目常见问题解决方案

PhilipsHue/flutter_reactive_ble 项目常见问题解决方案

flutter_reactive_ble Flutter library that handles BLE operations for multiple devices. 项目地址: https://gitcode.com/gh_mirrors/fl/flutter_reactive_ble

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

PhilipsHue/flutter_reactive_ble 是一个开源项目，它提供了一个用于处理多个设备BLE（蓝牙低功耗）操作的Flutter库。该库支持BLE设备的发现、连接状态维护、服务发现、特性读写等功能，非常适合需要在Flutter应用中集成BLE通信的开发者。项目主要使用的编程语言是Dart，它是Flutter开发的基础语言。

2. 新手在使用这个项目时需要特别注意的3个问题及解决步骤

问题一：项目依赖设置

问题描述：新手在配置项目依赖时可能会遇到问题，导致无法正确运行。

解决步骤：

1. 确保你的开发环境已经安装了Flutter和Dart SDK。
2. 在项目根目录下运行 melos bootstrap 命令来初始化所有依赖。
3. 如果项目使用的是Kotlin，确保Android Studio中的Kotlin插件版本与项目要求的版本一致。

问题二：AndroidManifest.xml 文件权限配置

问题描述：在Android开发中，如果没有正确配置权限，可能导致应用无法正常扫描或连接BLE设备。

解决步骤：

1. 在Android项目的 AndroidManifest.xml 文件中添加以下权限：

   <uses-permission android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />
   <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
   <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" android:maxSdkVersion="30" />
   <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" android:maxSdkVersion="30" />
   

2. 如果使用 BLUETOOTH_SCAN 权限来确定位置，需要在 AndroidManifest.xml 中添加以下配置：

   <uses-permission android:name="android.permission.BLUETOOTH_SCAN" tools:remove="android:usesPermissionFlags" tools:targetApi="s" />
   

3. 如果应用使用位置服务，需要从位置权限标签中移除 android:maxSdkVersion="30"。

问题三：ProGuard 规则配置

问题描述：在Android项目中使用ProGuard时，如果没有正确配置规则，可能会出现运行时错误。

解决步骤：

1. 在项目的 proguard-rules.pro 文件中添加以下规则：

   -keep class com.signify.hue.** { *; }
   

2. 这将防止诸如 #131 问题之类的错误。

通过以上步骤，新手开发者可以顺利地集成和使用 PhilipsHue/flutter_reactive_ble 项目，解决在开发过程中可能遇到的问题。

flutter_reactive_ble Flutter library that handles BLE operations for multiple devices. 项目地址: https://gitcode.com/gh_mirrors/fl/flutter_reactive_ble