Skip to content

5.3.0(55)横屏方向重定向 + 首次安装重启提醒

Choose a tag to compare

@wumisc wumisc released this 14 Nov 08:50
· 18 commits to main since this release

5.3.0(55)横屏方向重定向 + 首次安装重启提醒

两件事:让横屏时的小窗画面正过来,让新装用户知道还差重启这一步。

一、横过来的手机,画面是躺着的

以前预览的输出缓冲直接写成小窗的宽高:

// 旧代码(5.2.0 及之前)
surfaceTexture.setDefaultBufferSize(view.getWidth(), view.getHeight());

这一行有两个问题叠在一起:

  1. 相机传感器是横着装的(绝大多数后摄 SENSOR_ORIENTATION = 90),
    Camera2 的预览流本身不做任何旋转,它把传感器那一帧原样塞进 Surface;
    旧代码没有做旋转补偿。
  2. 竖屏时小窗是 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)、三档模式叠加;
后者锁住「只在首次 + 未确认时提示」的四种组合与两套文案分支。