gallery_media_picker 0.3.0
gallery_media_picker: ^0.3.0 copied to clipboard
A fully customizable and modern Flutter media picker inspired by Instagram. Supports image/video selection, multi-pick, album browsing, and high-performance grid previews using the photo_manager library.
0.3.0 #
New Features #
- Audio media support —
GalleryMediaType.audiofilter for audio-only browsing. - Live gallery refresh — Grid auto-updates when photos are added or deleted externally via
PhotoManagerchange observer. - Album selector — Fully styled album dropdown with dark-theme support.
- i18n support —
GalleryMediaPickerTranslationsfor full localization of picker strings.
Performance #
- O(1) rebuilds —
ValueNotifier-based state management eliminates unnecessary widget rebuilds. - Thumbnail caching —
_assetCacheprevents redundant platform channel calls during scroll. - Cancel token support — Ongoing native extractions are cancelled on deselection to save CPU.
- Origin-first file loading — Bypasses iOS HEIC/HEVC transcoding for faster file access.
Bug Fixes #
- Fixed
PlatformExceptioncrash on iPad when usingshare_plus(missingsharePositionOrigin). - Fixed race condition in
_processPickedFilesForwhere rapid taps caused preview to silently not display. - Fixed stale
_assetCachenot invalidating when gallery observer detected changes. - Replaced hardcoded
'recent'/'recents'strings with centralizedAlbumConstants.isRecentAlbum().
Breaking Changes #
MediaPickerParamsModelnow uses nullable color parameters for M3 theming compatibility.PickedAssetModel.fromAssetEntitynow accepts an optionalPMCancelTokenparameter.
0.2.0 #
- Major architecture refactor with
MediaPickerControllerandGalleryMediaProvider. - Added
ThumbnailQualityenum and configurable grid parameters. - Added permission handling with
PermissionState.
0.0.1 #
- Initial release.