From 1c5946620fec6e5551f3bd69d83c006071b8043f Mon Sep 17 00:00:00 2001 From: aria Date: Thu, 23 Apr 2026 12:03:31 +0900 Subject: [PATCH] fixed ios wifi part support. retry 9. --- README.md | 1 + package.json | 2 +- plugin.xml | 2 +- src/ios/CDVBluememeUtils.m | 51 +++++++++++++++++++++++++++++++++++++- 4 files changed, 53 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 4274e64..78709c6 100644 --- a/README.md +++ b/README.md @@ -214,6 +214,7 @@ iOS WiFi: - 插件将 iOS deployment target 设置为 `15.0`；如果宿主 App 或构建平台覆盖该值，需要在宿主配置中同步设置 iOS 最低版本为 15.0 或更高。 - 插件会向 Cordova iOS entitlements 写入 `com.apple.developer.networking.HotspotConfiguration`，但仍必须在 Apple Developer App ID 中开启 `Hotspot Configuration` capability，并使用包含该 capability 的 provisioning profile 重新构建。 - 如果 iOS 返回 `NEHotspotConfigurationErrorDomain` code `8` / `internal error`，优先检查 App ID、entitlements、provisioning profile 是否都包含 `Hotspot Configuration`，并确认是在真机前台运行，不是在模拟器中测试。若签名和参数都正确，常见原因是真实热点使用 WPA2/WPA3 transition mode、WPA3 Personal、iPhone Personal Hotspot 默认安全模式，或其他 `NEHotspotConfiguration` 无法表达的 WiFi 能力。 +- iOS 错误结果会包含 `applicationState`、`ssidUtf8Length`、`passwordUtf8Length`、`passwordAsciiPrintable` 等诊断字段；WPA/WPA2 密码建议使用 8-63 位可打印 ASCII 字符。 - iOS 的 `NEHotspotConfiguration` password initializer 公开支持 WEP/WPA/WPA2 Personal，不提供 WPA3 Personal 参数。iOS 传入 `security` 包含 `wpa3` 时会返回 `UNSUPPORTED_WIFI_SECURITY`。WPA2/WPA3 mixed 通常只能按 `security: "wpa2"` 尝试；如果仍失败，需要用户手动加入，或改用配置描述文件/MDM 流程。 - iOS 不提供第三方 App 断开当前 WiFi 的公开 API，因此 `disconnectWifi` 在 iOS 返回错误。 diff --git a/package.json b/package.json index 975cdf8..733d451 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "bluememe-utils", - "version": "0.1.8", + "version": "0.1.9", "description": "Cordova utilities for WiFi, Firebase Cloud Messaging, and biometric unlock for OutSystems 11 apps.", "license": "MIT", "files": [ diff --git a/plugin.xml b/plugin.xml index b9bbe9b..b0a61e0 100644 --- a/plugin.xml +++ b/plugin.xml @@ -2,7 +2,7 @@ + version="0.1.9"> bluememe-utils Cordova utilities for WiFi, Firebase Cloud Messaging, and biometric unlock. MIT diff --git a/src/ios/CDVBluememeUtils.m b/src/ios/CDVBluememeUtils.m index c2f0530..28caeeb 100644 --- a/src/ios/CDVBluememeUtils.m +++ b/src/ios/CDVBluememeUtils.m @@ -294,12 +294,27 @@ static NSString * const BluememeDeviceKeyDefaultsKey = @"bluememe_utils_device_k BOOL isWep = [security isEqualToString:@"wep"] || [self boolFromDictionary:options key:@"isWep" defaultValue:NO]; BOOL joinOnce = [self boolFromDictionary:options key:@"joinOnce" defaultValue:defaultJoinOnce]; BOOL hiddenSsid = [self boolFromDictionary:options key:@"hiddenSsid" defaultValue:NO]; + NSString *applicationState = [self applicationStateName]; if (ssid.length == 0) { [self sendErrorForCommand:command code:@"INVALID_WIFI_OPTIONS" message:@"ssid is required."]; return; } + if ([[UIApplication sharedApplication] applicationState] != UIApplicationStateActive) { + [self sendErrorForCommand:command + code:@"APPLICATION_NOT_ACTIVE" + message:@"iOS WiFi configuration must be requested while the app is active in the foreground." + details:@{ + @"ssid": ssid, + @"security": security, + @"joinOnce": @(joinOnce), + @"hiddenSsid": @(hiddenSsid), + @"applicationState": applicationState + }]; + return; + } + if (isWpa3) { [self sendErrorForCommand:command code:@"UNSUPPORTED_WIFI_SECURITY" @@ -348,9 +363,13 @@ static NSString * const BluememeDeviceKeyDefaultsKey = @"bluememe_utils_device_k @"ssid": ssid, @"security": security, @"passwordLength": @(password.length), + @"passwordUtf8Length": @([password lengthOfBytesUsingEncoding:NSUTF8StringEncoding]), + @"passwordAsciiPrintable": @([self isAsciiPrintableString:password]), + @"ssidUtf8Length": @([ssid lengthOfBytesUsingEncoding:NSUTF8StringEncoding]), @"joinOnce": @(joinOnce), @"hiddenSsid": @(hiddenSsid), - @"minimumIos": @"15.0" + @"minimumIos": @"15.0", + @"applicationState": applicationState }; [self sendWifiApplyErrorForCommand:command error:error context:context]; return; @@ -377,6 +396,36 @@ static NSString * const BluememeDeviceKeyDefaultsKey = @"bluememe_utils_device_k } } +- (NSString *)applicationStateName +{ + UIApplicationState state = [[UIApplication sharedApplication] applicationState]; + switch (state) { + case UIApplicationStateActive: + return @"active"; + case UIApplicationStateInactive: + return @"inactive"; + case UIApplicationStateBackground: + return @"background"; + default: + return @"unknown"; + } +} + +- (BOOL)isAsciiPrintableString:(NSString *)value +{ + if (value.length == 0) { + return YES; + } + + for (NSUInteger index = 0; index < value.length; index++) { + unichar character = [value characterAtIndex:index]; + if (character < 0x20 || character > 0x7E) { + return NO; + } + } + return YES; +} + - (void)sendWifiApplyErrorForCommand:(CDVInvokedUrlCommand *)command error:(NSError *)error context:(NSDictionary *)context { NSMutableDictionary *details = [NSMutableDictionary dictionary];