# 运行时截图
通过 CLI 对已运行的 uni-app x 项目截图，支持手机/模拟器（Android、iOS、鸿蒙）与 Web。该功能常用于辅助 AI 判断页面显示是否准确。
适用平台：
app-android/app-ios/app-harmony/web。平台对照见 CLI 概述。
# 通用参数
| 参数 | 说明 |
|---|---|
--help | 查看命令帮助 |
--project | 项目绝对路径 |
--deviceId | 设备序列号，需与当前运行会话一致；不填则使用该平台下最近连接的一台设备 |
--saveFile | 截图保存的完整文件路径（如 .png），必填 |
--fullPage | 截图类型，true 为长图、false 为当前屏，默认 true |
--browser | Web 端浏览器类型，仅 Chrome 或 Built（内置浏览器） |
# screencap app-android
cli screencap app-android --project 项目绝对路径 --saveFile /Users/apple/Desktop/screenshot.png
# 指定设备
cli screencap app-android --project 项目绝对路径 --deviceId 设备序列号 --saveFile screenshot.png
# 只截当前屏
cli screencap app-android --project 项目绝对路径 --saveFile screenshot.png --fullPage false
# screencap app-ios
cli screencap app-ios --project 项目绝对路径 --saveFile screenshot.png
# screencap app-harmony
cli screencap app-harmony --project 项目绝对路径 --saveFile screenshot.png
# screencap web
对已运行到浏览器的 Web 项目截图，仅支持 Chrome 或内置浏览器（Built）。
cli screencap web --project 项目绝对路径 --saveFile screenshot.png
# 指定浏览器
cli screencap web --project 项目绝对路径 --saveFile screenshot.png --browser Chrome
