pub.dev · #1495 most downloaded on pub.dev

wechat_assets_picker

10.1.358K downloads/mofluttercandies/flutter_wechat_assets_picker ↗New releases in your daily digest, changelog included.

An image picker (also with videos and audio) for Flutter projects based on WeChat's UI, with full support for customization.

Last release 2 months ago
19 Jul 2026
Ships fairly regularly
a new release about every 2 months
Nearly every release is documented
notes for 58 of the last 60 stable releases
2 versions withdrawn
withdrawn after publishing
7 years old
184 releases · first in 2020

Release timeline

184 releases since 2020

Releases

10.1.319 Jul 20262 sources agree
Fix picker and viewer selection syncing when selecting the last allowed asset.
What's Changed

Fixes

Fix picker and viewer selection syncing when selecting the last allowed asset.

Fix Live Photo controllers completing initialization after the asset changes or the preview is disposed.

Fix iCloud videos showing a black frame in the preview between LocallyAvailableBuilder completing and VideoPlayerController.initialize() finishing; a loading indicator now displays for the whole preparation window.

Fix 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.

Fix single-select mode where the grid UI stops refreshing and no other asset can be selected after selecting an asset from the preview page.

Fix the viewer displaying a selectable action for unselected assets after reaching the maximum selection count.

New Contributors

@jelly-dd made their first contribution in #763

@LittleJamie made their first contribution in #760

Full Changelog: v10.1.2...v10.1.3
Open source →

2020202120222023202420252026

20202026

One column per quarter.

10.1.23 May 20262 sources agree

Fix assetGridItemSemanticIndex returning a 0-based index, causing screen readers to announce assets as "Image 0, Image 1, ..." instead of "Image 1, Im

What's Changed

Fixes

Fix assetGridItemSemanticIndex returning a 0-based index, causing screen readers to announce assets as "Image 0, Image 1, ..." instead of "Image 1, Image 2, ...".

Improvements

Add doc declaration about android.permission.READ_MEDIA_VISUAL_USER_SELECTED.

New Contributors

@luomo-pro made their first contribution in #754
@HualiangLI made their first contribution in #750

Full Changelog: v10.1.1...v10.1.2

Open source →

10.1.15 Mar 20262 sources agree

Fix selection syncing between the picker and the viewer.

What's Changed

Fixes

Fix selection syncing between the picker and the viewer.

Full Changelog: v10.1.0...v10.1.1

Open source →

10.1.024 Dec 20252 sources agree

Refactor drag selection to work across all pages globally.

What's Changed

Fixes

Refactor drag selection to work across all pages globally.
Fix "Bad state: No element" crash in onAssetsChanged when paths list is empty.

Full Changelog: v10.0.0...v10.1.0

Open source →

10.0.022 Nov 2025Breaking2 sources agree

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…

What's Changed

Breaking changes

Migrate to Flutter 3.27 and drop support for previous Flutter versions.
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 guide for more details.
Remove deprecated methods.

New features

Support multiple append/prepend specials items.

Full Changelog: v9.8.0...v10.0.0

Open source →

9.8.015 Aug 20252 sources agree

Note 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.

What's Changed

Improvements

Improve themes by inheriting the base theme rather than standalone constructors.

Fixes

Enabling using the package on Flutter 3.35.

Full Changelog: v9.7.0...v9.8.0

Open source →

9.7.012 Aug 2025

Allows to specify the fallback text delegate through assetPickerTextDelegateFromLocale .

What's Changed

Improvements

Allows to specify the fallback text delegate through assetPickerTextDelegateFromLocale.

Full Changelog: v9.6.0...v9.7.0

Open source →

Additional notes

Improvements

Allows specifying the fallback text delegate through assetPickerTextDelegateFromLocale.

Open source →

9.6.08 Aug 20252 sources agree

Expose more route settings. Users will now be able to control the route settings for the picker and viewer.

What's Changed

New features

Expose more route settings.
Users will now be able to control the route settings for the picker and viewer.
Add Persian (Farsi) language support. (Thanks to @Ho3einTahan)

Improvements

Improve how MediaQuery is being listened.
Stop enabling drag to select when maxAssets == 1.
Extract DefaultAssetPickerProvider.init.

Fixes

Fix semantics with the close button.
Fix selectPredicate not being called when selecting the video asset under the WeChat Moment mode.
Manually dispose memory leak objects.

New Contributors

@gavinliu made their first contribution in #692
@Ho3einTahan made their first contribution in #608
@guspan-tanadi made their first contribution in #694
@zeqinjie made their first contribution in #709

Full Changelog: v9.5.1...v9.6.0

Open source →

9.5.122 May 2025

📌 Allow extended_image v10 by @AlexV525 in #690

What's Changed

📌 Allow extended_image v10 by @AlexV525 in #690

Full Changelog: v9.5.0...v9.5.1

Open source →

Additional notes

Improvements

Allow extended_image v10.

Open source →

9.5.019 Feb 20252 sources agree

@WeiJun0507 made their first contribution in #660

What's Changed

New features

Support drag to select.

Fixes

Fixes semantics issues.

New Contributors

