Android Bluetooth LE GATT 示例项目教程

1. 目录结构及介绍

本教程基于 ElvisGuozs 的 BluetoothLeGatt 开源项目（请注意，实际链接指向了一个不同的用户名 dustedrob 的仓库，但我们将基于您的要求进行假设描述）。下面简要介绍该项目的核心目录结构及其组成部分：

BluetoothLeGatt/
├── app/
│   ├── src/
│   │   ├── main/                     <- 主代码库
│   │   │   ├── java/                 <- Java 源码位置
│   │   │   │   └── com.example.bluetooth.le      <- 核心业务逻辑包
│   │   │   ├── res/                  <- 资源文件夹，包括布局文件、图片等
│   │   │   └── AndroidManifest.xml    <- 应用程序的配置文件
│   │   ├── test/                     <- 测试代码
│   │   └── androidTest/              <- 原生Android测试代码
│   ├── build.gradle                <- 应用模块构建脚本
│   └── ...                         <- 其它Gradle相关文件和资源
├── build.gradle                   <- 项目级构建脚本
├── README.md                      <- 项目说明文档
├── LICENSE                        <- 许可证文件
└── ...                             <- 可能还包含其他辅助或文档文件

核心组件介绍:

• java/com.example.bluetooth.le: 包含了所有与蓝牙低功耗(GATT)交互的主要类，如设备扫描、连接、读写操作等。
• res: 存储应用界面所需的布局文件、图标等资源。
• AndroidManifest.xml: 定义了应用程序的元数据，包括使用的权限、启动活动和其他组件声明。

2. 项目启动文件介绍

启动文件通常指的是入口点，对于Android应用来说，这是指包含onCreate()方法的主Activity。在com.example.bluetooth.le包下，通常有一个名为MainActivity或类似的类作为第一个启动的Activity。此文件负责初始化UI，检查必要的系统功能（如蓝牙LE支持），并引导用户进入应用的核心功能界面。例如，可能会先检查设备是否支持Bluetooth LE：

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        if (!getPackageManager().hasSystemFeature(PackageManager.FEATURE_BLUETOOTH_LE)) {
            Toast.makeText(this, R.string.ble_not_supported, Toast.LENGTH_SHORT).show();
            finish();
        }
        
        // 进一步的初始化代码...
    }
    // ...
}

请注意，具体文件名和实现细节可能根据实际项目有所变化。

3. 项目的配置文件介绍

AndroidManifest.xml

AndroidManifest.xml是Android应用配置的核心文件，定义了应用程序的基本信息，如允许访问的权限、默认的主题、启动活动等。示例中可能包含蓝牙权限请求以及启动Activity的声明：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.bluetooth.le">
    
    <uses-feature android:name="android.hardware.bluetooth_le" android:required="true"/>
    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>
    <uses-permission android:name="android.permission.BLUETOOTH"/>

    <application
        ...
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN"/>
                <category android:name="android.intent.category.LAUNCHER"/>
            </intent-filter>
        </activity>
        <!-- 其他Activity、Service等声明 -->
    </application>
</manifest>

build.gradle (Module: app)

构建脚本用于指定编译依赖、版本信息以及其他构建相关设置。这里简化展示其基本结构：

apply plugin: 'com.android.application'

android {
    compileSdkVersion XX
    defaultConfig {
        applicationId "com.example.bluetooth.le"
        minSdkVersion YY
        targetSdkVersion ZZ
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation 'androidx.appcompat:appcompat:XX.X.X'
    // 其他依赖项
}

以上即是对ElvisGuozs的BluetoothLeGatt项目基本结构、启动文件以及关键配置文件的概述。请确保根据实际项目的最新版本来调整和验证这些信息。