React Native Zeroconf 使用教程

React Native Zeroconf 使用教程

react-native-zeroconf :satellite: Discover Zeroconf services using react-native 项目地址: https://gitcode.com/gh_mirrors/re/react-native-zeroconf

1. 项目介绍

react-native-zeroconf 是一个用于在 React Native 应用中实现 Zeroconf 服务发现的库。Zeroconf（零配置网络服务）允许设备在无需手动配置的情况下自动发现网络中的服务，如 Avahi、Bonjour 或 NSD。这个库使得开发者能够在 React Native 应用中轻松实现服务发现功能。

2. 项目快速启动

安装

首先，使用 Yarn 或 npm 安装 react-native-zeroconf：

yarn add react-native-zeroconf
# 或者
npm install react-native-zeroconf

链接库

对于 React Native 版本小于 0.60 的项目，需要手动链接库：

react-native link react-native-zeroconf

对于 iOS 项目，如果使用 CocoaPods，需要执行以下命令：

cd ios && pod install

对于 macOS 项目，如果使用 CocoaPods，需要执行以下命令：

cd macos && pod install

配置权限

Android

确保在 AndroidManifest.xml 中请求必要的权限：

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_MULTICAST_STATE" />

iOS 14

在 info.plist 中添加以下内容以声明使用本地网络发现：

<key>NSBonjourServices</key>
<array>
    <string>my_service._tcp</string>
    <string>my_other_service._tcp</string>
</array>
<key>NSLocalNetworkUsageDescription</key>
<string>Describe why you want to use local network discovery here</string>

使用示例

以下是一个简单的使用示例：

import Zeroconf from 'react-native-zeroconf';

const zeroconf = new Zeroconf();

// 开始扫描
zeroconf.scan('http', 'tcp', 'local.');

// 监听服务发现事件
zeroconf.on('start', () => console.log('扫描已开始'));
zeroconf.on('stop', () => console.log('扫描已停止'));
zeroconf.on('found', (service) => console.log('发现服务:', service));
zeroconf.on('resolved', (service) => console.log('服务已解析:', service));
zeroconf.on('remove', (service) => console.log('服务已移除:', service));

// 停止扫描
zeroconf.stop();

3. 应用案例和最佳实践

应用案例

• 智能家居设备发现：在智能家居应用中，用户可以通过 Zeroconf 自动发现并连接到家庭网络中的智能设备，如智能灯泡、摄像头等。
• 本地服务发现：在局域网内，通过 Zeroconf 发现并连接到本地服务器提供的服务，如文件共享、打印服务等。

最佳实践

• 权限管理：确保在 Android 和 iOS 中正确配置所需的权限，以避免应用崩溃或功能受限。
• 事件监听：合理使用 on 方法监听 Zeroconf 的事件，及时处理服务发现、解析和移除等操作。
• 错误处理：在实际应用中，应处理可能出现的错误，如网络异常、权限不足等。

4. 典型生态项目

• react-native-mqtt：用于在 React Native 应用中实现 MQTT 客户端功能，结合 react-native-zeroconf 可以实现自动发现 MQTT 服务器的功能。
• react-native-wifi-reborn：用于管理 Wi-Fi 连接的库，结合 react-native-zeroconf 可以实现自动连接到发现的服务。
• react-native-network-info：用于获取网络信息的库，结合 react-native-zeroconf 可以实现更复杂的网络管理功能。

通过这些生态项目的结合使用，可以构建出功能更加丰富和强大的 React Native 应用。

react-native-zeroconf :satellite: Discover Zeroconf services using react-native 项目地址: https://gitcode.com/gh_mirrors/re/react-native-zeroconf