@WeiJun0507 made their first contribution in #660

Full Changelog: v9.4.2...v9.5.0

Open source →

9.4.219 Dec 2024

Add Traditional Chinese language text delegate. (Thanks to @Gasol)

Improvements

Add Traditional Chinese language text delegate. (Thanks to @Gasol)
Improves the default sort conditions on Android.

Open source →

9.4.121 Nov 2024

Improves the default sort conditions.

Improvements

Improves the default sort conditions.

Fixes

Fixes selecting when reached the max asset limit in the preview.

Open source →

9.4.08 Nov 2024

Allows assets changing when no path previously.

Improvements

Allows extended_image: ^9.0.0.

Fixes

Allows assets changing when no path previously.

Open source →

9.3.317 Oct 2024

Recovers the compatibility with Flutter 3.16.

Fixes

Recovers the compatibility with Flutter 3.16.

Open source →

9.3.28 Oct 2024

Adapt the file type getter from the image provider to get a precise file type in grid.

Improvements

Adapt the file type getter from the image provider to get a precise file type in grid.
Adds the identifier for grid item's semantics.
Improves preview page back button.

Open source →

9.3.126 Sept 2024

Do not mute the Live Photo during the preview.

Improvements

Do not mute the Live Photo during the preview.

Fixes

Fix the GIF indicator's layout.
Fix the directionality with the reverted grid item.

Open source →

9.3.024 Sept 2024

Add explicit Live Photos indicator for assets.

New features

Add explicit Live Photos indicator for assets.

Improvements

Make Live Photos gesture consistent when scaling and panning.
Integrate LocallyAvailableBuilder with thumbnail options to improve the thumbnail loading speed.
Use visibility_detector and scroll observer to improve media playing experiences.

Fixes

Fix the bottom actions bar display conditions.

Open source →

9.2.215 Sept 2024

Uses correct isOriginal for the LocallyAvailableBuilder.

Uses correct isOriginal for the LocallyAvailableBuilder.

Open source →

9.2.116 Aug 2024

Improve changes when limited on iOS.

Improve changes when limited on iOS.
Use LocallyAvailableBuilder in the grid to provide better user awareness.

Open source →

9.2.01 Aug 2024

Introduce AssetsChangeCallback and AssetsChangeRefreshPredicate to help users act according to asset changes.

New features

Introduce AssetsChangeCallback and AssetsChangeRefreshPredicate to help users act according to asset changes.
Add shouldAutoplayPreview to the picker config.

Fixes

Raise detailed negative range error.
Fix viewer confirm button predication.
Enlarge GIF gradients.
Fix potential paths assets count unexpected merging behaviors.

Open source →

9.1.020 Jun 2024

Support limited permission displays on Android.

Improvements

Support limited permission displays on Android.
Improves the limited overlay padding on Android.
Adds permission request lock for the picker state.
Speeding up by splitting asset loading into separate steps.
Speeding up using AdvancedCustomFilter rather than FilterOptionGroup by default.

Fixes

Fix reverted index when previewing assets on Android.
Requests with the correct options with the picker.

Open source →

9.0.47 Jun 2024

Fix the app bar of the viewer that is not animating.

Fixes

Fix the app bar of the viewer that is not animating.
Fix loading when no assets are in the path.
Reset the has more to load flag between path switching.

Open source →

9.0.39 Apr 2024

Fix index reverting in viewAsset.

Fixes

Fix index reverting in viewAsset.

Open source →

9.0.215 Mar 2024

Fix the index with bottom items in the preview.

Fixes

Fix the index with bottom items in the preview.

Open source →

9.0.17 Mar 2024

Fix the current asset in the picker viewer.

Fixes

Fix the current asset in the picker viewer.

Improvements

Improve code formatting.

Open source →

9.0.027 Feb 2024

Migrate to Flutter 3.16, and drop supports for previous Flutter versions.

Breaking changes

Migrate to Flutter 3.16, and drop supports for previous Flutter versions.
Bump photo_manager to v3.x.
Export photo_manager_image_provider.
Integrate PermissionRequestOption for callers.

Improvements

Adapt ThemeData usages.
Use wechat_picker_library.
Make the first asset count not blocking loads.

Fixes

Fix unhandled child semantics with the app bar title.
Fix styles around the app bar and other widgets.
Fix previewing selected assets' behavior.
Use PermissionRequestOption as much as possible.
Raise more errors for non-synced paths.
Fix the experience with shouldRevertGrid.

Open source →

9.0.0-dev.29 Dec 2023pre-release

Nothing published for this version

9.0.0-dev.17 Dec 2023pre-release

Nothing published for this version

8.9.0-dev.116 Nov 2023pre-release

Nothing published for this version

8.8.1+128 Dec 2023

Nothing published for this version

8.8.128 Dec 2023withdrawn

Nothing published for this version

8.8.016 Nov 2023

Add Korean language support. (Thanks to @LIMMIHEE)

New features

Add Korean language support. (Thanks to @LIMMIHEE)

Improvements

Use viewAsset in the preview button.

Fixes

