wechat_assets_picker

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

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.

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

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.

What's Changed

Fixes

• Fix selection syncing between the picker and the viewer.

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

Fixes

• Fix selection syncing between the picker and the viewer.

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

Fixes

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

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

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.

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

[!NOTE] Be aware of potential minor theme changes since the base theme has taken place in the picker's theme.

Improvements

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

Fixes

• Enabling using the package on Flutter 3.35.

What's Changed

Improvements

• Allows to specify the fallback text delegate through assetPickerTextDelegateFromLocale.

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

Improvements

• Allows specifying the fallback text delegate through assetPickerTextDelegateFromLocale.

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

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.

What's Changed

• 📌 Allow extended_image v10 by @AlexV525 in #690

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

Improvements

• Allow extended_image v10.

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

New features

• Support drag to select.

Fixes

• Fixes semantics issues.

Improvements

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

Improvements

• Improves the default sort conditions.

Fixes

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

Improvements

• Allows extended_image: ^9.0.0.

Fixes

• Allows assets changing when no path previously.

Fixes

• Recovers the compatibility with Flutter 3.16.

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.

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.

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.

• Uses correct isOriginal for the LocallyAvailableBuilder.

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

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.

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.

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.

Fixes

• Fix index reverting in viewAsset.

Fixes

• Fix the index with bottom items in the preview.

Fixes

• Fix the current asset in the picker viewer.

Improvements

• Improve code formatting.

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.

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)

Improvements

• Improve README docs and add topics for pub.

Breaking changes

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

Improvements

• Improve AssetPickerProvider.paths.

Improvements

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

Improvements

• Remove needTitle for image filter options.

Fixes

• Fix hit test when previewing videos.

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)

Breaking changes

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

New features

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

Improvements

• Expand FilterOptionGroup to PMFilter. (#436)

Fixes

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

Fixes

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

Breaking changes

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

Fixes

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

New features

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

Improvements

• Fix images and descriptions in READMEs.

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

Fixes

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