iOS在应用内连接特定的WiFi

前言

微博上有个段子广为流传：海边度假酒店老板说各国游客来了需求都不一样： 法国人来了问这附近美女多么？ 德国人来了就成天潜水；意大利人来了就整天晒日光浴；中国人来了挨个问：有WiFi么？WiFi密码多少？

iOS 11 开始可以在应用内通过NetworkExtension中的NEHotspotConfigurationManager连接WiFi，无需到设置里手动连接。

APP Extension 可以让开发者们拓展自定义的功能和内容到应用程序之外，并在用户与其他应用程序或系统交互时提供给用户。苹果定义了很多种APP Extension, 每一种不同功能的APP Extension 称为extension point。

---

项目配置

创建工程后在Capabilities 中开启Access WiFi Innformation, Hotspot Configuration和Network Extensoins

NEHotspotHelper

使用NEHotspotHelper 可以获取用户当前所有WiFi列表，但此功能需要开发者申请特别的权限，申请通过后有两点需要注意 ：

1. 在.entitlemennts文件里面新增配置：com.apple.developer.networking.HotspotHelper值为YES
2. 在Info.plist中新增Required background modes, 新增item 值为network-authentication

然后可以通过以下代码获取用户当前所有WiFi列表, 通过这个列表，可以获得每个WiFi的SSID，BSSID等详细信息。

  NSDictionary *options = [NSDictionary dictionaryWithObjectsAndKeys:@"Connect to MyWifi", kNEHotspotHelperOptionDisplayName, nil];

dispatch_queue_t queue = dispatch_queue_create("com.myapp.ex", 0);
 BOOL isAvailable = [NEHotspotHelper registerWithOptions:options queue:queue handler: ^(NEHotspotHelperCommand * cmd) {
            NSMutableArray *hotspotList = [NSMutableArray new];

 if(cmd.commandType == kNEHotspotHelperCommandTypeEvaluate || cmd.commandType == kNEHotspotHelperCommandTypeFilterScanList) {
                for (NEHotspotNetwork* network  in cmd.networkList) {
                    NSLog(@"network name:%@", network.SSID);
                    if ([network.SSID isEqualToString:@"TP-LINK"]) {
                        [network setConfidence:kNEHotspotHelperConfidenceHigh];
                        [network setPassword:@"<wifi-password>"];
                        [hotspotList addObject:network];
                    }
                }

 NEHotspotHelperResponse *response = [cmd createResponse:kNEHotspotHelperResultSuccess];
                [response setNetworkList:hotspotList];
                [response deliver];
            } else {
                NSLog(@"there is no available wifi");
            }
        }];

NEHotspotConfigurationManager

iOS 11开始新增了NEHotspotConfigurationManager API，这也是Network Extension framework的一部分，支持用于以下功能：

1. 可以让用户连接另一个智能设备的WiFi达到传输数据的目的，比如连接相机WiFi来拷贝相机里面的图片
2. 通过以下方式，可以获取已经添加过的连接配置所有的SSID

 [[NEHotspotConfigurationManager sharedManager] getConfiguredSSIDsWithCompletionHandler:^(NSArray<NSString *> * _Nonnull h) {
        for(NSString *ssid in h){
            NSLog(@"ssid   %@",ssid);
        }
    }];

通过以下方法，可以连接特定的SSID

 __weak __typeof(self) weakSelf = self;
        NEHotspotConfiguration * configuration =
//        [[NEHotspotConfiguration alloc] initWithSSID:self.ssid];  //不需要密码的wifi
        
 [[NEHotspotConfiguration alloc] initWithSSID:self.ssid passphrase:self.pass isWEP:NO]; //需要密码的wifi
//        configuration.joinOnce = YES;
        
        
[[NEHotspotConfigurationManager sharedManager]
         applyConfiguration: configuration
         completionHandler: ^ (NSError * _Nullable error) {
             if (nil == error) {
                 NSLog(@ "Connected!!");
                  NSLog(@"weakSelf   %@",[weakSelf fetchSSIDInfo]);
                 [weakSelf GetCurrentWifiHotSpotName];
             } else {
                 NSLog (@ "Error :%@", error);
             }}];

需要注意的问题：

1. SSID中不可以包含空格，否则无法连接成功
2. SSID填写错误或包含了空格，虽然会创建一个连接，但用户是无法连接网络成功的
3. 模拟器上无法运行
4. 手机系统必须为iOS 11及更高系统
5. 当重复创建连接时，会抛出一个错误，但用户任然能连接上
6. 若删除应用，所有创建的连接都会消失