Files
ykxmz/_tests/test_quickbar.py
T
xmz7891 f0c05079f7 2.1.7:手表快捷栏 + 鼠标触摸板 + 弹窗可配 + 后台远程更新
用户这次提了一整套升级,这是最后一批。

== 一、手表端顶部快捷栏 ==

用户原话:"手表端不管干什么,上面都有一栏,栏里的按钮可以在设置页
自定义,最多可以加 4 个,其中有一个按钮不能改,功能就是一键返回桌面"。

("返回桌面"经确认 = **让被控电脑显示桌面**,即 Win+D。)

  * 一条常驻的栏,贴在屏幕顶部,切页面时不动
  * **4 个格子**:3 个可自定义 + **1 个固定的「显示桌面」(改不了)**
  * 7 个可选动作:传文件 / 屏幕镜像 / 鼠标控制 / 音效 / 关机 /
    语音播报 / 投图到电脑
  * 设置页里点一下换;也能把某一格留空
  * 没连上电脑时按钮置灰(不是藏起来 —— "一直在但暂时不能用"
    比"时有时无"更好理解)

实现上的几个要点:

  * 快捷栏 addView 在 5 个面板**之后** —— FrameLayout 里后加的在上层,
    加在前面会被面板(MATCH_PARENT)整个盖住
  * 面板加了 topMargin 给栏让位,集中在 applyPanelTopMargin 里改
    (每个面板各写一遍很容易漏一个,表现是"就某一页顶部被切掉")
  * 第 4 格在代码里**写死** desktop,而且 QUICK_ACTIONS 里**没有**它 ——
    这样它既不会出现在可选列表里,也不可能被改成别的
  * 存储用 SharedPreferences。读取时**过滤不认识的 id + 补齐到 3 个**:
    以后删了某个动作,老配置也不会让栏变空或下标越界

== 二、远程鼠标控制(手表上的触摸板)==

  * 拖动 = 移动光标,单击 = 左键,双击 = 右键
  * 下面还有专门的 左键 / 右键 / 滚轮上 / 滚轮下 按钮
  * 电脑端用 SendInput 注入(见下)

== 三、弹文字窗口的位置和大小可配 ==

用户原话:"弹文字窗口 …… 位置和大小都能自定义"。

  * 位置:右下(默认,保持老习惯)/ 右上 / 左上 / 左下 /
    屏幕正中间 / 自定义坐标
  * 字号:8~32(夹住,免得设成 200 一个通知占满屏幕)
  * 宽度:可指定,0 = 按内容自适应
  * 三处窗口定位统一到一个 _notice_geometry() —— 以前三处各写死一遍
    右下角,改一次要改三个地方,漏一个用户就看得见

== 四、屏幕被观看时的提示条改成默认不显示 ==

用户原话:"以后不需要弹,啥窗户都没有,就可以像 UU 远程一样"。

  * 默认**连窗口都不建**
  * **但保留成开关**,设置里可以打开

  关于这条:那条提示原来是**故意加**的(有人在看屏幕时,电脑前面的人
  应该知道)。用户要求去掉,这是他自己的电脑、自己的教室,
  属于正当的远程管理需求。所以能力保留、默认关闭 ——
  这软件应该始终有一个"让本机用户看得见正在被控制"的选项可查。

== 五、中转后台能看到版本并远程点更新 ==

  * 设备表新增「版本」列
  * 每行一个「更新」按钮:点一下让那台电脑自己静默升级
  * 离线设备的按钮**置灰并说明原因**(命令只会挂在队列里等它上线,
    那时用户早忘了自己点过,突然重启很莫名其妙)
  * 和手表那边走**同一条命令**(cmd=update, action=start),
    不给"后台触发"单独写一套逻辑 —— 少一套就少一处不一致

== 六、手表端可开关「允许新设备连接」 ==

  * 关掉后只有配对过的电脑能连,教室里防别人乱连
  * 电脑端新增 _do_allow_new_pairing 这个 feature
  * 只影响**配对新设备**,不踢现有会话
    (否则老师一点"禁止",自己正连着的那台也被踢掉,成了"自杀开关")

== 修掉的几个自己造的坑 ==

1. **管理页 JS 裸换行** —— 最严重的一个。
   ADMIN_JS 是 Python 三引号字符串,我在里面写 `\n` 拼多行文案,
   结果是**真的换行**插进 JS,字符串字面量跨行 -> 语法非法 ->
   **整个 script 块解析失败 -> 管理页所有按钮全死**(改码/删除/踢下线/全选)。
   改成 String.fromCharCode(10),不依赖任何转义层。

