iOS 利用 NEHotspotHelper 获取 WiFi 列表

原创 2017年03月09日 20:54:28

iOS 9 发布之后,苹果推出了 NetworkExtension,利用这个框架可以实现很多和网络相关的操作。本文主要介绍怎样使用其中的 NEHotspotHelper 进行设备 WiFi 列表的获取。

Demo 地址:https://github.com/EyreFree/EFNEHotspotHelperDemo

一. 注意事项

  1. 首先,NEHotspotHelper 只在 iOS 9 及以上版本得到支持,之前版本的 iOS 并不支持该功能;
  2. 然后,你需要有一个开发者账号;
  3. 最后,该框架目前还没有大规模开放使用,所以需要向苹果发送申请并且审核通过才能够获得使用该框架的权限,大致内容就是描述一下你需要使用该框架的原因之类的,然后我是用的英文进行描述(感谢百度以及谷歌翻译),不过据说中文也行。提交申请后大概一周内会收到反馈邮件,申请地址为: https://developer.apple.com/contact/network-extension/

二. 创建 App ID

打开苹果开发者中心,登陆然后找到 App IDs 选项,点击右上角按钮创建一个 App ID 用于接下来创建 Provisioning Profile,地址为: https://developer.apple.com/account/ios/identifier/bundle/ ,如图所示:

创建 App ID

首先,填写 Name 以及 Bundle ID,这里统一填写为 EFNEHotspotHelperDemo,如图所示:

填写 Name

填写 Bundle ID

接下来这一步注意需要勾选 Wireless Accessory Configuration 这一选项,如图所示:

勾选 Wireless Accessory Configuration

然后观察到如图所示状态表明已成功打开:

状态显示

在 App IDs 列表中查看刚创建完成的 App ID:

App IDs 列表

三. 创建 Provisioning Profile

找到 Provisioning Profiles 选项,点击右上角按钮创建一个 Provisioning Profile 用于接下来创建示例工程,地址为: https://developer.apple.com/account/ios/profile/ ,如图所示:

创建 Provisioning Profile

首先选择 Profile 类型,这里我选择的是 iOS App Development,可以根据自己的具体需要自由选择:

选择 Profile 类型

接下来选择我们在第二步创建好的 App ID,如图所示:

选择 App ID

然后选择证书和设备,全选即可:

选择证书

选择设备

在额外权限这一步需要选中我们申请到的 Network Extension 权限,可以看到其中包含我们需要使用的 NEHotspotHelper 权限,如图所示:

选中 Network Extension 权限

填写完 Profile Name 之后,即可成功创建我们需要的 Profile:

填写 Profile Name

点击 Download 将它下载到本地:

下载 Profile

双击打开,即可将 Profile 添加到本机:

添加 Profile

可以到 XCode 的账户设置里查看已安装的 Profile,若未安装成功可以尝试点击 Action 中的 Download 按钮重新下载:

查看已安装的 Profile

四. 创建工程

接下来我们创建一个示例工程,演示如何获取 WiFi 列表。首先,将 Bundle ID 改为之前设置的 EFNEHotspotHelperDemo:

修改 Bundle ID

然后在 Info.plist 中添加后台模式权限数组:

添加后台模式代码

代码如下:

<key>UIBackgroundModes</key>
<array>
    <string>network-authentication</string>
</array>

添加完成后可以在 Target -> Capabilities 中看到后台模式已处于开启状态:

后台模式已开启

接下来在 Capabilities 找到 Wireless Accessory Configuration 并将其打开:

打开 Wireless Accessory Configuration

在工程中找到后缀为 {工程名}.entitlements 的文件 EFNEHotspotHelperDemo.entitlements,在其中加入 HotspotHelper 权限代码:

添加 HotspotHelper 权限代码

代码如下:

<key>com.apple.developer.networking.HotspotHelper</key>
<true/>

好了,到这里已经完成了各种乱七八糟的配置工作,可以尝试进行 Build。如果没有提示错误信息的话,接下来就可以愉快地使用 HotspotHelper 了;如果有问题的话,请检查之前的步骤是否都已正确完成或者根据错误信息修改具体项目。

五. 核心代码

首先,在需要使用 HotspotHelper 的地方添加头文件引用,这里以 Objective-C 代码为例:

#import <NetworkExtension/NetworkExtension.h>

然后使用如下代码即可将 WiFi 列表信息打印到 XCode 控制台,注意:这里需要打开系统 设置 中的 无线局域网 页面才可以触发回调:

