New features #

• Add didUpdateViewer and initAnimations in the AssetPickerViewerBuilderDelegate. (#403)
• Add insta_assets_picker as an custom delegate example. (#403)

New features #

• Add index argument to selectAsset in the AssetPickerBuilderDelegate. (#399)

Improvements #

• Improve UI details in the AssetPickerAppBar. (#400)

New features #

• Allow overrides viewAsset in the AssetPickerBuilderDelegate. (#391)

Fixes #

• Correct behaviors when the access is limited on iOS. (#392)

Fixes #

• Fix conditions with the confirm button on iOS. (#376)

Improvements #

• Bump photo_manager to explicitly remove the requirements of requiredLegacyExternalStorage.

Fixes #

• Fix conditions with the confirm button. (#371)

Fixes #

• Fix conditions with the confirm button. (#367)

New features #

• Upgrade photo_manager for Android 13. (#365)

Improvements #

• Improve BuildContext usages to obtain the correct directionality for the assets grid. (#359)
• Provide a better condition to the confirm button to make sure it displays correctly in all cases on iOS/macOS. (#359)
• Improve bottomActionBar in DefaultAssetPickerBuilderDelegate. (#359)

Fixes #

• Fix invalid path sort. (#364)

Improvements #

• Adapt Flutter 3.3. (#354)

Fixes #

• Fix not updated empty flag in DefaultAssetPickerProvider. (#353)

To know more about breaking changes, see Migration Guide.

New Features #

• Introduce PathWrapper in delegates to improve the overall loading speed. (#338)
• Allow using Key during picking. (#339)
• Add initializeDelayDuration for DefaultAssetPickerProvider. (#341)
• Prevent race condition with paths. (#342)
• Expose sortPathsByModifiedDate. (#343)

Fixes #

• Unify indicators usage to avoid accidentally indicator switching. (#344)

Improvements #

• Improve onChangingSelected in AssetPickerViewerBuilderDelegate. (#332)
• Fix typo in README.md. (#333)

Fixes #

• Fix behaviors when unselecting all assets in the viewer. (#335)

Improvements #

• Improve selection callers between picker and viewer. (#327)

Migrate to Flutter 3, drop supports for previous Flutter versions.

New features #

• Separate AssetPickerDelegate (#315), which provides the ability to override methods within the AssetPicker.

Improvements #

• Improve specialItemBuilder. (#314)

Fixes #

• Fix context usages for inherited theme data.
• Fix unlinked path name builder.

Improvements #

• Update how paths get update. (#312)
• Expose DefaultAssetPickerProvider.forTest.

Fixes #

• Fix selectPredicate with the viewer. (#307)

New features #

• Add PathNameBuilder. (#303)
• Add LimitedPermissionOverlayPredicate. (#287)

Improvements #

• Support compile on the Web. (#273)

Improvements #

• Make all text delegates const.

Fixes #

• Fix the broken semantics on iOS/macOS. (#272)

Fixes #

• Fix wrong conditions judging when obtaining path thumbnails.

Improvements #

• Support semantics with Japanese text delegates. (#266).

Fixes #

• Obtain the path thumbnail only when asset is image or video.

To know more about breaking changes, see Migration Guide.

New features #

• Support predictable special item display. (#264)
• Support live photos display. (#251)
• Expose AssetPickerPageRoute for customization. (#248)
• Add full semantics support. (#232, #235, #240, #242, #243, #245, #254)

Improvements #

• Improve scaling with select indicators and numbers.
• Implement the default light theme. (#234)

Fixes #

• Fix LocallyAvailableBuilder with more edge conditions. (#263)
• Fix potentially "No elements" error with thumbnails.

• Improve image type determine when resolving image data.This mostly resolved the occasionally HEIC loading issue when apps are running under the release mode.

• Support for Flutter 2.8.0, also drop supports for Flutter below 2.8.0.

• Improve audio item layout.
• Improve workflows.
• Indicate path getter more precisely.
• Improve Arabic text delegate.

• Pass through selectPredicate to AssetPickerViewer. (#211)
• Bump sdk constraints (since 6.2.1).

• Use .contentUri for video preview only on Android.

• Migrate to extended_image 5.x.
• Use .contentUri constructor for VideoPlayerController.

• Introduce shouldRevertGrid to determine whether the assets grid should be reverted.
• Upgrade photo_manager to resolve issues against AssetEntitys comparison.

• Fix limited resources refresh issue.
• Update callers to avoid deprecated usage.

• Handle iCloud video more gracefully.

• Introduce selectPredicate to predicate asset when picking.

• Use the correct index reference with selectedBackdrop. (#195)

• Upgrade dependencies.

• Add French language text delegate. (Thanks to @didiosn)
• Export "Nothing here." as a field to text delegate. (#190)
• Fix selected backdrop not synced all the time.
• Improve the instructions for the example.

• Fix path entity nullable issues with the asset grid.
• Fix assets displaying condition missing with the iOS layout.

• Expose shouldReversePreview for AssetPickerViewerBuilderDelegate.

• Improve total count calculation with AssetPathEntity. (#187)
• Obtain AssetPathEntity.isAll fix from photo_manager.
• Documents update.

New features #

• Sync all UI details from WeChat 8.x.
• Integrate iCloud progress overview in previews.
• Change the permission from the app settings when it's limited.
• Request more assets on iOS when the permission is limited.
• Fit the assets' grid's layout as the iOS Photos app (reverted and started from the bottom).
• Add Arabic language text delegate.
• Allow using AssetPicker and AssetPickerViewer directly with delegates.
• Add keepScrollOffset feature for the AssetPickerBuilderDelegate.

Improvements #

• Items that being banned from select (reached max assets or type conflict) will have a stronger color cover to indicate.
• Video preview in the [SpecialPickerType.wechatMoment] is completely different from other previews.
• Grid items has removed fade builder for more straight feedback after it gets loaded.
• Better interaction when jumping between previewing assets.
• Path entities list layout structure performance & structure improved.
• More precise thumbnail's option for iOS.
• Improve text scale handling. (#177)
• Reduce font size for couple texts.

To know more about breaking changes, see Migration Guide.

• Fix the viewer's select button issue with WeChat Moment on Android.

• Make switchPath method in AssetPickerProvider async.

• Add Japanese language text delegate. (Thanks to @KosukeSaigusa)
• Fix video judge condition with WeChat Moment mode.
• Fix wrong position for the confirm button on iOS with WeChat Moment mode.

• Migrate permissions check to the new API in photo_manager.

• Fix assets reduced under the WeChat Moment mode when previewing.

• Fix static analysis issue.

• Use SystemUiOverlayStyle from the provided theme first.

• Add German language text delegate. (Thanks to @Letalus)
• Add Russian language text delegate. (Thanks to @greymag)

• Implement RenderToggleable to support other channels of flutter (2.1.x - 2.3.x). (Thanks to @Letalus)

• Add findChildIndexBuilder to indicates grid find reusable RenderObject.
• Fix padding issue for the assets' grid.

• Fix missing ScrollController in the scroll view.

• Split AssetGridItemBuidler to solve the rebuild issue.
• Fix GIF indicator stretched issue.

• Export AssetPickerPageRoute.

• Fix format that pub.flutter-io.cn suggest.

• Fully support RTL languages.
• Add control for root navigator.
• Improve AssetEntityImageProvider's constructor and decode.
• Grab iOS/macOS thumbnail's size fix from photo_manager.

• Add gridThumbSize to control thumbnails in the select grid.
• Applies a further fix to the WeChat Moment video preview.
• Fix unlimited assets choose in preview mode.

• Fix WeChat Moment preview issue.

• Add SpecialPickerType.noPreview to disable the preview when picking. (Thanks to @yanivshaked)

• Add Hebrew language text delegate. (Thanks to @yanivshaked)
• Fix slide page route issue when integrate with the get package.

• Fix not synced issue when the picker is under single pick mode.

• Fix selected assets not sync between thumbnail preview mode and grid view.
• Fix wrong index displays in thumbnail preview mode.
• Dependencies upgrade roll.

• Integrate lastModified to sort path entities by default.

• Reset to the top for the asset grid view after switching path.
• Add ability to select assets in any position of the picker.
• Implement mime type for image type judgement.
• Fix disappeared GIFs indicator.

• Fix force cast null type issue with WeChat moment special pick type.
• Improve app bar's type definition.

• Fix path thumb data's display issue.
• Fix default preview thumb size issue with image preview builder.

• Remove required annotation for selected assets.

• Fix wrong viewer provider state.
• Enhance page stream controller sink close.
• Fix dartdoc generate issue for pub.

• Fix video indicator layout issue.
• Prevent video select in WeChat moment mode for edge cases.
• Pickup fixes from photo_manager.

• Add ability to show the special item when the device has no assets.
• Allow users build their own picker with custom assets types. (See example for custom delegate.)
• Slightly reduce performance consume with layout.

Breaking changes #

• Migrate to non-nullable by default.
• CustomItemBuilder -> SpecialItemBuilder, CustomItemPosition -> SpecialItemPosition .
• Abstract AssetPickerBuilderDelegate<A, P>, AssetPickerViewerBuilderDelegate<A, P>, AssetPickerProvider<A, P>, and minify the AssetPickerViewerProvider<A>. Support custom types by generic type.
• The assets param in AssetPickerViewer.pushToViewer is now previewAssets .

• Suppress deprecated usage in example.
• Improve code format with dart format.
• Raise dependencies version.

• Fix arguments judging condition with preview thumb size.
• Remove common exports and split out constants.

• Add previewThumbSize for the viewer.

• Upgrade extended_image .

• Make widgets constant.
• Remove system ui overlays update.
• Migrate files to compatible with Flutter 1.20.0.
• Sync analysis options.

• Ignore size constraint for image assets.
• Format code using dartfmt.
• Upgrade photo_manager.

• Adjust AppleOS layout.

• Add backdrop widget in the picker, which makes the picker more like the one in WeChat.

• Drop asset_audio_player .
• Experimenting status bar hidden on iOS.
• Remove video player listener before pause.

Breaking changes #

• TextDelegate -> AssetsPickerTextDelegate.

• Constraint dependencies version.

• Add FilterOptionGroup. (#41)
• Add SpecialPickerType. (#37)
• Add custom item build mode. (#39)

• Introduce ColorScheme for theme details. (#32)
• Enhance RTL compatibility.
• Enlarge select indicator's size. (#33)

• Remove path entity properties refresh.

• Fix preview widget for audio assets in picker viewer.

• A brand-new example.
• Add SortPathDelegate.
• Using zoom page transition for viewer.
• Slightly add padding to viewer's assets list view.
• Migrate elevation and color to material rendering.
• Request thumb only when request type is not audio.
• Force request title for audio type asset.
• Expose AssetType enum.
• Fix issue with request type.

• Add present english text delegate.
• Refactored theme constructor and getter with theme capability. (#22)
• Update color scheme usage for assets grid. (#23)
• Update picker viewer style for Apple OS.
• Fix bottom bar disappearing on Apple OS when it's single asset mode.

• Fix audio paused accidentally when the app is launching on Android. (#18)

• Expose observe register methods.

• Support audio assets.
• Support single asset mode.
• Enlarge preview button's detector area size.
• Fix wrong properties' usage causing infinite build when the page reaches the end.

Breaking changes #

• videoIndicatorBuilder -> durationIndicatorBuilder.

• Hide detail display when video start to play.
• Switch to ExtendedImageGesturePageView. (#16)
• Add fully theme support.
• Add macOS support.
• Add delay for the first init method to prevent stuck in page routing. (#13)
• Update widgets style on iOS. (#14)
• Fix state of the example not updated after the result was returned without input method activated.

• Support HEIC/HEIF image type.

• Upgrade photo_manager to 0.5.1.
• Replace deprecate TextTheme.title API usage.
• Document (dartdoc) update.

• Bumping flutter sdk minimum version to 1.17.0.
• Declare API stability and compatibility with 1.0.0 ( more details at: https://github.com/flutter/flutter/wiki/Package-migration-to-1.0.0 ).

• Remove loading indicator for image widget.
• Refactor video page's initialization for ratio update.
• Using constants to store text delegate.
• Add error catching for main methods.
• Update text delegate management.

• Fix call on null with currentlySelectedAssets.

• Support paging assets load.
• Fix selected assets not synced with picker provider.
• Bump photo_manager to 0.5.1-dev.5

• Expose page transition curve and duration to static method.
• Fix theme color not passed to static method.

• Fix pageBuilder null issue.

• Add upwards slide page transition.
• Add padding to bottom action bar in picker.

• Add iOS style.
• Add cancel field to text delegate.
• Set -> List.

• Fix missing aspect ratio for video player.
• Using common request type in example.

• Add text delegate support. (Also with i18n support using delegate).

• Support video assets. You can use requestType to select video or video+image.
• Hide system ui overlays according to flag and system.
• Update GIF indicator and add video indicator.

• Initial release.