Files
ykxmz/_tests/test_apk_contents.py
T
xmz7891 fd8be87209 2.1.8:修 Win7 语音播报 + 快捷栏按钮做大且4格全能换
用户这一轮报了两个问题,都修了。

== 一、Win7 上语音播报不能用 ==

用户原话:"我 win7 上的语音播报好像不能用,你再试一下别的版本能不能用"

**原来只有一条路**:

    powershell -NoProfile -WindowStyle Hidden -Command
        "Add-Type -AssemblyName System.Speech; $s = New-Object ...; $s.Speak('...')"

这在 Win7 上有三个坑,任何一个都能让它彻底不出声:

  1. **`powershell` 只按名字找**
     Win7 的 powershell.exe 在 `%SystemRoot%\System32\WindowsPowerShell\v1.0\`。
     精简版系统、或从服务/计划任务拉起时 PATH 里可能没有 ——
     CreateProcess 按名字找不到时是**静默失败**的。

  2. **Win7 默认 PowerShell 2.0,它按 ANSI 代码页解析 `-Command`**
     PS 3.0 起才按 UTF-16 处理。中文经 `-Command` 传进去容易乱码 ——
     表现是念出来是乱码,或者干脆不念。

  3. **`System.Speech` 需要 .NET Framework 3.0+**
     而系统自带的 **SAPI5** 从 Windows XP 就有,**根本不需要 .NET**。

**改成多方案降级**,按"依赖越少越优先"排:

    1. cscript + VBScript + SAPI5      <- Win98 起就有,不用装任何东西
    2. wscript + VBScript + SAPI5      <- 上一条被安全软件拦时的备选
    3. powershell + SAPI5 (COM)        <- 绕开 .NET
    4. powershell + System.Speech      <- 原来的做法,改用绝对路径
    5. powershell(PATH) + System.Speech <- 最原始的,兜底

一条通了**记住它**,以后直接用(不用每次从头试)。

**顺带修掉一个"骗人"的行为**:原来 `say()` 用 `Popen` 不等进程结束,
失败了也返回"已播报" —— 明明没出声却报成功。
现在等退出码,**全失败会明确报错并列出试过哪几条**。
代价是同步等待(念多久等多久),但"报成功其实没出声"比"慢一点"糟糕得多。

还加了 `_build/diag_tts.py`:在一台机器上把 5 条方案全试一遍并报告
哪条能用 —— 下次再有"某台机器上不行",跑一下就知道。

VBScript 的细节:**必须用 ANSI(mbcs) 写**,写成 UTF-8 的话
cscript 读出来中文是乱码(VBScript 的老规矩,很隐蔽)。
长文本还要分句 —— VBScript 单行有长度上限。

== 二、快捷栏按钮太小 + 4 格都要能换 ==

用户原话:"屏幕最上面这个按钮有些按不到,按钮太小了,做大一点,
           然后呢,这个每每个四格算换一下吧,第一个第二个第三个
           第四个都能换东西"

  * **按钮做大**:30dp -> 46dp(接近 Android 建议的最小可点区域 48),
    字号 11 -> 14。30dp 在表盘上手指按上去一半在栏外。
    **栏高做成常量 QUICK_BAR_DP,栏高 / 面板 topMargin / addView
    三处用同一个值** —— 分三处写的话改一个忘一个,
    表现是"内容被盖住"或"上面空一条"。

  * **4 格全部可自定义**。用户最早说"其中有一个按钮不能改,
    功能就是一键返回桌面",第一版就按"第 4 格写死 desktop"做的。
    现在他改主意了 —— 所以 desktop 变成**普通可选动作**,
    默认仍放第 4 格(习惯不用改),但想换也能换。
    可选动作从 7 个变成 8 个。

  **教训(写进测试注释了)**:别把"用户当时的一句话"当成永久约束
  焊进结构里;真是约束的话,注释里要写清是什么时候的要求,
  下次他改主意时才知道该动哪儿。

== 三、修一个"测试自己没擦干净"造成的假 bug ==

全量回归报:

    [FAIL] 配对码正确写入  实际 '(旧的残留值)'

而 `(旧的残留值)` 是**上一次测试遗留**的配对码 —— 数据目录
`C:\ProgramData\ykxmz\data` 在卸载时**故意不删**(那里存着用户的
中转地址、配对码等,卸载不该删),所以机器上会留着上一轮的
settings.json。测试装的时候虽然传了 `/CODE=517284`,但环境没擦干净时
就可能读到旧值 —— 表现成"安装包有 bug"。

**修法**:`test_installer_cycle.py` 加一步"装前先清残留"
(正规卸载 -> 杀进程 -> 删安装目录 -> **删数据目录**)。
数据目录那一步是关键 —— 卸载器不删它。

== 四、其他 ==

  * `docs/项目规矩.md` 第一节改成**按预案执行**:
    预案一 = 做完测试没问题就上传;预案二 = 做完测试但不上传,直接给用户。
    用户没说预案几时默认按预案一,并在交付时说明。
  * 顺手把那份文档里的老域名 `relay.xxmxxs.top` 改成现在的
    `yk.xxmxxs.top`(老服务器早就退役了)。
  * 修掉自己造的重复定义:往 actions.py 插降级链时,
    `list_voices` / `say` 各插了两份(pyflakes 报 redefinition)。
  * 一次危险的误操作:`Path.write_text(..., newline='\n')` 会**先截断文件
    再校验参数**,参数非法时文件已经空了 —— 我用它把
    `_tests/test_quickbar.py` 清空了。已重写。
    **以后不给 write_text 传 newline。**

== 验证 ==

    全量回归(21 关)全部 PASS
    新增关卡:3a13 手表快捷栏 / 3a14 语音播报降级
    安装包周期 23 项全过(装 -> 验 -> 卸 -> 再验)
    Java 编译通过(android-34, --release 8)
    本机实测语音播报:cscript 那条通了(2.4 秒)
    全部产物重建,Win7 兼容校验通过
2026-10-09 23:30:05 +08:00

148 lines
5.3 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 -*-
"""检查手表 APK 是否真的把「遥控诊断」合并进去了。
合并前是两个 APK(手表端 + 独立的遥控诊断 App)。
合并后只需要一个:主程序里有「设备诊断」按钮。
这里从 APK 的 dex 和清单里核实,而不是只信源码。
"""
from __future__ import annotations
import re
import subprocess
import sys
import tempfile
import zipfile
from pathlib import Path
ROOT = Path(__file__).resolve().parent.parent
# 别写死版本号 —— 一升级就坏(这坑踩过好几回了)。
# 直接扫 dist 里最新的手表 APK。
def _latest_apk() -> Path:
candidates = sorted(
(ROOT / "dist").glob("*watch*.apk"),
key=lambda p: p.stat().st_mtime, reverse=True)
return candidates[0] if candidates else \
ROOT / "dist" / "ykxmz-watch-2.1.8.apk"
APK = _latest_apk()
DIAG_APK = ROOT / "dist" / "LanRemote-Diag-1.1.0.apk"
AAPT = (Path(r"C:\Users\shu\Desktop\deepseekagent\starklink\toolchain")
/ "android-sdk" / "build-tools" / "34.0.0" / "aapt.exe")
PASSED = 0
FAILED = 0
def check(name: str, ok: bool, detail: str = "") -> None:
global PASSED, FAILED
if ok:
PASSED += 1
print(f" [PASS] {name}")
else:
FAILED += 1
print(f" [FAIL] {name} {detail}")
def main() -> int:
print("=" * 68)
print("一、手表 APK 里有没有内置诊断")
print("=" * 68)
if not APK.is_file():
print(f" 找不到 {APK}")
print(" 请先运行 android\\build_apk.ps1")
return 1
with zipfile.ZipFile(APK) as archive:
dex = archive.read("classes.dex")
names = {item.decode() for item in
re.findall(rb"Lcom/lanremote/[A-Za-z0-9_/]+;", dex)}
print(f" dex 中的类: {len(names)} 个")
check("APK 里有 Diagnostics 类(诊断逻辑已内置)",
"Lcom/lanremote/watch/Diagnostics;" in names,
str(sorted(names)))
check("APK 里有 DiscoveryCore(诊断与主程序共用同一份发现实现)",
"Lcom/lanremote/watch/DiscoveryCore;" in names)
check("APK 里有 MainActivity", "Lcom/lanremote/watch/MainActivity;" in names)
# 注意:不能用 "diag" 做子串判断 —— Diagnostics 里也含 diag。
# 要查的是旧的独立包名 com/lanremote/diag/。
legacy = [n for n in names if n.startswith("Lcom/lanremote/diag/")]
check("不含旧的独立诊断包 com.lanremote.diag",
not legacy, str(legacy))
print()
print("=" * 68)
print("二、清单权限(诊断读 WiFi 名称需要定位权限)")
print("=" * 68)
# aapt 不认中文路径,先拷到纯 ASCII 路径
with tempfile.TemporaryDirectory() as tmp:
simple = Path(tmp) / "watch.apk"
simple.write_bytes(APK.read_bytes())
try:
proc = subprocess.run(
[str(AAPT), "dump", "badging", str(simple)],
capture_output=True, timeout=60)
badging = proc.stdout.decode("utf-8", errors="replace")
except Exception as exc: # noqa: BLE001
badging = ""
print(f" aapt 调用失败: {exc}")
if badging:
for permission, why in (
("android.permission.ACCESS_FINE_LOCATION", "读 WiFi 名称"),
("android.permission.INTERNET", "网络通信"),
("android.permission.CHANGE_WIFI_MULTICAST_STATE", "UDP 广播"),
):
check(f"声明了 {permission.split('.')[-1]}({why})",
permission in badging)
check("没有申请定位以外的敏感权限",
"READ_CONTACTS" not in badging
and "READ_SMS" not in badging
and "CAMERA" not in badging
and "RECORD_AUDIO" not in badging)
else:
check("能读取 APK 清单", False, "aapt 没有输出")
print()
print("=" * 68)
print("三、构建脚本不再依赖独立诊断 APK")
print("=" * 68)
package = (ROOT / "_build" / "package.py").read_text(encoding="utf-8")
check("package.py 不再要求 Diag APK",
"DIAG_APK" not in package, "仍引用 DIAG_APK")
check("package.py 说明里写明诊断已合并",
"合并" in package)
src = (ROOT / "android" / "src" / "com" / "lanremote" / "watch"
/ "MainActivity.java").read_text(encoding="utf-8")
# 用户要求:"安卓端中转设置下面,把那个设备诊断给删了,
# 换成输入配对码,输入对应配对码就可以连接对应电脑"
# 所以这里反过来断言:不该再有设备诊断入口,而是配对码输入。
import re as _re
code = _re.sub(r"//[^\n]*", "", src)
check("主界面不再有「设备诊断」入口", "设备诊断" not in code)
check("主界面不再调用 Diagnostics.build",
"Diagnostics.build(" not in code)
check("主界面不再调用 Diagnostics.manualTest",
"Diagnostics.manualTest(" not in code)
check("换成了「输入配对码连接」入口",
'bigButton("输入配对码连接"' in code)
check("配对码连接走中转(connectByCode)",
"private void connectByCode(" in code)
print()
print("=" * 68)
print(f"通过 {PASSED} 项,失败 {FAILED} 项")
print("=" * 68)
return 1 if FAILED else 0
if __name__ == "__main__":
sys.exit(main())