搜索插件、代码仓与 APP 分类

插件详情v1.0.0

device_preview_screenshot

一个用于 device_preview 的插件,可用来拍摄屏幕截图。

AndroidiOSmacOSWindowsLinux
近 30 天下载
1.3万
喜欢数
17
Pub 分数
130

安装插件

flutter pub add device_preview_screenshot

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

一个扩展 device_preview 的 Flutter 插件,可在预览环境中直接进行截图捕捉。它允许开发者在各种设备和屏幕尺寸上捕获其应用 UI 的截图,从而实现快速的视觉测试和文档编写。该插件与 device_preview 包无缝集成,支持 Android、iOS、macOS、Windows 和 Linux 多个平台。非常适合需要高效 UI 验证但无需部署到实体设备的团队。

适合场景

  • 视觉回归测试
  • UI 文档
  • 快速设计验证
  • 跨平台 UI 检查
  • 开发工作流增强

主要特点

  • 与 device_preview 的无缝集成
  • 跨平台支持
  • 一键截图捕获
  • 支持多种设备模拟
  • 实时预览快照

适合对象

  • Flutter 开发者
  • UI/UX 设计师
  • QA 测试人员
  • 跨平台应用团队
  • 快速原型设计工作流

使用建议

  • 需要安装 device_preview
  • 仅限预览模式
  • 无自动批量截图功能
  • 截图不会默认保存
  • 平台特定的渲染差异可能会影响输出

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

Device Preview for Flutter

Simulate any device — screen, safe areas, locale, accessibility — with full framework fidelity.

You build on one screen; your users arrive on hundreds. Device Preview switches your running app to another device — an old 320pt phone, a tablet in landscape, a notched display, a half-width desktop window — instantly, with no rebuild and no simulator.

Screen size, pixel ratio, safe areas, orientation, folds, the software keyboard, locales, brightness, text scale, accessibility settings and target platform all change with it, and your app reads them through the same MediaQuery it always used. So the problems that normally surface in front of a customer — a clipped headline, a button under the home indicator, an overflow at 200% text — surface in front of you instead.

Control it from Flutter DevTools, from Dart, or from your tests.

Quickstart

dependencies:
  device_preview: <latest version>
void main() {
  DevicePreview.enable();
  runApp(const MyApp()); // runs as usual — now simulatable
}

That's the whole integration. Open DevTools, select the device_preview tab, and pick a device.

enable() is safe to call unconditionally: simulation is active in debug and profile builds and completely off in release, so nothing ships to your users. Pass a value to decide yourself — DevicePreview.enable(enabled: kDebugMode) for debug only, DevicePreview.enable(enabled: false) to turn it off.

Programmatic control:

import 'package:device_preview/presets.dart';

final c = DevicePreview.controller;
await c.applyPreset(DevicePresets.iPhone16Pro);
await c.setOrientation(Orientation.landscape);
await c.update((s) => s.copyWith(textScaleFactor: 2.0, platformBrightness: Brightness.dark));
await c.reset();

DevicePreview.controller throws when simulation is off (every release build); use DevicePreview.maybeController?.… from code that ships.

See device_preview/README.md for the full package documentation, including widget-test support via DevicePreviewBindingMixin.

Documentation

Open the website · Design document

Repository structure

Directory Contents
device_preview The published package: binding, controller, presets, service extensions, bundled DevTools extension build.
device_preview_devtools_extension Source of the DevTools extension web app (never published; built into device_preview/extension/devtools/build).
device_specs The device catalog: one JSON per device — metrics, screen outline and body artwork. Generated into both the extension catalog and the package's built-in DevicePresets; see its README to add a device.
device_frame Legacy device frame drawings package from the 2.x era. Nothing in the 3.0 release depends on it — 3.0 renders frames from the device_specs artwork, carried by the built-in presets and pushed over the DevTools protocol.
docs The website, including its interactive demo — docs/demo is the counter example built for the web, docs/device_catalog.json the catalog its HTML panel pushes to it. Rebuild both with tool/build_demo.sh.

所属分类

依赖

依赖清单 2 项

源码仓库

使用此插件的项目