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列表,但此功能需要开发者申请特别的权限,申请通过后有两点需要注意 :
- 在.entitlemennts文件里面新增配置:com.apple.developer.networking.HotspotHelper值为YES
- 在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的一部分,支持用于以下功能:
- 可以让用户连接另一个智能设备的WiFi达到传输数据的目的,比如连接相机WiFi来拷贝相机里面的图片
- 通过以下方式,可以获取已经添加过的连接配置所有的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);
}}];
需要注意的问题:
- SSID中不可以包含空格,否则无法连接成功
- SSID填写错误或包含了空格,虽然会创建一个连接,但用户是无法连接网络成功的
- 模拟器上无法运行
- 手机系统必须为iOS 11及更高系统
- 当重复创建连接时,会抛出一个错误,但用户任然能连接上
- 若删除应用,所有创建的连接都会消失