aloisdeniel/flutter_device_preview v3.0.0

3.0.0

on GitHub

The stable 3.0 release — a from-scratch rebuild of Device Preview. If you are
coming from 2.x, see Migrating from 2.x in the README: the integration is
now a single line and the in-app toolbar is gone.

The one-paragraph version: a custom WidgetsBinding simulates device
characteristics (screen metrics, safe areas, orientation, folds, keyboard
insets, locales, brightness, text scale, accessibility flags, 24-hour time,
target platform) at the engine-abstraction level, so your app reads them
through the same MediaQuery, layout and locale-resolution paths it uses on a
real device — no widget wrapper, no in-app UI, nothing shipped in release
builds. The simulation is driven from the bundled Flutter DevTools
extension, from Dart through DevicePreview.controller, or from widget
tests via DevicePreviewBindingMixin.

Highlights, relative to 2.x:

• One-line integration: DevicePreview.enable(); runApp(MyApp()); — no
  builder wrapper, no useInheritedMediaQuery, no locale/builder glue on
  your MaterialApp. Off in release builds by default, with zero footprint.
• Full framework fidelity: because the simulation sits below the widget
  layer, safe areas, hit-testing, locale resolution, text scaling and
  accessibility flags behave exactly as they do on device — including
  third-party packages that never heard of Device Preview.
• The UI moved to DevTools: a device picker with framed previews, locale
  and accessibility controls, orientation, text scale, dark mode, a
  screenshot button, and a "New device from JSON…" entry that saves custom
  devices in the browser.
• Programmatic + test control: applyPreset, setOrientation,
  update(copyWith), applyJson, registerPreset, reset — and the same
  simulation in widget tests for golden matrices over many devices.
• A rebuilt device catalog (33 devices): every Apple frame and metric is
  extracted from the real iOS Simulator (Xcode 26.6 / iOS 26.5) and the
  Pixels from the official Android emulator skins (Android 16), artwork
  included; four foldables report their hinge as a display feature; generic
  phone/tablet/desktop windows round it out. Presets carry their frame and
  simulated system UI and tree-shake away when unreferenced.
• Device frames & system UI in-app too: applyPreset shows the framed
  device with a live-tinted status bar and gesture pill even without DevTools
  attached (goldens, CI), painted over the default DotGridDecoration
  letterbox.
• Touch input simulation: the mouse is reported to the app as a finger on
  touch devices (auto by default), so drags scroll and gestures take their
  touch paths.
• A simulated software keyboard: every device carries the height its
  keyboard covers, per orientation — probed from its own simulator for the
  iPhones and iPads, one shared default for the Android devices, whose
  keyboard height belongs to the installed IME — and one switch in DevTools (or
  DeviceSimulation.keyboardInset from Dart) raises it. It arrives as
  MediaQuery.viewInsets.bottom, so resizeToAvoidBottomInset,
  scroll-into-view and the collapsing bottom safe area all behave as they do
  on the device — which is how a form gets checked against the keyboard from
  a desktop that has none. While a device is simulated it is also the only
  keyboard the app sees: the host's own keyboard inset is no longer mapped
  into the simulated screen, where it stood for a length of the wrong
  display.
• The simulated system bars now follow the simulated device's operating
  system, not the host's: SystemUiSimulation.platform (stamped from the
  preset by DevicePreset.resolve and by the DevTools panel) decides the
  platform-specific paint behavior, so an app running on an Android host no
  longer tints a simulated iPhone's status bar and home-indicator band with
  its Android SystemUiOverlayStyle background colors.

Breaking (from the prereleases, for completeness): DevicePreview.enable's
flag is the named enabled parameter; iPad preset ids/names carry their chip
(iPadPro11M4, …); minimum Flutter is 3.47.0 / Dart 3.8.

On pub.dev: https://pub.dev/packages/device_preview/versions/3.0.0