🚀 Add index param in AssetPickerBuilderDelegate.selectAsset (#399)

This PR expose grid `index` param in the `selectAsset` delegate
function.

Author: LeGoffMael

CHANGELOG.md

@@ -4,6 +4,12 @@ that can be found in the LICENSE file. -->
 
 # Changelog
 
+## 8.3.0
+
+### New features
+
+- Add `index` argument to `selectAsset` in the `AssetPickerBuilderDelegate`. (#399)
+
 ## 8.2.0
 
 ### New features

example/lib/customs/pickers/directory_file_asset_picker.dart

@@ -459,7 +459,7 @@ class FileAssetPickerBuilder
   }
 
   @override
-  void selectAsset(BuildContext context, File asset, bool selected) {
+  void selectAsset(BuildContext context, File asset, int index, bool selected) {
     if (selected) {
       provider.unSelectAsset(asset);
     } else {

example/pubspec.yaml

@@ -1,6 +1,6 @@
 name: wechat_assets_picker_demo
 description: The demo project for the wechat_assets_picker package.
-version: 8.2.0+30
+version: 8.3.0+31
 publish_to: none
 
 environment:

guides/migration_guide.md

@@ -14,6 +14,35 @@ This document gathered all breaking changes and migrations requirement between m
 - [6.0.0](#600)
 - [5.0.0](#500)
 
+## 8.3.0
+
+### Summary
+
+Delegates extending `AssetPickerBuilderDelegate` that implements `selectAsset` should add the `index` argument to its signature.
+
+### Details
+
+Before:
+
+```dart
+void selectAsset(
+  BuildContext context,
+  Asset asset,
+  bool selected,
+);
+```
+
+After:
+
+```dart
+void selectAsset(
+  BuildContext context,
+  Asset asset,
+  int index,
+  bool selected,
+);
+```
+
 ## 8.2.0
 
 ### Summary

lib/src/delegates/asset_picker_builder_delegate.dart

@@ -226,7 +226,7 @@ abstract class AssetPickerBuilderDelegate<Asset, Path> {
   /// to involve with predications, callbacks, etc.
   /// 选择资源的方法。自定义的 delegate 可以通过实现该方法，整合判断、回调等操作。
   @protected
-  void selectAsset(BuildContext context, Asset asset, bool selected);
+  void selectAsset(BuildContext context, Asset asset, int index, bool selected);
 
   /// Called when assets changed and obtained notifications from the OS.
   /// 系统发出资源变更的通知时调用的方法
@@ -770,6 +770,7 @@ class DefaultAssetPickerBuilderDelegate
   Future<void> selectAsset(
     BuildContext context,
     AssetEntity asset,
+    int index,
     bool selected,
   ) async {
     final bool? selectPredicateResult = await selectPredicate?.call(
@@ -1344,7 +1345,7 @@ class DefaultAssetPickerBuilderDelegate
               hint: hint,
               image: asset.type == AssetType.image ||
                   asset.type == AssetType.video,
-              onTap: () => selectAsset(context, asset, isSelected),
+              onTap: () => selectAsset(context, asset, index, isSelected),
               onTapHint: semanticsTextDelegate.sActionSelectHint,
               onLongPress: isPreviewEnabled
                   ? () => viewAsset(context, index, asset)
@@ -2036,7 +2037,7 @@ class DefaultAssetPickerBuilderDelegate
         );
         final Widget selectorWidget = GestureDetector(
           behavior: HitTestBehavior.opaque,
-          onTap: () => selectAsset(context, asset, selected),
+          onTap: () => selectAsset(context, asset, index, selected),
           child: Container(
             margin: EdgeInsets.all(indicatorSize / 4),
             width: isPreviewEnabled ? indicatorSize : null,

pubspec.yaml

@@ -3,7 +3,7 @@ description: |
   An audio/video/image picker in pure Dart which is the same with WeChat,
   support multi picking, custom item and delegates override.
 repository: https://github.com/fluttercandies/flutter_wechat_assets_picker
-version: 8.2.0
+version: 8.3.0
 
 environment:
   sdk: '>=2.17.0 <3.0.0'