♻️ Refactored switchPath's signature

Author: AlexV525

example/lib/customs/pickers/directory_file_asset_picker.dart

@@ -369,7 +369,10 @@ class FileAssetPickerProvider extends AssetPickerProvider<File, Directory> {
   }
 
   @override
-  Future<void> switchPath(Directory pathEntity) async {
+  Future<void> switchPath([Directory? pathEntity]) async {
+    if (pathEntity == null) {
+      return;
+    }
     isSwitchingPath = false;
     currentPathEntity = pathEntity;
     totalAssetsCount = 0;

guides/migration_guide.md

@@ -57,7 +57,19 @@ you can stop reading._
 
 #### `AssetPickerProvider`
 
-- The `switchPath` method is now `Future<void>`.
+- The `switchPath` method has a different signature:
+
+Before:
+
+```dart
+void switchPath(P pathEntity);
+```
+
+After:
+
+```dart
+Future<void> switchPath([P? pathEntity]);
+```
 
 ## 5.0.0
 

lib/src/provider/asset_picker_provider.dart

@@ -232,7 +232,7 @@ abstract class AssetPickerProvider<A, P> extends ChangeNotifier {
 
   /// Switch path entity.
   /// 切换路径
-  Future<void> switchPath(P pathEntity);
+  Future<void> switchPath([P? pathEntity]);
 }
 
 class DefaultAssetPickerProvider
@@ -366,7 +366,27 @@ class DefaultAssetPickerProvider
   }
 
   @override
-  Future<void> switchPath(AssetPathEntity pathEntity) async {
+  Future<void> switchPath([AssetPathEntity? pathEntity]) async {
+    assert(() {
+      if (_currentPathEntity == null && pathEntity == null) {
+        throw FlutterError.fromParts(<DiagnosticsNode>[
+          ErrorSummary('Empty $AssetPathEntity was switched.'),
+          ErrorDescription(
+            'Neither currentPathEntity nor pathEntity is non-null, which makes '
+            'this method useless.',
+          ),
+          ErrorHint(
+            'You need to pass a non-null $AssetPathEntity or call this method '
+            'when currentPathEntity is not null.',
+          ),
+        ]);
+      }
+      return true;
+    }());
+    if (_currentPathEntity == null && pathEntity == null) {
+      return;
+    }
+    pathEntity ??= _currentPathEntity!;
     _isSwitchingPath = false;
     _currentPathEntity = pathEntity;
     _totalAssetsCount = pathEntity.assetCount;

lib/src/widget/asset_picker.dart

@@ -267,13 +267,9 @@ class AssetPickerState<A, P> extends State<AssetPicker<A, P>>
     if (!widget.builder.isPermissionLimited) {
       return;
     }
-    final P? pathEntity = widget.builder.provider.currentPathEntity;
-    if (pathEntity != null) {
-      if (pathEntity is AssetPathEntity) {
-        await pathEntity.refreshPathProperties();
-      }
-      await widget.builder.provider.getAssetPathList();
-      await widget.builder.provider.switchPath(pathEntity);
+    await widget.builder.provider.getAssetPathList();
+    if (widget.builder.provider.currentPathEntity != null) {
+      await widget.builder.provider.switchPath();
     }
   }