react-native-wifi-connect-helper v0.2.3

react-native-wifi-connect-helper

Wifi配网助手，参考了react-native-wifi-reborn的代码

安装

npm install react-native-wifi-connect-helper

或者

yarn add react-native-wifi-connect-helper

Android

需要在/android/app/src/main/AndroidManifest.xml，加入一下权限

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!-- 连接wifi需要 -->
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />

iOS

开启 Access WIFI Information 和 Hotspot Configuration（连接wifi需要）。

还需要在 info.plist加入 Privacy - Location When In Use Usage Description 描述。

连接（linking）

自动连接 (React Native 60+)

React Native 60+ 以上会自动连接，无需其它操作 🎉.

通过cli连接(针对React Native 0.59以下版本)

需要手动运行以下命令

react-native link react-native-wifi-connect-helper

手动连接

iOS

1. 打开XCode, 在项目导航器中, 右键 Libraries ➜ Add Files to [your project's name]
2. 打开 node_modules ➜ react-native-wifi-connect-helper 然后添加 WifiConnectHelper.xcodeproj
3. 打开XCode, 在项目导航器中, 选择你的项目. 添加 libWifiConnectHelper.a 到你项目的 Build Phases 中➜ Link Binary With Libraries
4. 运行你的项目 (Cmd+R)

Android

1. 打开 android/app/src/main/java/[...]/MainActivity.java

• 添加 import com.reactlibrary.reactnativewificonnecthelper.WifiConnectHelperPackage; 到文件顶部
• 在getPackages() 方法中添加 new WifiConnectHelperPackage() 到列表中

2. 添加下列代码到 android/settings.gradle ：

include ':react-native-wifi-connect-helper'
project(':react-native-wifi-connect-helper').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-wifi-connect-helper/android')

3. 将下列代码添加到 android/app/build.gradle 的 dependencies 块中：

implementation project(':react-native-wifi-connect-helper')

使用

import {
  getCurrentWifiSSID,
  connectToProtectedSSID,
} from 'react-native-wifi-connect-helper';

// ...

connectToProtectedSSID(ssid, password, isWep).then(
  () => {
    console.log("连接成功!");
  },
  () => {
    console.log("连接失败!");
  }
);

getCurrentWifiSSID().then(
  ssid => {
    console.log("你当前连接的 wifi ssid 是" + ssid);
  },
  () => {
    console.log("无法获取当前ssid!");
  }
);

例子

下载项目：

git clone https://github.com/wcly/react-native-wifi-connect-helper.git
cd react-native-wifi-connect-helper
yarn
yarn example android
yarn example ios

打开项目react-native-wifi-connect-helper

cd react-native-wifi-connect-helper

安装依赖：

yarn

运行 Android 例子：

yarn example android

运行 iOS 例子：

运行 iOS 例子：

yarn example ios

方法

Android 和 iOS

connectToProtectedSSID(SSID: string, password: string, isWEP: boolean): Promise

连接wifi，连接成功触发resolve，连接失败触发reject，返回错误。

SSID

需要连接的wifi网络SSID。

password

需要连接的wifi网路密码。

isWep

在iOS中使用，如果是true，网络是WEP Wi-Fi类型；否则，它是WPA或WPA2个人Wi-Fi网络。

getCurrentWifiSSID(): Promise<string>

获取当前连接wifi的SSID。

checkIsWifiEnable(): Promise<boolean>

检查wifi开关是否打开，打开返回true，否则返回false。

checkIsGPSEnable(): Promise<boolean>

检查定位服务开关是否打开，打开返回true，否则返回false。

仅iOS

connectToSSID(ssid: string): Promise

connectToProtectedSSIDOnce(SSID: string, password: string, isWEP: boolean, joinOnce: boolean): Promise

joinOnce

iOS上使用。可选参数。默认值为false。当joinOnce设置为true时，hotspot只在配置它的应用程序在前台运行时才会保持配置和连接。当发生以下事件时，热点断开并删除其配置：

• 该应用程序在后台停留超过15秒。

• 设备睡眠。

• 该应用程序崩溃，退出或已卸载。

• 该应用将设备连接到其他Wi-Fi网络。

• 用户将设备连接到其他Wi-Fi网络。

仅Android

loadWifiList(): Promise<Array<WifiEntry>>

获取wifi列表。

WifiEntry

• SSID: wifi名称。
• BSSID: wifiBSSID。
• capabilities: 描述访问点支持的身份验证，密钥管理和加密方案。
• frequency: 通道的主要20 MHz频率(以MHz为单位)，客户端通过该频率与接入点通信。
• level: dBm中检测到的信号水平，也称为RSSI。
• timestamp: 以微秒为单位的时间戳(从启动开始)最后一次看到这个结果的时间。

getCurrentSignalStrength(): Promise<number>

获取当前连接wifi的信号强度。

setEnabled(enabled: boolean)

设置wifi开关状态。

openGPSSetting()

跳转到定位服务设置页面。

openWifiSetting()

跳转到wifi设置页面。

open(action: string)

跳转到指定页面。

action的值参考：https://blog.csdn.net/LJX646566715/article/details/79445624

贡献

请参阅 贡献指南 以了解如何为库和开发工作流程做出贡献

许可

MIT