feat(FirebaseStorageUI): add FirebaseStorageUISwift SPM product for Swift-typed API

FirebaseStorageUI/Sources/FUIStorageImageLoader.m

@@ -126,33 +126,31 @@ - (BOOL)canRequestImageForURL:(NSURL *)url {
   }];
   // Observe the progress changes
   [download observeStatus:FIRStorageTaskStatusProgress handler:^(FIRStorageTaskSnapshot * _Nonnull snapshot) {
-    // Check progressive decoding if need
+    // Progressive decoding requires access to partial data via the internal GTMSessionFetcher,
+    // which was removed in Firebase Storage 9.0.0. Guard to prevent crash; progressive rendering
+    // is silently skipped on Firebase 9+.
     if (options & SDWebImageProgressiveLoad) {
       FIRStorageDownloadTask *task = (FIRStorageDownloadTask *)snapshot.task;
-      // Currently, FIRStorageDownloadTask does not have the API to grab partial data
-      // But since FirebaseUI and Firebase are seamless component, we access the internal fetcher here
-      GTMSessionFetcher *fetcher = task.fetcher;
-      // Get the partial image data
-      NSData *partialData = [fetcher.downloadedData copy];
-      // Get response
-      int64_t expectedSize = fetcher.response.expectedContentLength;
-      expectedSize = expectedSize > 0 ? expectedSize : 0;
-      int64_t receivedSize = fetcher.downloadedLength;
-      if (expectedSize != 0) {
-        // Get the finish status
-        BOOL finished = receivedSize >= expectedSize;
-        // This progress block may be called on main queue or global queue (depends configuration), always dispatched on coder queue
-        if (coderQueue.operationCount == 0) {
-          [coderQueue addOperationWithBlock:^{
-            UIImage *image = SDImageLoaderDecodeProgressiveImageData(partialData, url, finished, task, options, context);
-            if (image) {
-              dispatch_main_async_safe(^{
-                if (completedBlock) {
-                  completedBlock(image, partialData, nil, NO);
-                }
-              });
-            }
-          }];
+      if ([task respondsToSelector:@selector(fetcher)]) {
+        GTMSessionFetcher *fetcher = [task performSelector:@selector(fetcher)];
+        NSData *partialData = [fetcher.downloadedData copy];
+        int64_t expectedSize = fetcher.response.expectedContentLength;
+        expectedSize = expectedSize > 0 ? expectedSize : 0;
+        int64_t receivedSize = fetcher.downloadedLength;
+        if (expectedSize != 0) {
+          BOOL finished = receivedSize >= expectedSize;
+          if (coderQueue.operationCount == 0) {
+            [coderQueue addOperationWithBlock:^{
+              UIImage *image = SDImageLoaderDecodeProgressiveImageData(partialData, url, finished, task, options, context);
+              if (image) {
+                dispatch_main_async_safe(^{
+                  if (completedBlock) {
+                    completedBlock(image, partialData, nil, NO);
+                  }
+                });
+              }
+            }];
+          }
         }
       }
     }

FirebaseStorageUI/SwiftBridge/FirebaseStorageUISwift.swift

@@ -0,0 +1,68 @@
+import UIKit
+import SDWebImage
+import FirebaseStorage
+
+@_exported import FirebaseStorageUI
+
+extension UIImageView {
+
+  public func sd_setImageWithStorageReference(
+    _ storageRef: StorageReference,
+    maxImageSize size: UInt64? = nil,
+    placeholderImage placeholder: UIImage? = nil,
+    options: SDWebImageOptions = [],
+    context: [SDWebImageContextOption: Any]? = nil,
+    completion: ((UIImage?, Error?, SDImageCacheType, StorageReference) -> Void)? = nil
+  ) {
+    sd_setImageWithStorageReference(
+      storageRef,
+      maxImageSize: size,
+      placeholderImage: placeholder,
+      options: options,
+      context: context,
+      progress: nil,
+      completion: completion
+    )
+  }
+
+  public func sd_setImageWithStorageReference(
+    _ storageRef: StorageReference,
+    maxImageSize size: UInt64? = nil,
+    placeholderImage placeholder: UIImage? = nil,
+    options: SDWebImageOptions = [],
+    context: [SDWebImageContextOption: Any]? = nil,
+    progress progressBlock: ((Int, Int, StorageReference) -> Void)?,
+    completion: ((UIImage?, Error?, SDImageCacheType, StorageReference) -> Void)? = nil
+  ) {
+    guard let url = Self.storageURL(for: storageRef) else { return }
+
+    var ctx = context ?? [:]
+    ctx[.imageLoader] = StorageImageLoader.shared
+    ctx[.fuiStorageMaxImageSize] = size ?? StorageImageLoader.shared.defaultMaxImageSize
+
+    let sdProgress: SDImageLoaderProgressBlock? = progressBlock.map { block in
+      { received, expected, _ in block(Int(received), Int(expected), storageRef) }
+    }
+    let sdCompletion: SDExternalCompletionBlock? = completion.map { block in
+      { image, error, cacheType, _ in block(image, error, cacheType, storageRef) }
+    }
+
+    sd_setImage(
+      with: url,
+      placeholderImage: placeholder,
+      options: options,
+      context: ctx,
+      progress: sdProgress,
+      completed: sdCompletion
+    )
+  }
+
+  private static func storageURL(for storageRef: StorageReference) -> URL? {
+    guard !storageRef.bucket.isEmpty else { return nil }
+    var components = URLComponents()
+    components.scheme = "gs"
+    components.host = storageRef.bucket
+    components.path = "/" + storageRef.fullPath
+    return components.url
+  }
+}

Package.swift

@@ -34,6 +34,10 @@ let package = Package(
       name: "FirebaseStorageUI",
       targets: ["FirebaseStorageUI"]
     ),
+    .library(
+      name: "FirebaseStorageUISwift",
+      targets: ["FirebaseStorageUISwift"]
+    ),
     .library(
       name: "FirebaseAuthSwiftUI",
       targets: ["FirebaseAuthSwiftUI"]
@@ -126,6 +130,15 @@ let package = Package(
         .headerSearchPath("../../"),
       ]
     ),
+    .target(
+      name: "FirebaseStorageUISwift",
+      dependencies: [
+        "FirebaseStorageUI",
+        .product(name: "FirebaseStorage", package: "firebase-ios-sdk"),
+        .product(name: "SDWebImage", package: "SDWebImage"),
+      ],
+      path: "FirebaseStorageUI/SwiftBridge"
+    ),
     .target(
       name: "FirebaseAuthUIComponents",
       dependencies: [],