Update file_selector_platform_interface by adding the new property 'uniformTypeIdentifiers' to the XTypeGroup.

Author: Juan Angel Dausa

packages/file_selector/file_selector_platform_interface/CHANGELOG.md

@@ -1,5 +1,6 @@
-## NEXT
+## 2.2.0
 
+* Adds the `uniformTypeIdentifiers` property to the `XTypeGroup` that relies on `macUTIs`. The last will be deprecated for future releases.
 * Updates minimum Flutter version to 2.10.
 
 ## 2.1.0

packages/file_selector/file_selector_platform_interface/lib/src/types/x_type_group/x_type_group.dart

@@ -12,9 +12,13 @@ class XTypeGroup {
     this.label,
     List<String>? extensions,
     this.mimeTypes,
-    this.macUTIs,
+    List<String>? macUTIs,
+    List<String>? uniformTypeIdentifiers,
     this.webWildCards,
-  }) : extensions = _removeLeadingDots(extensions);
+  })  : extensions = _removeLeadingDots(extensions),
+        assert(uniformTypeIdentifiers == null || macUTIs == null,
+            'It is only allowed to specify either macUTIs or uniformTypeIdentifiers'),
+        uniformTypeIdentifiers = uniformTypeIdentifiers ?? macUTIs;
 
   /// The 'name' or reference to this group of types
   final String? label;
@@ -25,8 +29,8 @@ class XTypeGroup {
   /// The MIME types for this group
   final List<String>? mimeTypes;
 
-  /// The UTIs for this group
-  final List<String>? macUTIs;
+  /// The uniform type identifiers for this group
+  final List<String>? uniformTypeIdentifiers;
 
   /// The web wild cards for this group (ex: image/*, video/*)
   final List<String>? webWildCards;
@@ -50,6 +54,9 @@ class XTypeGroup {
         (webWildCards?.isEmpty ?? true);
   }
 
+  /// Returns the list of uniform type identifiers for this group
+  List<String>? get macUTIs => uniformTypeIdentifiers;
+
   static List<String>? _removeLeadingDots(List<String>? exts) => exts
       ?.map((String ext) => ext.startsWith('.') ? ext.substring(1) : ext)
       .toList();

packages/file_selector/file_selector_platform_interface/pubspec.yaml

@@ -4,7 +4,7 @@ repository: https://github.com/flutter/plugins/tree/main/packages/file_selector/
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+file_selector%22
 # NOTE: We strongly prefer non-breaking changes, even at the expense of a
 # less-clean API. See https://flutter.dev/go/platform-interface-breaking-changes
-version: 2.1.0
+version: 2.2.0
 
 environment:
   sdk: ">=2.12.0 <3.0.0"

packages/file_selector/file_selector_platform_interface/test/x_type_group_test.dart

@@ -8,12 +8,11 @@ import 'package:flutter_test/flutter_test.dart';
 void main() {
   group('XTypeGroup', () {
     test('toJSON() creates correct map', () {
-      const String label = 'test group';
       final List<String> extensions = <String>['txt', 'jpg'];
       final List<String> mimeTypes = <String>['text/plain'];
       final List<String> macUTIs = <String>['public.plain-text'];
       final List<String> webWildCards = <String>['image/*'];
-
+      const String label = 'test group';
       final XTypeGroup group = XTypeGroup(
         label: label,
         extensions: extensions,
@@ -71,6 +70,67 @@ void main() {
       expect(webOnly.allowsAny, false);
     });
 
+    test('passing only macUTIs should fill uniformTypeIdentifiers', () {
+      final List<String> macUTIs = <String>['public.plain-text'];
+      final XTypeGroup group = XTypeGroup(
+        macUTIs: macUTIs,
+      );
+
+      expect(group.uniformTypeIdentifiers, macUTIs);
+    });
+
+    test('passing only macUTIs should fill macUTIs', () {
+      final List<String> macUTIs = <String>['public.plain-text'];
+      final XTypeGroup group = XTypeGroup(
+        macUTIs: macUTIs,
+      );
+
+      expect(group.macUTIs, macUTIs);
+    });
+
+    test(
+        'passing only uniformTypeIdentifiers should fill uniformTypeIdentifiers',
+        () {
+      final List<String> uniformTypeIdentifiers = <String>['public.plain-text'];
+      final XTypeGroup group = XTypeGroup(
+        uniformTypeIdentifiers: uniformTypeIdentifiers,
+      );
+
+      expect(group.uniformTypeIdentifiers, uniformTypeIdentifiers);
+    });
+
+    test('passing only uniformTypeIdentifiers should fill macUTIs', () {
+      final List<String> uniformTypeIdentifiers = <String>['public.plain-text'];
+      final XTypeGroup group = XTypeGroup(
+        uniformTypeIdentifiers: uniformTypeIdentifiers,
+      );
+
+      expect(group.macUTIs, uniformTypeIdentifiers);
+    });
+
+    test('passing uniformTypeIdentifiers and macUTIs should throw', () {
+      final List<String> macUTIs = <String>['public.plain-text'];
+      final List<String> uniformTypeIndentifiers = <String>[
+        'public.plain-images'
+      ];
+      expect(
+          () => XTypeGroup(
+              macUTIs: macUTIs,
+              uniformTypeIdentifiers: uniformTypeIndentifiers),
+          throwsA(predicate((Object? e) =>
+              e is AssertionError &&
+              e.message ==
+                  'It is only allowed to specify either macUTIs or uniformTypeIdentifiers')));
+    });
+
+    test(
+        'having uniformTypeIdentifiers and macUTIs as null should leave uniformTypeIdentifiers as null',
+        () {
+      final XTypeGroup group = XTypeGroup();
+
+      expect(group.uniformTypeIdentifiers, null);
+    });
+
     test('Leading dots are removed from extensions', () {
       final List<String> extensions = <String>['.txt', '.jpg'];
       final XTypeGroup group = XTypeGroup(extensions: extensions);