2. **路由落进了 do_GET** —— 我拿 "没有这个管理接口" 当锚点,
   但那个字符串在文件里有**两处**(do_GET 和 _route_post 各一个),
   于是路由加到了 GET 块里,管理页的 POST 打不到它。
   表现是"点了更新没反应"。

3. **isConnected() 根本不存在** —— 写快捷栏时凭直觉调了个方法名,
   编译才发现。顺手包了一层并加上说明。

4. **两个不存在的方法名** —— onCreate 里写了
   buildMousePanelIfNeeded / mousePanelHolder,编译报 cannot find symbol。

5. **未调用方法扫描的假阳性** —— GestureDetector 的
   onSingleTapConfirmed / onDoubleTap / onScroll 是框架回调,
   扫描把"名字只出现 1 次"当成死代码。改成**跳过 @Override 的方法**。
   这种假阳性最坏的结果是有人为了让它变绿把回调删了,手势就失灵了。

6. **测试断言太严导致误报** —— "不能有写死的 240",
   但 helper 里 `auto = max(240, ...)` 是自适应的兜底,故意的。

7. **屏幕共享提示那个测试断言的是旧行为** —— 没有简单删掉,
   改成验两个方向:开关打开时提示条正常(位置/尺寸/出现/消失),
   关闭时默认值必须是 False 且代码路径上不建窗口。

== 验证 ==

    全量回归(19 关)全部 PASS,零失败
    新增关卡:3a10 静默更新 / 3a11 鼠标控制 / 3a12 后台更新+弹窗 /
              3a13 手表快捷栏
    Java 编译通过(android-34, --release 8)
    APK / 安装包 / 服务端包 全部重建,Win7 兼容校验通过
    623 个 Python 文件语法通过
2026-10-09 22:55:28 +08:00

