NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #1580 most downloaded on pub.dev
An image picker (also with videos and audio) for Flutter projects based on WeChat's UI, with full support for customization.
Latest stable
10.1.3
Last release 4 months ago
19 Jul 2026
Ships fairly regularly
a new release about every 2 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
2 versions withdrawn
withdrawn after publishing
7 years old
184 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
Fix picker and viewer selection syncing when selecting the last allowed asset.
Fixes
LocallyAvailableBuilder completing and VideoPlayerController.initialize() finishing; a loading indicator now displays for the whole preparation window.VideoPageBuilder continuing to initialize and play a video after the widget was disposed or the previewed asset was swapped mid-load, which could leave iCloud videos playing audio in the background after the picker was closed.Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v10.1.2...v10.1.3
Fix assetGridItemSemanticIndex returning a 0-based index, causing screen readers to announce assets as "Image 0, Image 1, ..." instead of "Image 1, Im
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Fixes
assetGridItemSemanticIndex returning a 0-based index, causing screen readers to announce assets as "Image 0, Image 1, ..." instead of "Image 1, Image 2, ...".Improvements
android.permission.READ_MEDIA_VISUAL_USER_SELECTED.Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v10.1.1...v10.1.2
Fix selection syncing between the picker and the viewer.
Fixes
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v10.1.0...v10.1.1
Refactor drag selection to work across all pages globally.
Fixes
onAssetsChanged when paths list is empty.Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v10.0.0...v10.1.0
Make delegate respect generic types as much as possible. This is a breaking change for users who use custom delegates and providers. See the migration…
Breaking changes
New features
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v9.8.0...v10.0.0
> Be aware of potential minor theme changes since the base theme has taken place in the picker's theme.
[!NOTE] Be aware of potential minor theme changes since the base theme has taken place in the picker's theme.
Improvements
Fixes
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v9.7.0...v9.8.0
Allows to specify the fallback text delegate through assetPickerTextDelegateFromLocale.
Improvements
assetPickerTextDelegateFromLocale.Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v9.6.0...v9.7.0
Improvements
assetPickerTextDelegateFromLocale.Expose more route settings. Users will now be able to control the route settings for the picker and viewer.
New features
Improvements
MediaQuery is being listened.maxAssets == 1.DefaultAssetPickerProvider.init.Fixes
selectPredicate not being called when selecting the video asset under the WeChat Moment mode.Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v9.5.1...v9.6.0
📌 Allow extended_image v10 by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/690
extended_image v10 by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/690Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v9.5.0...v9.5.1
@WeiJun0507 made their first contribution in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/660
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v9.4.2...v9.5.0
🚀 Support matching script and country code of locales with the text delegate by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_p
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v9.4.1...v9.4.2
Improvements
Improves the default sort conditions. by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/662
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v9.4.0...v9.4.1
Improvements
Fixes
Allows assets changing when no path previously.
extended_image: ^9.0.0.Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v9.3.3...v9.4.0
Recovers the compatibility with Flutter 3.16.
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v9.3.2...v9.3.3
Adapt the file type getter from the image provider to get a precise file type in grid.
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v9.3.1...v9.3.2
Do not mute the Live Photo during the preview.
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v9.3.0...v9.3.1
Add explicit Live Photos indicator for assets.
LocallyAvailableBuilder with thumbnail options to improve the thumbnail loading speed.visibility_detector and scroll observer to improve media playing experiences.Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v9.2.2...v9.3.0
🐛 Uses correct isOriginal for the LocallyAvailableBuilder by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/626
isOriginal for the LocallyAvailableBuilder by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/626Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v9.2.1...v9.2.2
🚸 Use LocallyAvailableBuilder in the grid to provide better user awareness by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_pic
LocallyAvailableBuilder in the grid to provide better user awareness by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/614Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v9.2.0...v9.2.1
LocallyAvailableBuilder in the grid to provide better user awareness.Introduce AssetsChangeCallback and AssetsChangeRefreshPredicate to help users act according to assets changes.
AssetsChangeCallback and AssetsChangeRefreshPredicate
to help users act according to assets changes.shouldAutoplayPreview in the config.Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v9.1.0...v9.2.0
New features
AssetsChangeCallback and AssetsChangeRefreshPredicate
to help users act according to asset changes.shouldAutoplayPreview to the picker config.Fixes
Support limited permission displays on Android.
AdvancedCustomFilter rather than FilterOptionGroup by default.Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v9.0.4...v9.1.0
🐛 Fix the app bar of the viewer that is not animating. by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/580
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v9.0.3...v9.0.4
Fixes
🐛 Fix index reverting in viewAsset by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/570
viewAsset by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/570Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v9.0.2...v9.0.3
🐛 Fix the index with bottom items in the preview by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/563
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v9.0.1...v9.0.2
CI: Action - Code Analysis by @AmosHuKe in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/559
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v9.0.0...v9.0.1
Fixes
Improvements
> See the Migration Guide for the details of breaking changes between versions.
[!IMPORTANT]
See the Migration Guide for the details of breaking changes between versions.
photo_manager to v3.x.photo_manager_image_provider.PermissionRequestOption for callers.ThemeData usages.wechat_picker_library.PermissionRequestOption as much as possible.shouldRevertGrid.Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.8.0...v9.0.0
🐛 Fix AssetPickerAppBar by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/520
AssetPickerAppBar by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/520Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v9.0.0-dev.1...v9.0.0-dev.2
✨ Integrate PermissionRequestOption for callers by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/517
PermissionRequestOption for callers by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/517ThemeData by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/519Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.9.0-dev.1...v9.0.0-dev.1
feat: Upgrade photo_manager version to 3.x by @CaiJingLong in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/506
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.8.0...v8.9.0-dev.1
💄 Update style usages for ThemeData by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/519
ThemeData by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/519AssetPickerAppBar by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/520Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.8.0...v8.8.1+1
Nothing published for this version
🐛 Fix disposed provider throwing error when fetching assets by @LeGoffMael in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/493
viewAsset in the preview button by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/508Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.7.1...v8.8.0
New features
Improvements
viewAsset in the preview button.Fixes
Improve README docs and add topics for pub.
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.7.0...v8.7.1
Migrate to Flutter 3.13, and drop supports for previous Flutter versions.
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.6.3...v8.7.0
⚡️ Improve AssetPickerProvider.paths by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/473
AssetPickerProvider.paths by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/473Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.6.2...v8.6.3
⚡️ Add appBarPreferredSize by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/469
appBarPreferredSize by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/469Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.6.1...v8.6.2
Improvements
appBarPreferredSize in the picker delegate to help with padding calculations.MediaQuery callers.Remove needTitle for image filter options.
needTitle for image filter options.Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.6.0...v8.6.1
💄 Roll UI design to WeChat 8.3.x by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/458
TargetPlatform for isAppleOS by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/463Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.5.0...v8.6.0
Breaking changes
TargetPlatform for the isAppleOS method in delegates, which relies on a BuildContext.New features
Improvements
Fixes
🚀 Migrate to Flutter 3.10 by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/443
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.4.3...v8.5.0
Breaking changes
Semantics with Vietnamese by @nploi in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/424
FilterOptionGroup to PMFilter by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/436Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.4.2...v8.4.3
New features
Improvements
FilterOptionGroup to PMFilter. (#436)🐛 Avoid clearing selected assets when disposing the provider by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/428
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.4.1...v8.4.2
Fixes
🐛 Call dispose when disposing the builder delegate by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/421
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.4.0...v8.4.1
Fixes
AssetPickerProvider.dispose when disposing the builder delegate. (#421)Migrate to Flutter 3.7, drop supports for previous Flutter versions.
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.3.2+1...v8.4.0
Breaking changes
⚡️ Use completer to avoid duplicate load assets by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/407
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.3.1...v8.3.2
Fixes
Completer and more accurate conditions to avoid duplicate load assets
when AssetPickerConfig.pageSize is smaller than a complete page. (#407)Fix images and descriptions in READMEs.
Improvements
READMEs.New custom Instagram delegate by @LeGoffMael in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/403
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.3.0...v8.3.1
New features
didUpdateViewer and initAnimations in the AssetPickerViewerBuilderDelegate. (#403)Add index argument to selectAsset in the AssetPickerBuilderDelegate.
index argument to selectAsset in the AssetPickerBuilderDelegate. (#399)AssetPickerAppBar. (#400)Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.2.0...v8.3.0
Allow overrides viewAsset in the AssetPickerBuilderDelegate. (#391) This will be considered a breaking change if the user extends classes from AssetPi…
viewAsset in the AssetPickerBuilderDelegate. (#391)
This will be considered a breaking change if the user extends classes from AssetPickerBuilderDelegate.Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.1.4...v8.2.0
New features
viewAsset in the AssetPickerBuilderDelegate. (#391)Fixes
Fix conditions with the confirm button on iOS.
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.1.3...v8.1.4
🔖 Bump photo_manager to explicitly remove the requirements of requiredLegacyExternalStorage by @AlexV525 in https://github.com/fluttercandies/flutter_
photo_manager to explicitly remove the requirements of requiredLegacyExternalStorage by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/373Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.1.2...v8.1.3
Improvements
photo_manager to explicitly remove the requirements of requiredLegacyExternalStorage.🐛 Fix the confirm button when selecting multiple assets with no preview by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.1.1...v8.1.2
🐛 Fix conditions with the confirm button by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/367
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.1.0...v8.1.1
Upgrade photo_manager for Android 13.
photo_manager for Android 13. (#365)BuildContext usages to obtain the correct directionality for the assets grid. (#359)bottomActionBar in DefaultAssetPickerBuilderDelegate. (#359)Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.0.2...v8.1.0
## What's Changed ### Improvements - Adapt Flutter 3.3. (#354) Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.0.1...v8.0.2
Fix not updated empty flag in DefaultAssetPickerProvider.
DefaultAssetPickerProvider. (#353)Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.0.0...v8.0.1
See Migration Guide to know more about breaking changes.
See Migration Guide to know more about breaking changes.
PathWrapper in delegates to improve the overall loading speed. (#338)Key during picking. (#339)initializeDelayDuration for DefaultAssetPickerProvider. (#341)sortPathsByModifiedDate. (#343)Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v7.3.2...v8.0.0
To know more about breaking changes, see [Migration Guide][].
New features
PathWrapper in delegates to improve the overall loading speed. (#338)Key during picking. (#339)initializeDelayDuration for DefaultAssetPickerProvider. (#341)sortPathsByModifiedDate. (#343)Fixes
Add initializeDelayDuration for DefaultAssetPickerProvider.
initializeDelayDuration for DefaultAssetPickerProvider. (#341)sortPathsByModifiedDate. (#342)sortPathsByModifiedDate. (#343)Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v8.0.0-dev.1...v8.0.0-dev.2
To know more about breaking changes, see Migration Guide.
To know more about breaking changes, see Migration Guide.
PathWrapper in delegates to improve the overall loading speed. (#338)Key during picking. (#339)Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v7.3.2...v8.0.0-dev.1
🐛 Unify indicators usage by @AlexV525 in https://github.com/fluttercandies/flutter_wechat_assets_picker/pull/344
Full Changelog: https://github.com/fluttercandies/flutter_wechat_assets_picker/compare/v7.3.2...v7.3.4
Nothing published for this version
One column per quarter.