Orientação gerada a partir de informações públicas. Apenas para referência.
Um plugin Flutter que expande o device_preview para permitir a captura de screenshots diretamente no ambiente de visualização. Permite que desenvolvedores façam screenshots da interface do aplicativo conforme aparece em diversos dispositivos e tamanhos de tela, facilitando testes visuais rápidos e documentação. O plugin se integra perfeitamente ao pacote device_preview, suportando múltiplas plataformas, incluindo Android, iOS, macOS, Windows e Linux. Ideal para equipes que precisam validar a UI de forma eficiente sem precisar implantar em dispositivos físicos.
Casos de uso
Teste de regressão visual
Documentação da interface do usuário
Validação rápida de design
Verificações de interface do usuário multiplataforma
Melhoria no fluxo de desenvolvimento
Principais recursos
Integração sem interrupções com o device_preview
Suporte multiplataforma
Captura de tela com um toque
Suporta múltiplas emulações de dispositivos
Instantâneos de visualização em tempo real
Indicado para
Desenvolvedores Flutter
designers de UI/UX
testes de QA
equipes de aplicativos multiplataforma
Fluxos de trabalho de prototipagem rápida
Considerações
Requer o dispositivo_preview para ser instalado
Limitado ao modo de pré-visualização apenas
Sem capacidade de captura automática em lote
Capturas de tela não são salvas por padrão
Diferenças de renderização específicas da plataforma podem afetar a saída
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
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:<latestversion>
voidmain() {
DevicePreview.enable();
runApp(constMyApp()); // 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.
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.
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.
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.