# 真机实验室测试流程

> 真机实验室每个测试编号的用时、在各版本测试页中对应的页面、它服务的行为主题，以及每次测试都要遵守的规则。

import LabTestIndex from '@components/lab/LabTestIndex.astro';
import LabProvenance from '@components/lab/LabProvenance.astro';

一项测试是在设备上打开公开测试页、按编号完成的一段简短流程，编号从 T0、T1 依次往下。回答同一个问题的结果收在同一张[行为页](/zh/lab/behaviour/)里。编号后缀表示变体：`-WI` 需要接一台开着 Web Inspector 的 Mac，`T4b` 是 T4 的状态栏样式变体，`T5b` 用第三方浏览器重做一遍「添加到主屏幕」检查。

## 一个测试由哪些部分组成

动手之前，先记下预期结果和出处。完成操作后，记录屏幕和页面实际显示了什么，与预期不同也算一项发现。流程要求每个测试不超过 5 分钟，整张清单不超过 1 小时；超时的测试就地停下，记为 `incomplete` 并写明原因。

### 干净状态

标明「干净状态」的测试，开始时不能留有上一次测试的痕迹。[测试流程](https://openpwa.net/research/2026-10-ios18-home-screen-web-apps/data/PROTOCOL.md)给出了 iPhone 上的做法：重新添加之前先删掉主屏图标（长按图标，选**移除 App**，再选**删除 App**），并在「设置 > App > Safari > 高级 > 网站数据」里清除该网站的数据（更早的版本在「设置 > Safari > 高级」）。「网站数据」这一项，Apple 在 [Delete your Safari history, cache, and cookies on iPhone](https://support.apple.com/en-us/105082)（apple.com）里有说明。依赖先前状态的测试（比如要求在「添加到主屏幕」之前先在 Safari 里写入一个 Cookie）会写明它需要什么状态。

### 标签页与主屏应用

同一个页面，在 Safari 标签页里和从主屏图标启动时，表现可能不一样。2026-10-20 那次测试里，带 manifest 的主屏 Web 应用运行在独立于 Safari 的进程中，存储也独立；而没有 manifest、没有图标的页面从主屏打开后，仍在 Safari 的进程里运行，用的也是 Safari 的存储（[主要发现](https://openpwa.net/research/2026-10-ios18-home-screen-web-apps/data/FINDINGS.md)第 1 条）。每次读数都标明环境，`tab` 或 `app`，每条结果也写明覆盖哪个环境。各版本测试页见[测试页版本](/zh/lab/harness/)。

### 记录与置信度

测试记录使用同一组字段，包括结果（`as-expected`、`differs`、附原因的 `could-not-run`，或附原因的 `incomplete`）、一两句事实性的观察（屏幕上的文字按界面语言原样引用）、关键数值、截图文件名和用时。结果还附置信度标签，按研究[报告](https://openpwa.net/research/2026-10-ios18-home-screen-web-apps/data/REPORT.md)第 5.4 节的定义填写。A 表示代理测得的仪器读数，原样存放在 `raw/` 里（来自 Web Inspector 读数，部分标签页数值来自 WebDriver 读数）；S 表示操作员拍下、事后由代理分析的截图或录屏；O 表示只有操作员的口头报告。A+S 这样的组合表示几个相互独立的来源结论一致。

## 测试列表

测试索引按编号列出用时、适用平台、各版本对应的测试页及相关行为。v1 测试页都在 `/lab/device-tests/` 下，设置了 `noindex`，在要测试的设备上打开。

<LabTestIndex locale="zh" />

## 测试前后

把你加载的文件和公开的哈希比对一下。v1 测试页每个文件按实际下发字节计算的 SHA-256 列在 [/lab/harness/v1/SHA256SUMS.txt](/lab/harness/v1/SHA256SUMS.txt) 里。研究报告要求复测者把下发的文件和记录的哈希比对，因为实验室的页面可能改动；2026-10-20 测试期间就改过一次。约 08:28 UTC 的一次部署改了 `lab.js`，而已经打开的页面继续用缓存里的旧文件（第 10 节 Harness drift 一条）。[iPhone 与 iPad 指南](/zh/lab/guides/iphone-ipad/)里有做这项比对的脚本。

<LabProvenance locale="zh" />