Android-BluetoothKit 教程：快速入门与配置

1. 项目目录结构及介绍

Android-BluetoothKit 是一个轻量级的 Android 开源库，用于简化蓝牙（包括 BLE）设备的扫描、连接和支持自定义扫描策略。以下是主要的项目目录结构及其作用：

.
├── app         // 示例应用模块，展示如何使用 BluetoothKit
│   ├── src
│   │   └── main
│   │       ├── java           // 示例应用的 Java 代码
│   │       └── res            // 示例应用的资源文件
├── library     // BluetoothKit 库的源码模块
│   ├── src
│   │   └── main
│   │       ├── java           // 库的核心功能代码
│   │       └── res            // 库的资源文件
└── README.md    // 项目的简介与使用指南

核心类位于 library/src/main/java/com/inuker/bluetooth/library 目录下，如 BluetoothDevice, BluetoothManager, BluetoothLeScanner 等。

2. 项目的启动文件介绍

在示例应用 (app) 中，你可以找到 MainActivity.java 文件，它是应用的入口点。这个文件展示了如何初始化 BluetoothKit 并进行设备扫描和连接操作。例如，以下代码片段展示了如何启动蓝牙扫描：

BluetoothClient btClient = new BluetoothClient.Builder()
        .setOnStateChangedListener(this)
        .setOnSearchResultListener(this)
        .build();
btClient.startScan();

这里的 BluetoothClient 类是 BluetoothKit 提供的主要接口，它包含了蓝牙操作的主要方法。

3. 项目的配置文件介绍

AndroidManifest.xml

在 Android 项目中，AndroidManifest.xml 文件是非常重要的配置文件。为了使用 Android-BluetoothKit，你需要确保包含以下权限和特征声明：

<manifest>
    ...
    <uses-sdk android:minSdkVersion="18"/>
    
    <uses-permission android:name="android.permission.BLUETOOTH"/>
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
    
    <uses-feature android:name="android.hardware.bluetooth_le" android:required="true"/>
    
    <application>
        ...
        <service android:name="com.inuker.bluetooth.library.BluetoothService"/>
        ...
    </application>
</manifest>

特别地，BluetoothService 服务是 BluetoothKit 需要的后台组件，用于处理蓝牙连接等任务。

build.gradle

在你的 app/build.gradle 文件中，需要添加 BluetoothKit 依赖库：

dependencies {
    implementation 'com.inuker.bluetooth:library:1.4.0'
}

完成这些配置后，你就可以在自己的应用中使用 BluetoothKit 来管理和操作蓝牙设备了。更多信息请参考项目 README 或示例代码。