React Native Bluetooth Classic 安装与配置完全指南

React Native Bluetooth Classic 安装与配置完全指南

react-native-bluetooth-classic ⚛ Bluetooth classic Android(Bluetooth)/IOS(ExternalAccessory) module for serial communication 项目地址: https://gitcode.com/gh_mirrors/re/react-native-bluetooth-classic

项目基础介绍及编程语言

React Native Bluetooth Classic 是一个用于解决iOS蓝牙经典（基于External Accessory框架）与Android蓝牙通信问题的开源库。它旨在填补React Native在处理非BLE（蓝牙低功耗）通讯时的空白。项目采用JavaScript作为主要编程语言，并且依赖于React Native环境来运行。

关键技术和框架

• React Native: 应用的基础框架，允许用JavaScript开发原生应用。
• External Accessory Framework (iOS): iOS部分利用此框架实现与MFi认证设备的经典蓝牙通讯。
• Android Bluetooth API: 对于Android端，使用标准的蓝牙API进行设备连接和数据传输。
• Node.js: 作为开发环境的一部分，用于项目初始化和包管理。

准备工作与详细安装步骤

环境要求

• Node.js已安装 (推荐最新稳定版)
• React Native环境已搭建
• Xcode（对于iOS开发）
• Android Studio（对于Android开发）

步骤一：安装React Native Bluetooth Classic

打开命令行工具，进入你的React Native项目的根目录，执行以下命令来安装react-native-bluetooth-classic库：

npm install react-native-bluetooth-classic --save

这会将库添加到你的项目中并保存至package.json的依赖列表里。

步骤二：自动链接与手动链接

React Native 0.60及以上版本

对于大多数React Native 0.60以上版本，应支持自动链接。无需额外操作即可自动完成库的集成。

手动链接（如果自动链接失败）

iOS手动链接

1. 打开Xcode，选择你的项目。
2. 右击项目下的Libraries文件夹，选择Add Files to [项目名]。
3. 导航到node_modules/react-native-bluetooth-classic并添加RNBluetoothClassic.xcodeproj。
4. 在你的项目导航器中，选择你的主目标，然后在General标签页下，找到Linked Frameworks and Libraries部分，点击+，从项目中添加libRNBluetoothClassic.a。
5. 确保在Build Phases > Link Binary With Libraries也添加了这个库。
6. 在你的App的Info.plist中添加MFi协议字符串（如果你的应用要与特定的硬件通信）。

Android手动链接

由于React Native 0.60后，默认支持自动链接，通常不需要手动操作。但如果遇到问题，需按以下操作：

1. 在android/app/src/main/java/yourappname/MainApplication.java中，引入kjd.reactnative.bluetooth.RNBluetoothClassicPackage。
2. 同样在这个文件的getPackages()方法内，添加一个新的new RNBluetoothClassicPackage()实例。
3. 验证或修改android/settings.gradle以包括蓝牙库。

   include ':react-native-bluetooth-classic'
   project(':react-native-bluetooth-classic').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-bluetooth-classic/android')
   

4. 在android/app/build.gradle的dependencies块内添加库的引用。

   implementation project(':react-native-bluetooth-classic')
   

步骤三：启用蓝牙权限

确保你的应用在AndroidManifest.xml和Info.plist中请求了必要的蓝牙权限。

AndroidManifest.xml

<uses-permission android:name="android.permission.BLUETOOTH"/>
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/>

iOS Info.plist

通常不需要特别添加蓝牙权限，但确保你的应用遵循隐私政策并正确声明用途。

步骤四：测试与调试

确保设备已准备好进行蓝牙通讯，并按照库文档中的示例代码使用该库进行设备搜索、连接等操作。

至此，您已经成功安装并配置了React Native Bluetooth Classic，可以开始进行蓝牙相关的开发工作了。

---

通过上述步骤，即使是初学者也能顺利完成React Native Bluetooth Classic的设置，进而进行蓝牙功能的开发。记得在实际开发过程中查阅官方文档以获得更详尽的指引和示例。

react-native-bluetooth-classic ⚛ Bluetooth classic Android(Bluetooth)/IOS(ExternalAccessory) module for serial communication 项目地址: https://gitcode.com/gh_mirrors/re/react-native-bluetooth-classic