FastBle 开源项目教程

FastBle 开源项目教程

FastBleAndroid Bluetooth Low Energy (BLE) Fast Development Framework. It uses simple ways to filter, scan, connect, read ,write, notify, readRssi, setMTU, and multiConnection.项目地址:https://gitcode.com/gh_mirrors/fa/FastBle

1. 项目的目录结构及介绍

FastBle 项目的目录结构如下：

FastBle/
├── app/
│   ├── build.gradle
│   └── src/
├── FastBleLib/
│   ├── build.gradle
│   └── src/
├── gradle/
│   └── wrapper/
├── FastBLE-2.3.4.jar
├── FastBLE-2.4.0.aar
├── FastBLE.apk
├── LICENSE
├── README.md
├── build.gradle
├── config.gradle
├── gradle.properties
├── gradlew
├── gradlew.bat
└── settings.gradle

目录介绍

• app/: 包含示例应用程序的源代码和构建配置。
• FastBleLib/: 包含 FastBle 库的源代码和构建配置。
• gradle/: 包含 Gradle 包装器的文件。
• FastBLE-2.3.4.jar: FastBle 库的 JAR 文件。
• FastBLE-2.4.0.aar: FastBle 库的 AAR 文件。
• FastBLE.apk: FastBle 的测试 APK 文件。
• LICENSE: 项目的许可证文件。
• README.md: 项目的说明文档。
• build.gradle: 项目的根构建配置文件。
• config.gradle: 项目的配置文件。
• gradle.properties: Gradle 属性文件。
• gradlew: Gradle 包装器脚本（Unix）。
• gradlew.bat: Gradle 包装器脚本（Windows）。
• settings.gradle: 项目的设置文件。

2. 项目的启动文件介绍

FastBle 项目的启动文件主要是 app/src/main/java/com/clj/fastble/MainActivity.java。这个文件是示例应用程序的主活动，展示了如何使用 FastBle 库进行蓝牙操作。

MainActivity.java 主要功能

• 初始化 BleManager。
• 检查设备是否支持 BLE。
• 打开或关闭蓝牙。
• 配置扫描规则。
• 进行设备扫描、连接、读写、通知订阅等操作。

3. 项目的配置文件介绍

FastBle 项目的配置文件主要包括以下几个部分：

build.gradle

项目的根构建配置文件，包含项目依赖和插件的声明。

// build.gradle
buildscript {
    repositories {
        google()
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.5.3'
    }
}

allprojects {
    repositories {
        google()
        jcenter()
        maven { url 'https://jitpack.io' }
    }
}

config.gradle

项目的配置文件，包含版本号和其他配置信息。

// config.gradle
ext {
    compileSdkVersion = 29
    buildToolsVersion = "29.0.2"
    minSdkVersion = 18
    targetSdkVersion = 29
    versionCode = 1
    versionName = "1.0"
}

gradle.properties

Gradle 属性文件，包含项目的一些属性设置。

# gradle.properties
org.gradle.jvmargs=-Xmx1536m
android.useAndroidX=true
android.enableJetifier=true

settings.gradle

项目的设置文件，包含项目模块的声明。

// settings.gradle
include ':app', ':FastBleLib'

通过以上配置文件，可以对 FastBle 项目进行构建和配置，确保项目能够正确运行和部署。

FastBleAndroid Bluetooth Low Energy (BLE) Fast Development Framework. It uses simple ways to filter, scan, connect, read ,write, notify, readRssi, setMTU, and multiConnection.项目地址:https://gitcode.com/gh_mirrors/fa/FastBle