3、开发环境搭建：Android Studio配置、Gradle依赖管理、模拟器与真机调试差异、常见开发工具

说实话，做蓝牙开发这么多年，我见过太多人卡在环境搭建这一步。明明代码逻辑没问题，就是连不上设备，或者一运行就崩溃。其实说白了，环境搭好了，后面能省下一大半的调试时间。这一章我就把我在实战中踩过的坑、积累的经验，一次性给你讲透。

3.1 Android Studio配置——别小看这一步

Android Studio 的版本选择，我个人建议直接用最新的稳定版。别追预览版，蓝牙开发本身就有不少坑，没必要再给编译器添乱。

安装完成后，有几个关键配置你一定要检查：

• SDK 版本：蓝牙低功耗（BLE）从 Android 4.3（API 18）开始支持，但如果你要做 BLE 扫描，建议最低 API 21。我一般把 minSdkVersion 设成 21，targetSdkVersion 和 compileSdkVersion 用当前最新。
• NDK 配置：如果你需要用到蓝牙抓包或者底层库，NDK 是必须的。在 SDK Manager 里勾选 NDK 和 CMake。
• 虚拟机加速：记得安装 Intel HAXM 或 Windows Hyper-V，不然模拟器慢到你怀疑人生。

3.2 Gradle依赖管理——蓝牙库的选型与配置

Gradle 配置看起来简单，但蓝牙开发里依赖管理其实挺讲究的。你想想看，一个蓝牙库版本不对，可能连扫描回调都收不到。

下面是我常用的依赖配置，直接复制到你的 build.gradle（Module 级别）里：

dependencies {
    // 核心蓝牙库
    implementation 'androidx.core:core-ktx:1.12.0'
    implementation 'androidx.appcompat:appcompat:1.6.1'
    
    // 蓝牙权限处理（Android 12+ 需要）
    implementation 'com.google.android.gms:play-services-location:21.0.1'
    
    // 可选：RxAndroidBle（如果你喜欢响应式编程）
    implementation 'com.polidea.rxandroidble2:rxandroidble:1.12.1'
    
    // 可选：FastBle（国产库，文档中文友好）
    implementation 'com.clj.fastble:FastBleLib:2.4.0'
}

这里我要多说一句。RxAndroidBle 和 FastBle 我都用过，各有优劣。RxAndroidBle 的链式调用很优雅，但学习曲线陡；FastBle 上手快，但遇到复杂场景容易出 bug。我个人习惯是：小项目用 FastBle，大项目用 RxAndroidBle。

3.3 模拟器与真机调试差异——血的教训

嗯，这里我要重点讲。我曾经在模拟器上跑得好好的蓝牙扫描，一上真机就完全没反应。为什么？因为模拟器根本模拟不了真实的蓝牙硬件。

所以我的建议是：逻辑验证用模拟器，功能测试必须上真机。特别是蓝牙连接、断开、重连这些场景，模拟器根本给不了你真实反馈。

3.4 常见开发工具——nRF Connect 与 Wireshark 抓包

做蓝牙开发，光靠 Android Studio 是不够的。你得有几把趁手的「兵器」。下面这两个工具，我几乎每天都在用。

3.4.1 nRF Connect——蓝牙调试神器

nRF Connect 是 Nordic 出的一款蓝牙调试工具，免费且功能强大。它能帮你做三件事：

• 扫描设备：显示所有蓝牙设备的广播包、信号强度、服务 UUID。
• 连接与交互：直接读写特征值，测试你的服务端逻辑。
• 日志导出：把蓝牙通信过程导出成日志，方便分析。

我一般用它来「偷看」其他蓝牙设备的数据格式。比如某个智能手环的广播包结构，用 nRF Connect 一扫，一目了然。

3.4.2 Wireshark 抓包——进阶必备

Wireshark 是网络抓包工具，但配合蓝牙适配器，也能抓蓝牙包。你需要一个支持蓝牙监控模式的适配器（比如 Ubertooth One 或 TI CC2540）。

抓包步骤大致如下：

1. 安装 Wireshark 和对应的蓝牙抓包驱动。
2. 选择蓝牙适配器作为捕获接口。
3. 设置过滤条件（比如只抓某个 MAC 地址的包）。
4. 开始抓包，分析蓝牙协议栈的每一层。

3.5 本章知识体系总览

下面这张图，帮你把本章的核心逻辑串起来。你可以把它当作一个「环境搭建检查清单」来用。

你看，整个环境搭建其实就四个模块：Android Studio 是地基，Gradle 是脚手架，模拟器/真机是测试场，nRF Connect 和 Wireshark 是工具箱。把这四块搞定了，蓝牙开发的路就铺平了。