feat(get-medias/sort): add option to customize sort on getMedias

ios/Plugin.xcodeproj/project.pbxproj

@@ -267,11 +267,13 @@
 				"${PODS_ROOT}/Target Support Files/Pods-PluginTests/Pods-PluginTests-frameworks.sh",
 				"${BUILT_PRODUCTS_DIR}/Capacitor/Capacitor.framework",
 				"${BUILT_PRODUCTS_DIR}/CapacitorCordova/Cordova.framework",
+				"${BUILT_PRODUCTS_DIR}/SDWebImage/SDWebImage.framework",
 			);
 			name = "[CP] Embed Pods Frameworks";
 			outputPaths = (
 				"${TARGET_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}/Capacitor.framework",
 				"${TARGET_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}/Cordova.framework",
+				"${TARGET_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}/SDWebImage.framework",
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 			shellPath = /bin/sh;

ios/Plugin/MediaPlugin.swift

@@ -286,7 +286,39 @@ public class MediaPlugin: CAPPlugin {
 
         let options = PHFetchOptions()
         options.fetchLimit = quantity
-        options.sortDescriptors = [NSSortDescriptor(key: "creationDate", ascending: true)]
+
+        // Set sort
+        var sortDescriptors = [] as [NSSortDescriptor];
+
+        // Handle when sort is string
+        if call.getString("sort") != nil {
+            print("sort is string");
+            let key = call.getString("sort") ?? "creationDate"
+            sortDescriptors.append(NSSortDescriptor(key: key, ascending: false))
+        }
+        // Handle when sort is an array
+        else if let sortArray = call.getArray("sort") as? [[String: Any]] {
+            print("sort is array");
+            for object in sortArray {
+
+                // Should have at least key for array value
+                if let key = object["key"] as? String {
+                    print("sort is array: has good key");
+                    let ascending = object["ascending"] as? Bool ?? false
+                    sortDescriptors.append(NSSortDescriptor(key: key, ascending: ascending))
+                }
+            }
+        }
+
+        // Check if sort descriptors is empty
+        // it can happen because of validations inside the previous if, in this case, set a default value
+        if sortDescriptors.isEmpty {
+            print("sort descriptors is empty");
+            sortDescriptors.append(NSSortDescriptor(key: "creationDate", ascending: false))
+        }
+
+        // Set sort descriptors
+        options.sortDescriptors = sortDescriptors
 
         if albumId != nil {
             let albumFetchResult = PHAssetCollection.fetchAssetCollections(withLocalIdentifiers: [albumId!], options: nil)

src/definitions.ts

@@ -37,6 +37,25 @@ export interface MediaFetchOptions {
    * Which album identifier to query in (get identifier with getAlbums())
    */
   albumIdentifier?: string;
+  /**
+   * Sort order of returned assets by field and ascending/descending
+   */
+  sort?: string | MediaSort[];
+}
+
+export interface MediaSort {
+  key:
+    | 'meidaType'
+    | 'mediaSubtypes'
+    | 'sourceType'
+    | 'pixelWidth'
+    | 'pixelHeight'
+    | 'creationDate'
+    | 'modificationDate'
+    | 'duration'
+    | 'isFavorite'
+    | 'hasAdjustments';
+  ascending: boolean;
 }
 
 export interface MediaResponse {