- (void)scanWifiInfos{
    NSLog(@"1.Start");

    NSMutableDictionary* options = [[NSMutableDictionary alloc] init];
    [options setObject:@"EFNEHotspotHelperDemo" forKey: kNEHotspotHelperOptionDisplayName];
    dispatch_queue_t queue = dispatch_queue_create("EFNEHotspotHelperDemo", NULL);

    NSLog(@"2.Try");
    BOOL returnType = [NEHotspotHelper registerWithOptions: options queue: queue handler: ^(NEHotspotHelperCommand * cmd) {

        NSLog(@"4.Finish");
        NEHotspotNetwork* network;
        if (cmd.commandType == kNEHotspotHelperCommandTypeEvaluate || cmd.commandType == kNEHotspotHelperCommandTypeFilterScanList) {
            // 遍历 WiFi 列表,打印基本信息
            for (network in cmd.networkList) {
                NSString* wifiInfoString = [[NSString alloc] initWithFormat: @"---------------------------\nSSID: %@\nMac地址: %@\n信号强度: %f\nCommandType:%ld\n---------------------------\n\n", network.SSID, network.BSSID, network.signalStrength, (long)cmd.commandType];
                NSLog(@"%@", wifiInfoString);

                // 检测到指定 WiFi 可设定密码直接连接
                if ([network.SSID isEqualToString: @"测试 WiFi"]) {
                    [network setConfidence: kNEHotspotHelperConfidenceHigh];
                    [network setPassword: @"123456789"];
                    NEHotspotHelperResponse *response = [cmd createResponse: kNEHotspotHelperResultSuccess];
                    NSLog(@"Response CMD: %@", response);
                    [response setNetworkList: @[network]];
                    [response setNetwork: network];
                    [response deliver];
                }
            }
        }
    }];

    // 注册成功 returnType 会返回一个 Yes 值,否则 No
    NSLog(@"3.Result: %@", returnType == YES ? @"Yes" : @"No");
}

六. 演示

唔,Demo 运行效果如下,点击 Open WiFi Setting 按钮可直接打开 无线局域网 页面:

运行效果

具体可尝试下载 Demo 并完成相应配置后体验:https://github.com/EyreFree/EFNEHotspotHelperDemo

七. 备注

参考以下资料完成本 Demo,在此表示感谢:

IOS NetworkExtension 框架使用笔记
iOS NEHotspotHelper使用
iOS-NetworkExtension-NEHotspotHelper
API Reference - NetworkExtension


本文链接:http://www.jianshu.com/p/14da35d0b74b

NEHotspotHelper的使用和申请

最近需要在APP中加入WiFi相关的功能,之前没有做过,比较迷茫!这个框架是iOS9 以后才出来的,国内有APP用的,但是开发的资料很少!自己在网上找了很多零散的资料,然后写了一个demo,下面把自己...
  • Yin_Jone
  • Yin_Jone
  • 2016-09-22 15:27:43
  • 3075

ios9 获取app 获取wifi列表,wifi添加副标题

使用之前先到这里看申请方法https://forums.developer.apple.com/message/30657#30657,申请成功后就可以使用这个框架NetworkExtension ...
  • huangmindong
  • huangmindong
  • 2016-06-03 16:15:40
  • 7591

iOS 9 NEHotspotHelper 的NetworkExtension使用

iOS 9 NEHotspotHelper 的NetworkExtension使用
  • yuanchao__2106
  • yuanchao__2106
  • 2016-05-13 18:17:35
  • 2857

NEHotspotHelper权限申请全纪录

NEHotspotHelper (申请地址) https://developer.apple.com/contact/network-extension/ Contact a...
  • sun2728
  • sun2728
  • 2017-03-06 10:52:56
  • 2247

Wifi 定位原理及 iOS Wifi 列表获取

Wifi 定位原理及 iOS Wifi 列表获取   对于大家来说,Wifi 应该是一个很熟悉的词了,我们每天都可能在使用 Wifi 热点。Wifi 除了能给我们提供热点之外同时还有定位的作用,...
  • st646889325
  • st646889325
  • 2018-01-15 16:37:05
  • 621

iOS 获取系统wifi列表,wifi信号强度,并给wifi设置密码,标签(副标题)

前言: iOS 9 发布之后,推出NetworkExtension, 它可给系统WiFi列表列表里边的WiFi设置密码 、标签(副标题)。 还可获取整个WiFi列表。 首先你得向苹果申请一个权限,人家...
  • sun2728
  • sun2728
  • 2016-10-20 16:11:40
  • 940

iOS 获取系统wifi列表,wifi信号强度,并给wifi设置密码,标签

http://www.jianshu.com/p/5072a8485ceb
  • focusjava
  • focusjava
  • 2017-02-06 11:13:40
  • 1793

iOS10 跳转系统wifi列表

iOS10 之后不允许跳转到任何系统设置页面,但是可以通过私有API跳转到系统设置页面,私有方法如下(慎用):NSURL*url=[NSURL URLWithString:@"Prefs:root=W...
  • limengyuan88
  • limengyuan88
  • 2017-02-06 13:37:29
  • 693

获取wifi列表

  • 2014年09月16日 11:30
  • 1.24MB
  • 下载

iOS-OC-获取WiFi信息

  • 2016年09月29日 14:18
  • 31KB
  • 下载
收藏助手
不良信息举报
您举报文章:iOS 利用 NEHotspotHelper 获取 WiFi 列表
举报原因:
原因补充:

(最多只允许输入30个字)