/** * 双协议网络前置:按 PROTO 切手机蓝牙/WiFi,用于必测项控制用例的 BLE/WiFi 两种模式。 * * - ble 模式: 开蓝牙、关 WiFi → app 走 BLE 直连 * - wifi 模式: 关蓝牙、开 WiFi → app 走 WiFi/云 * * 平台能力(已在三星真机实测): * - Android WiFi : adb `svc wifi enable/disable` 可行(dumpsys 实测真关/开) * - Android 蓝牙 : adb `svc bluetooth` 被新系统禁用(exit 137)、`cmd bluetooth_manager` 无实现、 * `settings put bluetooth_on` 不动 radio → 改为 `am start 蓝牙设置` + 点 switch_widget(实测可切 ON↔BLE_ON) * - iOS : 无公开 API,走系统设置(com.apple.Preferences)UI;locator 需 iOS 真机校准 */ import { execSync } from 'child_process'; import { DeviceDriver } from '../../drivers/types'; import { APP_CONFIG } from '../../config/app.config'; import { sleep } from './element.helper'; function adbShell(cmd: string): string { return execSync(`adb shell ${cmd}`, { encoding: 'utf-8', timeout: 20000 }); } // ---------- Android(纯 adb,已实测) ---------- async function androidSetWifi(on: boolean): Promise { adbShell(`svc wifi ${on ? 'enable' : 'disable'}`); await sleep(2000); } async function androidSetBluetooth(on: boolean): Promise { adbShell('am start -a android.settings.BLUETOOTH_SETTINGS'); await sleep(2500); adbShell('uiautomator dump /sdcard/ui.xml'); const xml = adbShell('cat /sdcard/ui.xml'); // 三星实测节点: resource-id="com.android.settings:id/switch_widget" class=Switch checked=.. bounds=[x1,y1][x2,y2] const m = xml.match(/switch_widget"[^>]*?checked="(true|false)"[^>]*?bounds="\[(\d+),(\d+)\]\[(\d+),(\d+)\]"/); if (!m) { console.warn('[network] 未找到蓝牙开关 switch_widget,跳过(请真机校准 locator)'); return; } const isOn = m[1] === 'true'; if (isOn !== on) { const cx = Math.round((Number(m[2]) + Number(m[4])) / 2); const cy = Math.round((Number(m[3]) + Number(m[5])) / 2); adbShell(`input tap ${cx} ${cy}`); await sleep(3000); } } // ---------- iOS(系统设置 UI,locator 已在 iPhone/iOS26.5 实测) ---------- async function iosSetBluetooth(driver: DeviceDriver, on: boolean): Promise { await driver.activateApp('com.apple.Preferences'); await sleep(2000); // 进入蓝牙二级页:设置首页 cell(文案本地化,中文"蓝牙"/英文"Bluetooth") const entry = (await driver.findElementRaw('accessibility id', '蓝牙').catch(() => null)) || (await driver.findElementRaw('accessibility id', 'Bluetooth').catch(() => null)); if (entry) { await driver.tapElement(entry); await sleep(2000); } // 蓝牙开关:name="BLUETOOTH"(与语言无关),value "1"=开 / "0"=关 const sw = await driver.findElementRaw('accessibility id', 'BLUETOOTH').catch(() => null); if (!sw) { console.warn('[network] iOS 未找到蓝牙开关(accessibility id=BLUETOOTH),跳过'); return; } const val = await driver.getElementAttribute(sw, 'value').catch(() => ''); const isOn = val === '1' || val === 'true'; if (isOn !== on) { await driver.tapElement(sw); await sleep(2500); } } // iOS WiFi(无 adb,走系统设置;locator 已在 iOS26.5 实测:开关 name="无线局域网" value 1/0) async function iosSetWifi(driver: DeviceDriver, on: boolean): Promise { await driver.activateApp('com.apple.Preferences'); await sleep(2000); // 进入 WiFi 页:cell 文案本地化(中文"无线局域网" / 英文"Wi-Fi"/"WLAN") const entry = (await driver.findElementRaw('accessibility id', '无线局域网').catch(() => null)) || (await driver.findElementRaw('accessibility id', 'Wi-Fi').catch(() => null)) || (await driver.findElementRaw('accessibility id', 'WLAN').catch(() => null)); if (entry) { await driver.tapElement(entry); await sleep(2000); } // WiFi 开关:name="无线局域网"(本地化), value "1"=开 / "0"=关 const sw = (await driver.findElementRaw('accessibility id', '无线局域网').catch(() => null)) || (await driver.findElementRaw('accessibility id', 'Wi-Fi').catch(() => null)); if (!sw) { console.warn('[network] iOS 未找到 WiFi 开关,跳过'); return; } const val = await driver.getElementAttribute(sw, 'value').catch(() => ''); const isOn = val === '1' || val === 'true'; if (isOn !== on) { await driver.tapElement(sw); await sleep(2500); } } /** * 按协议设置手机网络状态,然后切回 SwitchBot app。 * 无人值守可用(Android 全自动;iOS 走设置 UI)。 */ export async function applyProtoNetwork(driver: DeviceDriver, proto: 'ble' | 'wifi'): Promise { const wantBluetooth = proto === 'ble'; const wantWifi = proto === 'wifi'; if (driver.platform === 'android') { await androidSetWifi(wantWifi); await androidSetBluetooth(wantBluetooth); await driver.activateApp(APP_CONFIG.android.appPackage); } else { await iosSetWifi(driver, wantWifi); await iosSetBluetooth(driver, wantBluetooth); await driver.activateApp(APP_CONFIG.ios.bundleId); } await sleep(2000); } /** * 关→开手机蓝牙,复位蓝牙栈。BLE 扫描/配对偶发卡死(吸顶灯 Pro "FAIL: connection timeout"、 * 重跑就过)的根治。用于:跑 BLE 控制前、灯类 BLE 配对添加前。失败不抛(非致命)。 * * Android 直接用 `adb svc bluetooth disable/enable` —— 本机(三星)实测可真切 radio(bluetooth_on 1→0→1, * exit=0),不走设置 UI、不与 Appium 冲突、前台 app 不变。(早期机器 svc 被禁才绕设置 UI,本机不需要。) */ export async function resetBluetooth(driver: DeviceDriver): Promise { try { if (driver.platform === 'android') { adbShell('svc bluetooth disable'); await sleep(2500); adbShell('svc bluetooth enable'); await sleep(5000); // 等蓝牙栈重新就绪 } else { // iOS 无 adb,走系统设置 UI 关再开,完成后切回 SwitchBot app await iosSetBluetooth(driver, false); await sleep(1500); await iosSetBluetooth(driver, true); await sleep(4000); await driver.activateApp(APP_CONFIG.ios.bundleId); await sleep(2000); } console.log('已重置手机蓝牙(关→开)'); } catch (e: any) { console.log(`重置蓝牙失败(非致命): ${e.message}`); } } /** 首页"响应度":设备卡数 + 带实时状态(On/Off/℃/%/open 等)的卡数。BLE 未连上时卡片多为无状态/无响应。 */ async function homepageResponsiveness(driver: DeviceDriver): Promise<{ cards: number; stateHits: number }> { const src = await driver.getSource().catch(() => ''); const cards = driver.platform === 'android' ? (src.match(/resource-id="[^"]*\/(nameText|nameTextMeter)"/g) || []).length : (src.match(/XCUIElementTypeCell[^>]*?name="/g) || []).length; // 实时状态关键词(连上 BLE 才会刷出来):开关/温湿度/窗帘/传感器等 const stateHits = (src.match(/(On\b|Off\b|Fully open|Fully closed|Partially open|Opened|Closed|℃|°C|\d%|ppm|Detected|unoccupied|Locked|Unlocked)/g) || []).length; return { cards, stateHits }; } /** * 切到"仅 BLE"模式并**校验设备已连上**:关手机 WiFi → 复位蓝牙 → 下拉刷新首页 → 看卡片是否有响应。 * 大部分卡无响应(BLE 没连上)就重试整套切换(最多 maxRetries 次)。根治"中途切 BLE 后首页卡片全无响应 → BLE 控制整片失败"。 * 仅 Android(BLE 控制阶段);校验是启发式(状态关键词/卡数比例),非致命,失败只告警。 */ export async function switchToBleAndVerify(driver: DeviceDriver, maxRetries = 3): Promise { if (driver.platform !== 'android') return true; adbShell('svc wifi disable'); // 关 WiFi 强制 BLE 直连 await sleep(3000); const { width: w, height: h } = await driver.getWindowSize().catch(() => ({ width: 1080, height: 2280 })); for (let attempt = 1; attempt <= maxRetries; attempt++) { await resetBluetooth(driver); // 关→开蓝牙复位 await driver.activateApp(APP_CONFIG.android.appPackage).catch(() => {}); await sleep(2000); await driver.goBackToHomepage().catch(() => {}); await sleep(1500); // 下拉刷新首页(从上方下拉),触发 App 重新建立 BLE 连接 await driver.swipe(Math.round(w / 2), Math.round(h * 0.22), Math.round(w / 2), Math.round(h * 0.72), 0.6).catch(() => {}); await sleep(10000); // 等 BLE 重连 + 状态刷新 const { cards, stateHits } = await homepageResponsiveness(driver); // 响应度:有状态关键词数 ≥ 卡数的一半,视为大部分设备已连上 const ok = cards > 0 && stateHits >= Math.max(2, Math.ceil(cards * 0.5)); console.log(`[BLE校验] 第${attempt}/${maxRetries}次:卡片${cards}、状态命中${stateHits} → ${ok ? '已连上' : '大部分无响应,重试切换'}`); if (ok) return true; } console.log('[BLE校验] 多次重试后仍大部分无响应(后续 BLE 控制可能失败,日志已标记)'); return false; } // ===== iOS 经桌面快捷指令切网(设置页 WiFi/蓝牙开关 locator 已失效;改用用户在主屏放的快捷指令) ===== // 关键:点快捷指令必须用坐标点(driver.tapElement→wda/tap),element/click 不触发执行。 // WiFi 状态从**状态栏**读(可靠):有 "X格无线局域网信号" 元素=ON,无=OFF。蓝牙状态无法读 → 只盲翻转(由调用方按确定性序列控制)。 /** 读 iOS WiFi 是否开(状态栏 WiFi 信号元素存在=ON)。 */ async function iosWifiIsOn(driver: DeviceDriver): Promise { const src = await driver.getSource().catch(() => ''); return /无线局域网信号/.test(src); // 状态栏元素 "3(共3格无线局域网信号)";关闭时该元素消失 } /** * 消除 iOS 系统弹框(模态,会挡住切网快捷指令)。常见:定位权限(iOS 读 WiFi SSID 需定位)、"好"信息框等。 * 点**允许/好/OK**(不点"不允许",否则定位被拒→WiFi 操作失败)。返回是否点掉了一个。 */ async function dismissIosAlert(driver: DeviceDriver): Promise { for (const b of ['好', '允许', '使用App时允许', '仅在使用时允许', '允许一次', '使用 App 时允许', 'OK', 'Allow', 'Allow Once', 'Allow While Using App']) { const el = await driver.findElementRaw('accessibility id', b).catch(() => null) || await driver.findElementRaw('predicate string', `label == "${b}" OR name == "${b}"`).catch(() => null); if (el) { await driver.tapElement(el).catch(() => {}); await sleep(1200); console.log(`[iOS弹框] 已点「${b}」消除`); return true; } } return false; } /** 退到 iOS 桌面(springboard):本机 home 键(wda/homescreen)不生效,改用 terminate App 可靠退桌面。 */ async function iosToSpringboard(driver: DeviceDriver): Promise { for (let i = 0; i < 3; i++) { await dismissIosAlert(driver); // App 首页/系统模态弹框(定位"好"等)会挡住 terminate/点指令,先消掉 await (driver as any).terminateApp?.(APP_CONFIG.ios.bundleId); await sleep(1500); await dismissIosAlert(driver); // 退桌面后可能又弹,再消一次 const fg = await (driver as any).activeAppId?.().catch(() => ''); if (!fg || /springboard/i.test(fg)) return; // 校验:确实到了桌面 console.log(`[iOS桌面] 仍在前台 App(${fg}),消弹框+重试 terminate(第${i + 1}次)`); } } /** 点主屏某快捷指令(坐标点,真正执行)。先退桌面,快捷指令可能在某一页 → 翻页查找。 */ async function tapHomeShortcut(driver: DeviceDriver, name: string): Promise { await iosToSpringboard(driver); const { width: w, height: h } = await driver.getWindowSize().catch(() => ({ width: 393, height: 852 })); for (let page = 0; page < 6; page++) { const el = await driver.findElementRaw('accessibility id', name).catch(() => null); if (el) { await driver.tapElement(el); return true; } // tapElement=wda/tap 坐标点,能真正触发 await driver.swipe(Math.round(w * 0.85), Math.round(h * 0.6), Math.round(w * 0.15), Math.round(h * 0.6), 0.4).catch(() => {}); await sleep(800); } console.log(`[快捷指令] 翻遍主屏仍未找到「${name}」`); return false; } /** 把 iOS WiFi 设成目标态:退桌面读状态栏→不符就点「设定无线局域网」翻转→复读,最多 retries 次。仅 iOS。 */ export async function iosSetWifiViaShortcut(driver: DeviceDriver, on: boolean, retries = 4): Promise { if (driver.platform !== 'ios') return true; for (let i = 0; i < retries; i++) { await iosToSpringboard(driver); if ((await iosWifiIsOn(driver)) === on) { console.log(`[iOS-WiFi] 已是 ${on ? 'ON' : 'OFF'}`); return true; } await tapHomeShortcut(driver, '设定无线局域网'); await sleep(2500); await dismissIosAlert(driver); // 切 WiFi 会触发定位权限框,挡住生效 → 点掉它 await sleep(2500); // 等 WiFi 切换 + 状态栏刷新 } await iosToSpringboard(driver); const final = await iosWifiIsOn(driver); console.log(`[iOS-WiFi] 多次后 = ${final ? 'ON' : 'OFF'}(目标 ${on ? 'ON' : 'OFF'})`); return final === on; } /** 盲翻转 iOS 蓝牙(点「设定蓝牙」一次)。蓝牙状态无法读 → 由调用方按确定性序列(起始为开)控制。仅 iOS。 */ export async function iosToggleBluetoothShortcut(driver: DeviceDriver): Promise { if (driver.platform !== 'ios') return; const ok = await tapHomeShortcut(driver, '设定蓝牙'); await sleep(4000); console.log(ok ? '[iOS-BT] 已翻转蓝牙(设定蓝牙)' : '[iOS-BT] 未找到设定蓝牙快捷指令'); } /** * iOS:确保蓝牙为「开」(确定性——进设置→蓝牙页读开关 value,关才打开;不盲翻转)。 * 用于**添加阶段前置**:盲翻转的「设定蓝牙」可能把蓝牙留在关闭态,导致添加阶段所有 BLE 设备 * "not found in BLE scan" 批量失败。开跑添加前确定性地把蓝牙打开,根治此类批量假失败。 */ export async function iosEnsureBluetoothOn(driver: DeviceDriver): Promise { if (driver.platform !== 'ios') return; await iosSetBluetooth(driver, true); console.log('[iOS-BT] 已确保蓝牙为开(确定性,添加前置)'); }