Fix disposed provider throwing error when fetching assets. (#493)

Open source →

8.7.111 Sept 2023

Improve README docs and add topics for pub.

Improvements

Improve README docs and add topics for pub.

Open source →

8.7.017 Aug 2023

Migrate to Flutter 3.13, and drop supports for previous Flutter versions.

Breaking changes

Migrate to Flutter 3.13, and drop supports for previous Flutter versions.

Open source →

8.6.317 Aug 2023

Improve AssetPickerProvider.paths.

Improvements

Improve AssetPickerProvider.paths.

Open source →

8.6.21 Aug 2023

Add appBarPreferredSize in the picker delegate to help with padding calculations.

Improvements

Add appBarPreferredSize in the picker delegate to help with padding calculations.
Improve the performance with MediaQuery callers.

Open source →

8.6.126 Jul 2023

Remove needTitle for image filter options.

Improvements

Remove needTitle for image filter options.

Fixes

Fix hit test when previewing videos.

Open source →

8.6.023 Jul 2023

Use TargetPlatform for the isAppleOS method in delegates, which relies on a BuildContext.

Breaking changes

Use TargetPlatform for the isAppleOS method in delegates, which relies on a BuildContext.

New features

Sync all UI details from WeChat 8.3.x. (#458)
Add Turkish language text delegate. (Thanks to @cevheri).
Allow to confirm 0 assets if there are selected assets previously. (#461)

Improvements

Silent part of thumbnail request exceptions.

Fixes

Fix semantics interactions for video preview. (#458)
Be able to update the items builder page. (#417)

Open source →

8.5.011 May 2023

Migrate to Flutter 3.10, and drop supports for previous Flutter versions.

Breaking changes

Migrate to Flutter 3.10, and drop supports for previous Flutter versions.

Open source →

8.4.311 May 2023

Add Vietnamese language text delegate. (Thanks to @nploi).

New features

Add Vietnamese language text delegate. (Thanks to @nploi).

Improvements

Expand FilterOptionGroup to PMFilter. (#436)

Open source →

8.4.211 Apr 2023

Avoid clearing selected assets when disposing the provider.

Fixes

Avoid clearing selected assets when disposing the provider. (#428)

Open source →

8.4.124 Mar 2023

Call AssetPickerProvider.dispose when disposing the builder delegate.

Fixes

Call AssetPickerProvider.dispose when disposing the builder delegate. (#421)

Open source →

8.4.07 Feb 2023

Migrate to Flutter 3.7, and drop supports for previous Flutter versions.

Breaking changes

Migrate to Flutter 3.7, and drop supports for previous Flutter versions.

Open source →

8.3.26 Feb 2023

Use Completer and more accurate conditions to avoid duplicate load assets when AssetPickerConfig.pageSize is smaller than a complete page.

Fixes

Use Completer and more accurate conditions to avoid duplicate load assets when AssetPickerConfig.pageSize is smaller than a complete page. (#407)

Open source →

8.3.1+13 Jan 2023

Fix images and descriptions in READMEs.

Improvements

Fix images and descriptions in READMEs.

Open source →

8.3.12 Jan 2023

Add didUpdateViewer and initAnimations in the AssetPickerViewerBuilderDelegate.

New features

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

Open source →

8.3.027 Dec 2022

Add index argument to selectAsset in the AssetPickerBuilderDelegate.

New features

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

Improvements

Improve UI details in the AssetPickerAppBar. (#400)

Open source →

8.2.09 Dec 2022

Allow overrides viewAsset in the AssetPickerBuilderDelegate.

New features

Allow overrides viewAsset in the AssetPickerBuilderDelegate. (#391)

Fixes

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

Open source →

8.1.48 Nov 2022

Fix conditions with the confirm button on iOS.

Fixes

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

Open source →

8.1.312 Oct 2022

Bump photo_manager to explicitly remove the requirements of requiredLegacyExternalStorage.

Improvements

Bump photo_manager to explicitly remove the requirements of requiredLegacyExternalStorage.

Open source →

8.1.24 Oct 2022

Fix conditions with the confirm button.

Fixes

Fix conditions with the confirm button. (#371)

Open source →

8.1.121 Sept 2022

Fix conditions with the confirm button.

Fixes

Fix conditions with the confirm button. (#367)

Open source →

8.1.019 Sept 2022

Upgrade photo_manager for Android 13.

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)

Open source →

8.0.230 Aug 2022

Improvements - Adapt Flutter 3.3.

Improvements

Adapt Flutter 3.3. (#354)

Open source →

8.0.128 Aug 2022

Fix not updated empty flag in DefaultAssetPickerProvider.

Fixes

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

Open source →

8.0.013 Aug 2022Breaking

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 conditions with paths. (#342)
Expose sortPathsByModifiedDate. (#343)

Fixes

Unify indicator usage to avoid accidental indicator switching. (#344)

Open source →

8.0.0-dev.220 Jul 2022pre-release

Nothing published for this version

8.0.0-dev.15 Jul 2022pre-release

Nothing published for this version

7.3.42 Aug 2022

Nothing published for this version

7.3.31 Aug 2022withdrawn

Nothing published for this version

Your coding agent can read these notes before it upgrades. Set up the MCP server →