Files
ykxmz/_build/add_watch_settings_section.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

207 lines
8.4 KiB
Python

# -*- coding: utf-8 -*-
r'''设置页里加「快捷栏」和「允许新设备连接」(第二版)。
== 第一版为什么不行 ==
我原来写的 refresh 是重建整个设置面板,但 `buildSettingsPanel()` 是
**一次性把整页建完**的(没有"往给定容器里建"的版本),而
`root.addView(settingsPanel)` 是在 onCreate 里做的 ——
所以重建出来的面板**没挂在视图树上**,刷完页面就白了。
== 这一版怎么做 ==
用**一个专用容器**装我这两小节:
settingsPanel
└ ScrollView
└ box (LinearLayout)
├ ...原有的各小节...
├ settingsExtraBox <-- 我加的这个
└ 关于
刷新时只清空 `settingsExtraBox` 再填一遍 —— 不动页面其他部分,
也不用碰视图树。开销小,而且不会有"重建后没挂上去"的问题。
== 加两个小节 ==
1. **快捷栏**:3 个格子各点一下,从 7 个动作里选(也能选"留空")。
第 4 格是固定的「显示桌面」—— 界面上写明它改不了,
否则用户会一直找"怎么改第四个"。
2. **允许新设备连接**:关掉后只有配过对的设备能连。
两端的语义必须一致(电脑端设置窗口里也有同名勾选)。
'''
from __future__ import annotations
import sys
from pathlib import Path
ROOT = Path(__file__).resolve().parent.parent
MAIN = ROOT / "android" / "src" / "com" / "lanremote" / "watch" / "MainActivity.java"
ANCHOR = ' // ================= 关于 ================='
SECTION = ''' // ================= 快捷栏 / 允许新设备连接 =================
//
// 这两小节装在**专用容器**里(settingsExtraBox),
// 这样改完设置只刷这一段,不用重建整页 ——
// 重建整页的话 settingsPanel 是新的对象,而 root 上挂的还是旧的,
// 表现就是"一改设置页面就白了"。
settingsExtraBox = new LinearLayout(this);
settingsExtraBox.setOrientation(LinearLayout.VERTICAL);
box.addView(settingsExtraBox, new LinearLayout.LayoutParams(
ViewGroup.LayoutParams.MATCH_PARENT,
ViewGroup.LayoutParams.WRAP_CONTENT));
fillSettingsExtra();
''' + ANCHOR
# ---------------- 各种方法 ----------------
METHODS = ''' /** 让用户选第 slot 格放哪个动作。 */
private void pickQuickSlot(final int slot) {
final java.util.List<String> labels = new java.util.ArrayList<String>();
final java.util.List<String> ids = new java.util.ArrayList<String>();
labels.add("留空(这一格不显示)");
ids.add("");
for (String[] pair : QUICK_ACTIONS) {
labels.add(pair[1]);
ids.add(pair[0]);
}
showChooser("第 " + (slot + 1) + " 格放什么", labels, new Chooser() {
@Override
public void onPick(int index) {
if (index < 0 || index >= ids.size()) {
return;
}
quickSlots[slot] = ids.get(index);
saveQuickSlots();
fillSettingsExtra();
toast("第 " + (slot + 1) + " 格已设为:"
+ quickLabel(quickSlots[slot]));
}
});
}
/** 电脑端当前的「允许新设备连接」状态。本地记一份,连上后以电脑端为准。 */
private boolean allowNewPairing() {
return prefs().getBoolean("allow_new_pairing", true);
}
/** 填「快捷栏」和「允许新设备连接」这两小节。刷新时也调它。 */
private void fillSettingsExtra() {
if (settingsExtraBox == null) {
return;
}
settingsExtraBox.removeAllViews();
settingsExtraBox.addView(sectionTitle("快捷栏"));
settingsExtraBox.addView(hintText("顶部那条栏,最多 4 个按钮。"
+ "最后一个「显示桌面」是固定的、改不了;"
+ "前三个点下面自己选。(还没连上电脑时它们是灰的)"));
for (int slot = 0; slot < QUICK_CUSTOM_SLOTS; slot++) {
final int s = slot;
String now = (quickSlots[s] == null || quickSlots[s].isEmpty())
? "空着" : quickLabel(quickSlots[s]);
settingsExtraBox.addView(smallButton(
"第 " + (s + 1) + " 格:" + now, C_CARD,
new Runnable() {
public void run() {
pickQuickSlot(s);
}
}));
}
settingsExtraBox.addView(smallButton(
"恢复默认(传文件 / 屏幕镜像 / 音效)", C_CARD,
new Runnable() {
public void run() {
quickSlots = new String[]{"file", "mirror", "sfx"};
saveQuickSlots();
fillSettingsExtra();
toast("快捷栏已恢复默认");
}
}));
settingsExtraBox.addView(sectionTitle("允许新设备连接"));
settingsExtraBox.addView(hintText("关掉之后,只有已经配对过的电脑"
+ "能连上来,新电脑会被拒绝。教室里防别人乱连用这个。"));
settingsExtraBox.addView(smallButton(
"现在:" + (allowNewPairing() ? "允许"
: "不允许(只有老设备能连)"),
C_CARD, new Runnable() {
public void run() {
final boolean want = !allowNewPairing();
new android.app.AlertDialog.Builder(MainActivity.this)
.setTitle("允许新设备连接")
.setMessage(want
? "打开后,没配对过的新电脑也能连上。"
: "关掉后,只有已经配对过的电脑能连上,"
+ "新电脑会被拒绝。")
.setPositiveButton(want ? "允许" : "关掉",
new android.content.DialogInterface.OnClickListener() {
public void onClick(android.content.DialogInterface d,
int w) {
// 电脑端执行 + 本地记一份(连不上时也能看到选择)
runFeature("allow_new_pairing",
Json.obj("allow", want),
want ? "允许新设备连接"
: "只允许老设备连接");
prefs().edit()
.putBoolean("allow_new_pairing", want)
.apply();
fillSettingsExtra();
}
})
.setNegativeButton("取消", null)
.show();
}
}));
}
'''
FIELD_ANCHOR = " private LinearLayout quickBar;"
FIELD_ADD = ''' private LinearLayout quickBar;
/** 设置页里装「快捷栏 / 允许新设备连接」那两小节的容器。
* 用专用容器是为了改完只刷这一段,不用重建整页。 */
private LinearLayout settingsExtraBox;'''
PICK_ANCHOR = " private void showSettingsPanel() {"
def main() -> int:
print("=" * 58)
print(" 设置页:快捷栏 + 允许新设备连接(第二版)")
print("=" * 58)
print()
raw = MAIN.read_bytes()
bom = raw.startswith(b"\xef\xbb\xbf")
t = raw.decode("utf-8-sig")
if "fillSettingsExtra" in t:
print(" 已经加过了")
return 0
missing = [k for k, v in {
"关于锚点": ANCHOR,
"showSettingsPanel": PICK_ANCHOR,
"quickBar 字段": FIELD_ANCHOR,
}.items() if v not in t]
if missing:
print(" ✗ 锚点找不到:%s" % ", ".join(missing))
return 1
print(" ✓ 锚点就位")
t = t.replace(ANCHOR, SECTION, 1)
t = t.replace(PICK_ANCHOR, METHODS + PICK_ANCHOR, 1)
t = t.replace(FIELD_ANCHOR, FIELD_ADD, 1)
MAIN.write_bytes((b"\xef\xbb\xbf" if bom else b"") + t.encode("utf-8"))
print(" ✓ 加了 settingsExtraBox 字段 + 容器")
print(" ✓ 加了 fillSettingsExtra / pickQuickSlot / allowNewPairing")
return 0
if __name__ == "__main__":
sys.exit(main())