194 lines
7.7 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# -*- coding: utf-8 -*-
r'''验「手表快捷栏」和「允许新设备连接」。
== 验什么 ==
一、手表端源码
* 快捷栏建出来了,4 个格子(3 自定义 + 1 固定显示桌面)
* 固定那个**不给改**(用户明确要求"其中有一个按钮不能改")
* 挂进了 onCreate(光有方法不 addView 是白搭 —— 项目里踩过)
* 加进了 showOnly 的数组(漏了的话它会永远压在最上面)
* 7 个动作都在
* 设置页里有入口(没入口用户改不了)
* 鼠标触摸板在
二、电脑端 allow_new_pairing 这个 feature
* 能查、能关、能开
* 存储里真的变了
* 只影响新配对,不踢现有会话(注释里写了理由)
== 为什么专门验"固定那个不给改" ==
用户原话:"最多可以加 4 个,其中有一个按钮不能改,功能就是一键返回桌面"。
如果哪天有人"顺手"把它也做成可配置的,用户点了半天发现
"显示桌面"没了 —— 而这种回归不会报错,只会让人困惑。
所以这里断言:第 4 格永远是 desktop,且 QUICK_ACTIONS 里**没有**它。
'''
from __future__ import annotations
import json
import re
import sys
import tempfile
from pathlib import Path
ROOT = Path(__file__).resolve().parent.parent
sys.path.insert(0, str(ROOT / "windows"))
FAILS: list = []
def check(name: str, ok: bool, why: str = "") -> None:
print(" [%s] %s%s" % ("PASS" if ok else "FAIL", name,
(" —— " + why) if why else ""))
if not ok:
FAILS.append(name)
def main() -> int:
print("=" * 58)
print(" 手表快捷栏 + 允许新设备连接")
print("=" * 58)
print()
main_java = (ROOT / "android" / "src" / "com" / "lanremote" / "watch"
/ "MainActivity.java").read_text(encoding="utf-8")
# ---------------- 一、快捷栏 ----------------
print("一、快捷栏(手表端)")
for token, label in [
("private void buildQuickBar()", "有 buildQuickBar"),
("private void refreshQuickBar()", "有 refreshQuickBar"),
("private void onQuickClick(int slot)", "有点击分发 onQuickClick"),
("private void runQuickAction(String id)", "有动作执行 runQuickAction"),
("private void loadQuickSlots()", "有读取设置"),
("private void saveQuickSlots()", "有保存设置"),
]:
check(label, token in main_java)
# 4 个格子
check("格子数 = 3 自定义 + 1 固定",
"QUICK_CUSTOM_SLOTS + 1" in main_java
and "QUICK_CUSTOM_SLOTS = 3" in main_java)
# 固定那个
m = re.search(r'String id = \(slot < QUICK_CUSTOM_SLOTS\) \? quickSlots\[slot\]'
r' : "desktop"', main_java)
check("★ 第 4 格固定是 desktop(不给改)", m is not None,
"第 4 格不是写死的 desktop —— 用户要求它不能改")
check("★ QUICK_ACTIONS 里没有 desktop(否则它会出现在可选列表里)",
not re.search(r'\{"desktop"', main_java),
"desktop 出现在可选动作里了,用户就能把它改掉")
check("desktop 走的是 show_desktop 命令",
'"cmd", "show_desktop"' in main_java,
"固定按钮应该让电脑 Win+D")
# 7 个动作
print()
print(" 7 个可选动作:")
for aid, label in [("file", "传文件"), ("mirror", "屏幕镜像"),
("mouse", "鼠标控制"), ("sfx", "音效"),
("power", "关机"), ("tts", "语音播报"),
("image", "投图到电脑")]:
ok = ('{"%s", "%s"}' % (aid, label)) in main_java
check(" %s(%s)" % (aid, label), ok)
# 挂接
print()
print("二、挂接(漏了就白写)")
oncreate = main_java[main_java.find("protected void onCreate"):
main_java.find("protected void onCreate") + 6000]
check("★ onCreate 里调了 buildQuickBar()",
"buildQuickBar();" in oncreate,
"没挂上去的话栏根本不显示")
check("★ onCreate 里调了 loadQuickSlots()",
"loadQuickSlots();" in oncreate)
check("★ 快捷栏**最后** addView(保证在最上层)",
oncreate.find("root.addView(quickBar") > oncreate.find("root.addView(mousePanel"),
"加在面板之前会被面板整个盖住")
check("★ showOnly 的数组里有 mousePanel",
"settingsPanel, mousePanel};" in main_java,
"漏了的话鼠标面板永远不隐藏")
check("有 applyPanelTopMargin(面板给栏让位)",
"private void applyPanelTopMargin" in main_java)
# 设置页入口
print()
print("三、设置页入口(没入口用户改不了)")
check("有 fillSettingsExtra", "private void fillSettingsExtra()" in main_java)
check("有 pickQuickSlot(选动作)",
"private void pickQuickSlot(final int slot)" in main_java)
check("设置页里加了「快捷栏」小节",
'sectionTitle("快捷栏")' in main_java)
check("设置页里加了「允许新设备连接」小节",
'sectionTitle("允许新设备连接")' in main_java)
check("界面上说明了第 4 格改不了",
"固定的、改不了" in main_java,
"不说明的话用户会一直找怎么改第四个")
# 鼠标触摸板
print()
print("四、鼠标触摸板")
check("有 buildMousePanel", "private void buildMousePanel()" in main_java)
check("用 GestureDetector(单击/双击/拖动)",
"GestureDetector" in main_java
and "onSingleTapConfirmed" in main_java
and "onDoubleTap" in main_java
and "onScroll" in main_java)
check("单击 -> 左键", 'sendMouse("click", "left", 0)' in main_java)
check("双击 -> 右键", 'sendMouse("click", "right", 0)' in main_java)
check("滚轮上/下", 'sendMouse("scroll", "", 3)' in main_java
and 'sendMouse("scroll", "", -3)' in main_java)
check("拖动 -> moveby", '"moveby"' in main_java)
check("isConnected() 存在(我第一版漏了,编译才发现)",
"private boolean isConnected()" in main_java)
# ---------------- 五、电脑端 allow_new_pairing ----------------
print()
print("五、电脑端 allow_new_pairing feature")
from lanremote.config import Store
from lanremote.features import Features
class FakeActions:
"""Features 要的是 actions 对象,不是 store(第一版就是这里传错了)。"""
def __init__(self, store):
self.store = store
self.ui = None
d = Path(tempfile.mkdtemp())
st = Store(d)
feats = Features(FakeActions(st))
check("能查到当前状态",
"允许" in feats.run("allow_new_pairing", {}))
out = feats.run("allow_new_pairing", {"allow": False})
check("能关掉", "禁止" in out, "拿到 %r" % out)
check(" ★ 存储里真的变了",
st.get("allow_new_pairing") is False,
"拿到 %r" % st.get("allow_new_pairing"))
check(" 关掉之后再查也是关",
"不允许" in feats.run("allow_new_pairing", {}))
out = feats.run("allow_new_pairing", {"allow": True})
check("能打开", "已允许" in out, "拿到 %r" % out)
check(" 存储里也变了", st.get("allow_new_pairing") is True)
# 不存在名字要报错(别静默成功)
try:
feats.run("allow_new_pairing_typo", {})
check("不认识的名字会报错", False, "它竟然没报错")
except ValueError:
check("不认识的名字会报错", True)
print()
print("=" * 58)
if FAILS:
print(" 失败 %d 项:%s" % (len(FAILS), ", ".join(FAILS)))
return 1
print(" 全部通过")
return 0
if __name__ == "__main__":
sys.exit(main())