add parameter to getSaveLocation

Author: danferreira

packages/file_selector/file_selector/lib/file_selector.dart

@@ -93,19 +93,25 @@ Future<List<XFile>> openFiles({
 /// [confirmButtonText] is the text in the confirmation button of the dialog.
 /// When not provided, the default OS label is used (for example, "Save").
 ///
+/// [canCreateDirectories] controls whether the user is allowed to create new
+/// directories in the save dialog. When not provided, uses the platform default.
+/// May not be supported on all platforms.
+///
 /// Returns `null` if the user cancels the operation.
 Future<FileSaveLocation?> getSaveLocation({
   List<XTypeGroup> acceptedTypeGroups = const <XTypeGroup>[],
   String? initialDirectory,
   String? suggestedName,
   String? confirmButtonText,
+  bool? canCreateDirectories,
 }) async {
   return FileSelectorPlatform.instance.getSaveLocation(
     acceptedTypeGroups: acceptedTypeGroups,
     options: SaveDialogOptions(
       initialDirectory: initialDirectory,
       suggestedName: suggestedName,
       confirmButtonText: confirmButtonText,
+      canCreateDirectories: canCreateDirectories,
     ),
   );
 }

packages/file_selector/file_selector/test/file_selector_test.dart

@@ -228,6 +228,18 @@ void main() {
       );
       expect(location?.path, expectedSavePath);
     });
+
+    test('sets to disable the creation of new directories', () async {
+      const bool canCreateDirectories = false;
+      fakePlatformImplementation
+        ..setExpectations(canCreateDirectories: canCreateDirectories)
+        ..setPathsResponse(<String>[expectedSavePath]);
+
+      final FileSaveLocation? location = await getSaveLocation(
+        canCreateDirectories: canCreateDirectories,
+      );
+      expect(location?.path, expectedSavePath);
+    });
   });
 
   group('getDirectoryPath', () {
@@ -280,7 +292,7 @@ void main() {
       expect(directoryPath, expectedDirectoryPath);
     });
 
-    test('sets the canCreateDirectories parameter', () async {
+    test('sets to enable de creation of new directories', () async {
       const bool canCreateDirectories = true;
       fakePlatformImplementation
         ..setExpectations(canCreateDirectories: canCreateDirectories)
@@ -343,7 +355,7 @@ void main() {
       );
       expect(directoryPaths, expectedDirectoryPaths);
     });
-    test('sets the canCreateDirectories parameter', () async {
+    test('sets to enable de creation of new directories', () async {
       const bool canCreateDirectories = true;
       fakePlatformImplementation
         ..setExpectations(canCreateDirectories: canCreateDirectories)