React-Native-Zeroconf使用手册

范垣楠Rhoda

于 2024-09-16 07:26:05 发布

阅读量836

点赞数 11

本文链接：https://blog.csdn.net/gitblog_00283/article/details/142294386

版权

React-Native-Zeroconf使用手册

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

一、项目目录结构及介绍

React-Native-Zeroconf 是一个用于在React-Native应用中发现Zeroconf服务（如Avahi、Bonjour或NSD）的库。其目录结构大致如下：

react-native-zeroconf/
├── android                 # 安卓平台相关的代码和配置
│   ├── app                 # 主工程
│   └── example             # 示例应用的安卓部分
├── example                 # 示例应用的完整目录，包含iOS和Android示例
│   ├── android             
│   ├── ios                 
│   ├── index.js            # 示例应用的入口文件
│   └── node_modules        
├── ios                     # iOS平台相关的代码和配置
│   ├── example             # 示例应用的iOS部分
│   └── react-native-zeroconf.xcodeproj
├── package.json            # Node.js项目的依赖管理和脚本定义
├── README.md               # 项目的主要说明文件，包含安装、使用等信息
└── src                     # 库的核心源代码
    └── ...

android 和 ios: 分别包含了针对安卓和iOS操作系统的特定实现和配置。
example: 提供了一个完整的示例应用，演示如何使用此库进行服务发现和发布。
package.json: 管理项目依赖和构建命令。
src: 核心代码所在目录，实现了Zeroconf服务发现的主要逻辑。

二、项目的启动文件介绍

示例应用启动

示例应用的启动主要从example/index.js文件开始。在开发环境中，你需要先确保所有必要的依赖已正确安装，并运行以下命令来启动项目：

进入到example目录下。
安装依赖：npm install 或 yarn。
对于React-Native版本<0.60，执行react-native link来链接库（这一步对于较新版本的React-Native可能不需要）。
对于iOS，还需要在ios目录下运行pod install。
最后，使用react-native run-android或react-native run-ios来启动对应的模拟器或设备上的应用。

库的集成启动

如果你打算将这个库集成到你的现有项目中，步骤类似于示例应用的准备过程，但不需要创建新的example目录。核心是安装库、链接（如果需要）、并在你的应用代码中导入并使用它。

三、项目的配置文件介绍

安卓配置

在你的主应用的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配置

项目中需要在Info.plist添加权限描述，尤其针对iOS 14及以上版本，明确指定扫描的服务类型和理由：

<key>NSBonjourServices</key>
<array>
  <string>_http._tcp.</string>
</array>
<key>NSLocalNetworkUsageDescription</key>
<string>为查找本地网络服务提供描述。</string>