Repository navigation
5.3.0(55)横屏方向重定向 + 首次安装重启提醒
5.3.0(55)横屏方向重定向 + 首次安装重启提醒
两件事:让横屏时的小窗画面正过来,让新装用户知道还差重启这一步。
一、横过来的手机,画面是躺着的
以前预览的输出缓冲直接写成小窗的宽高:
// 旧代码(5.2.0 及之前)
surfaceTexture.setDefaultBufferSize(view.getWidth(), view.getHeight());这一行有两个问题叠在一起:
- 相机传感器是横着装的(绝大多数后摄
SENSOR_ORIENTATION = 90),
Camera2 的预览流本身不做任何旋转,它把传感器那一帧原样塞进 Surface;
旧代码没有做旋转补偿。 - 竖屏时小窗是 150×260 的竖条,把 4:3 的画面硬缩成 0.58 的长条,
路面被压扁;靠这个「巧合」勉强能看。一旦横过来,压缩方向反过来,
画面就变成侧躺 + 拉长。
所以不是「横屏时才坏」,是横屏时才看得出来。
修法是把方向拆成三件独立的事,三件都放进 PreviewOrientationPolicy(纯逻辑、可单测):
| 环节 | 做什么 | 为什么单独拆 |
|---|---|---|
| 旋转角 | 传感器角度 − 屏幕角度,归一到 0/90/180/270 |
只依赖两个整数,能穷举断言 |
| 缓冲尺寸 | 从相机支持的尺寸里挑比例最接近的(640×480 起、1080p 内) | 不能写窗口宽高,否则 HAL 必然拉伸 |
| 变换矩阵 | 旋转 → 等比铺满 → 取景裁剪,合成一个 3×3 | 用「源图四角映射到窗口哪里」断言,比看截图可靠 |
顺带修了一个相邻的老问题:旋转完成后不会重算。现在旋转角一变就走重算路径,
日志里会留一行,出问题一眼能定位是哪一环:
方向 | 传感器=90° 屏幕=90° 模式=auto → 自动=0° 实转=0° 缓冲=1440x1080
二、小窗自定义页新增「画面方向」三档
不是所有横屏场景都该跟着重力转。手机夹在车把/支架上固定横放、或者躺着看,
自动旋转反而帮倒忙,所以给一个开关:
| 档位 | 行为 | 什么时候用 |
|---|---|---|
| 跟随重力(默认) | 按传感器与屏幕实际方向转正 | 绝大多数情况 |
| 固定竖屏 | 忽略屏幕旋转,永远按竖屏姿势 | 手机固定横装在支架上 |
| 自动翻转 | 在自动结果上再加 180° | 少数 ROM 传感器方向标定相反,画面总是倒的 |
写错的值一律按「跟随重力」处理,不会因为配置脏了就黑屏。
三、首次安装:还差重启一次系统界面
这是装了说没用的头号原因。SafeWalk 的步态判定、悬浮窗、手电联动跑在
SystemUI 进程里,由 LSPosed 在进程启动时把模块代码注入。安装 APK 只是把
代码放到磁盘上,那个进程还在跑旧代码 —— 用户装完直接点开关,看到的是「毫无反应」。
以前这句话只写在文档里,实际没人读。现在放在权限引导页顶部(装完打开 App 的第一屏):
- 一张卡片说明「为什么还差这一步」,不是一句「请重启」
- 一个重启系统界面按钮,走已有的
SystemUiRestarter:Hook 自尽 → su 兜底 - 有 root / 没 root 两套文案:没 root 时明确写出「如果点了没反应,请手动重启手机」,
不能让人以为按钮必然生效 - 点「完成」但还没重启 → 二次确认,把后果说清楚(「开关打开了但什么都没发生」),
但不拦着(用户可能想先去 LSPosed 勾作用域) - 只在首次安装出现:升级安装不弹。每次更新都弹一遍会变成狼来了,
真正需要重启时(改作用域)用户反而不点了
重启成功落一个独立标记(restartSuiAcknowledged),不复用 onboardingDone ——
引导页可以跳过,而「模块到底加载了没有」是另一件事,混用会导致跳过引导页时提醒也一起消失。
四、测试
新增 PreviewOrientationPolicyTest、RestartReminderPolicyTest,前者锁住
四种旋转角的矩阵行为、尺寸挑选的边界(无候选、全太小、超 1080p)、三档模式叠加;
后者锁住「只在首次 + 未确认时提示」的四种组合与两套文案分支。