Android-Lite-BluetoothLE 使用教程

Android-Lite-BluetoothLE 使用教程

android-lite-bluetoothLEBLE Framework. Based on Bluetooth 4.0. Based on callback. Extremely simple! Communication with BluetoothLE(BLE) device as easy as HTTP communication. Android低功耗蓝牙便捷操作框架，基于回调，完成蓝牙设备交互就像发送网络请求一样简单。项目地址:https://gitcode.com/gh_mirrors/an/android-lite-bluetoothLE

1. 项目目录结构及介绍

Android-Lite-BluetoothLE 的目录结构如下：

.
├── jars                  # 包含第三方库的jar文件
└── library               # 主要源码库
   ├── src                # 源代码文件夹
   │   └── main
   │       ├── java       # Java代码
   │       │   └── com.litesuits.bluetooth
   │       └── res        # 资源文件
   └── samples             # 示例应用代码
      └── app
         ├── src
         │   └── main
         │       ├── java    # 示例应用Java代码
         │       └── res     # 示例应用资源文件
         └── build.gradle    # 示例应用构建脚本

library 目录是核心库，包含了所有关于BLE操作的类和接口，如 LiteBluetooth 类用于管理BLE连接。

samples 目录则是演示如何使用该库的应用程序，你可以通过运行这个示例来了解如何在实际项目中集成。

2. 项目启动文件介绍

在这个项目中，关键的启动文件是 LiteBluetooth 类。通常在你的应用程序中，你需要创建一个 LiteBluetooth 实例并进行初始化，以便开始进行BLE设备扫描或连接。

示例代码：

LiteBluetooth liteBluetooth = new LiteBluetooth(this);
liteBluetooth.init(); // 初始化
liteBluetooth.startLeScan(callback); // 开始扫描设备

这里的 this 是指当前活动（Activity）的上下文，callback 是实现扫描回调的类，例如 PeriodScanCallback。

3. 项目的配置文件介绍

在Android项目中，主要的配置文件是 build.gradle 文件。在 library 和 samples/app 目录下都有各自的 build.gradle 文件，分别定义了库模块和示例应用的构建规则。

在 library/build.gradle 中，你会看到库依赖和其他配置，例如编译版本和兼容性设置：

apply plugin: 'com.android.library'
android {
    compileSdkVersion 28
    defaultConfig {
        minSdkVersion 18
        targetSdkVersion 28
        versionCode 1
        versionName "1.0"
    }
    ...
}
dependencies {
    implementation 'androidx.core:core:1.3.2'
    implementation 'androidx.annotation:annotation:1.1.0'
}

在 samples/app/build.gradle 文件中，配置了示例应用的相关参数，包括对库模块的依赖：

apply plugin: 'com.android.application'
android {
    ...
    dependencies {
        implementation project(':library')
    }
}

确保在实际集成时，修改这些配置以适应你的项目环境，例如更新支持库的版本和调整最低SDK版本要求。

以上就是Android-Lite-BluetoothLE的基本结构、启动文件以及配置文件的介绍。通过理解这些内容，你应该能够顺利地在自己的项目中集成和使用这个蓝牙库。

android-lite-bluetoothLEBLE Framework. Based on Bluetooth 4.0. Based on callback. Extremely simple! Communication with BluetoothLE(BLE) device as easy as HTTP communication. Android低功耗蓝牙便捷操作框架，基于回调，完成蓝牙设备交互就像发送网络请求一样简单。项目地址:https://gitcode.com/gh_mirrors/an/android-lite-bluetoothLE