Android-BLE 开源项目使用教程

Android-BLE 开源项目使用教程

Android-BLEAndroid-BLE蓝牙框架,提供了扫描、连接、使能/除能通知、发送/读取数据、接收数据,读取rssi,设置mtu等蓝牙相关的所有操作接口,内部优化了连接队列,以及快速写入队列, 并支持多服务通讯,可扩展配置蓝牙相关操作。项目地址:https://gitcode.com/gh_mirrors/an/Android-BLE

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

Android-BLE 项目的目录结构如下：

Android-BLE/
├── app/
│   ├── build.gradle
│   ├── proguard-rules.pro
│   └── src/
│       ├── androidTest/
│       ├── main/
│       │   ├── AndroidManifest.xml
│       │   ├── java/
│       │   │   └── com.aicareles.androidble/
│       │   │       ├── adapter/
│       │   │       ├── model/
│       │   │       ├── service/
│       │   │       └── ui/
│       │   └── res/
│       └── test/
├── build.gradle
├── gradle.properties
├── settings.gradle
└── README.md

目录结构介绍

• app/: 主应用程序模块。
  • build.gradle: 应用程序的构建脚本。
  • proguard-rules.pro: ProGuard 规则文件。
  • src/: 源代码目录。
    • androidTest/: 用于 Android 测试的代码。
    • main/: 主代码目录。
      • AndroidManifest.xml: 应用程序的清单文件。
      • java/: Java 源代码目录。
        • com.aicareles.androidble/: 主包名目录。
          • adapter/: 适配器类目录。
          • model/: 数据模型类目录。
          • service/: 服务类目录。
          • ui/: 用户界面类目录。
      • res/: 资源文件目录。
    • test/: 用于单元测试的代码。
• build.gradle: 项目级别的构建脚本。
• gradle.properties: Gradle 配置属性文件。
• settings.gradle: 项目设置文件。
• README.md: 项目说明文档。

2. 项目的启动文件介绍

项目的启动文件是 app/src/main/java/com/aicareles/androidble/ui/MainActivity.java。这个文件是应用程序的主活动，负责初始化用户界面和处理用户交互。

package com.aicareles.androidble.ui;

import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        // 初始化代码
    }
}

启动文件介绍

• MainActivity.java: 主活动类，继承自 AppCompatActivity。
  • onCreate(): 活动创建时调用的方法，设置布局文件并进行初始化操作。

3. 项目的配置文件介绍

项目的配置文件主要包括 app/build.gradle 和 app/src/main/AndroidManifest.xml。

app/build.gradle

apply plugin: 'com.android.application'

android {
    compileSdkVersion 30
    defaultConfig {
        applicationId "com.aicareles.androidble"
        minSdkVersion 18
        targetSdkVersion 30
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'androidx.appcompat:appcompat:1.2.0'
    implementation 'androidx.constraintlayout:constraintlayout:2.0.4'
    testImplementation 'junit:junit:4.13.1'
    androidTestImplementation 'androidx.test.ext:junit:1.1.2'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.3.0'
}

配置文件介绍

• build.gradle: 应用程序的构建配置文件。
  • android{}: 配置 Android

Android-BLEAndroid-BLE蓝牙框架,提供了扫描、连接、使能/除能通知、发送/读取数据、接收数据,读取rssi,设置mtu等蓝牙相关的所有操作接口,内部优化了连接队列,以及快速写入队列, 并支持多服务通讯,可扩展配置蓝牙相关操作。项目地址:https://gitcode.com/gh_mirrors/an/Android-BLE