# 真机实验室操作指南

> 在 iPhone 或 iPad 上运行真机实验室测试的分步指南：配置 Web Inspector、给截图命名、提交结果，以及每次测试都要遵守的规则。

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

拿 iPhone 或 iPad，照 2026-10-20 研究公开的[测试流程](https://openpwa.net/research/2026-10-ios18-home-screen-web-apps/data/PROTOCOL.md)重跑测试，就能和公开数据比对结果。已发布的测试只在一台 iPhone 上跑过一次。时间允许时，测试流程还计划安排一小部分 iPad 测试。

## 指南列表

- [在 iPhone 与 iPad 上运行测试](/zh/lab/guides/iphone-ipad/)说明怎样完成一轮测试，从哈希比对到收尾。
- [配置 Web Inspector](/zh/lab/guides/web-inspector/)说明怎样把 iPhone 和 Mac 配对，读取 Safari 标签页和主屏应用的页面状态。
- [截图、录屏与文件命名](/zh/lab/guides/screenshots-and-naming/)说明命名规则、配套的环境信息和打码要求。
- [提交测试结果](/zh/lab/guides/send-results/)需要复制测试页显示的 JSON，用邮件发送。

## 每次测试都要遵守的规则

第 1、2、3、5 条出自公开的测试流程，第 4 条依据研究[报告](https://openpwa.net/research/2026-10-ios18-home-screen-web-apps/data/REPORT.md)第 13 节关于复现的说明。

1. 推送订阅只记录端点的主机名（例如 `web.push.apple.com`），不记录完整端点，也不记录密钥。证据里不能出现其他 App 的内容。截图里凡是有别的 App 的通知、联系人、运营商名称或位置信息，要么裁掉，要么不拍。公开或发送文件之前，去掉设备 UDID 这类标识符；研究[数据包](https://openpwa.net/research/2026-10-ios18-home-screen-web-apps/data/README.md)在发布前就把读数脚本里的 UDID 换成了一个变量。
2. 每台设备每次测试填一份环境信息，包括日期、时间与时区；设备的市场名称和型号号码；系统版本与构建号；发布渠道；Safari 版本与 UA；设备语言与地区；改动过默认值的 Safari 功能标志；内容拦截器、VPN 与 iCloud 专用代理的开关状态；如果用了 Web Inspector，再写上 Mac 和 Safari 的版本。
3. 测试要求时，先删掉主屏图标（长按，选**移除 App**，再选**删除 App**），并在「设置 > App > Safari > 高级 > 网站数据」里清除该网站的数据，然后再开始。
4. 把你加载的文件和 [/lab/harness/v1/SHA256SUMS.txt](/lab/harness/v1/SHA256SUMS.txt) 比对，这份清单列出了 v1 测试页每个文件按实际下发字节计算的 SHA-256。报告这样要求，是因为实验室的页面可能改动。2026-10-20 测试期间，约 08:28 UTC 的一次部署改了 `lab.js`，而已经打开的页面继续用缓存里的旧文件。
5. Safari 的功能标志保持原样，照实记录已经不是默认值的设置。

## 其他平台

2026-10-20 的研究只测了一台 iPhone。这一阶段还没有 Android Chrome、桌面端 Chromium、Firefox 和 Samsung Internet 的操作指南。[路线图](/zh/lab/roadmap/)列出的测试包括 Android 上的分享目标与安装提示，桌面端 Chromium 的文件处理与启动处理，Firefox 的安装入口，以及存储持久化。

<LabProvenance locale="zh" />