pickAndUploadMultipleFiles method

Future<List<TransferTask>> pickAndUploadMultipleFiles(
  1. Uri destination, {
  2. String fieldName = 'file',
  3. String method = 'POST',
  4. List<String>? allowedExtensions,
  5. List<String>? allowedMimeTypes,
  6. UploadSourcePolicy sourcePolicy = UploadSourcePolicy.copyToManagedStorage,
  7. bool showNotification = true,
  8. NotificationOpenType openFromNotification = NotificationOpenType.open,
  9. bool showLiveActivity = false,
  10. LiveActivityStyle liveActivityStyle = LiveActivityStyle.system,
  11. bool allowPauseFromLiveActivity = true,
  12. bool allowCancelFromLiveActivity = true,
  13. TransferNotification? notification,
  14. Map<String, String> headers = const {},
  15. NetworkPolicy? networkPolicy,
  16. RetryPolicy? retryPolicy,
  17. Checksum? checksum,
  18. String? expectedChecksum,
})

Prompts the user to select one or more files using the system file picker and enqueues multipart uploads for all selected files.

Uses UploadSourcePolicy.copyToManagedStorage by default so that staged files survive temporary cache eviction. Returns an empty list if the user cancelled the picker.

Implementation

Future<List<TransferTask>> pickAndUploadMultipleFiles(
  Uri destination, {
  String fieldName = 'file',
  String method = 'POST',
  List<String>? allowedExtensions,
  List<String>? allowedMimeTypes,
  UploadSourcePolicy sourcePolicy = UploadSourcePolicy.copyToManagedStorage,
  bool showNotification = true,
  NotificationOpenType openFromNotification = NotificationOpenType.open,
  bool showLiveActivity = false,
  LiveActivityStyle liveActivityStyle = LiveActivityStyle.system,
  bool allowPauseFromLiveActivity = true,
  bool allowCancelFromLiveActivity = true,
  TransferNotification? notification,
  Map<String, String> headers = const {},
  NetworkPolicy? networkPolicy,
  RetryPolicy? retryPolicy,
  Checksum? checksum,
  String? expectedChecksum,
}) async {
  final pickedFiles = await pickFiles(
    allowedExtensions: allowedExtensions,
    allowedMimeTypes: allowedMimeTypes,
    allowMultiple: true,
  );
  if (pickedFiles.isEmpty) return const [];
  final tasks = <TransferTask>[];
  for (final picked in pickedFiles) {
    final task = await upload(
      destination,
      sourcePath: picked.path,
      fieldName: fieldName,
      method: method,
      sourcePolicy: sourcePolicy,
      showNotification: showNotification,
      openFromNotification: openFromNotification,
      showLiveActivity: showLiveActivity,
      liveActivityStyle: liveActivityStyle,
      allowPauseFromLiveActivity: allowPauseFromLiveActivity,
      allowCancelFromLiveActivity: allowCancelFromLiveActivity,
      notification: notification,
      headers: headers,
      networkPolicy: networkPolicy,
      retryPolicy: retryPolicy,
      checksum: checksum,
      expectedChecksum: expectedChecksum,
    );
    tasks.add(task);
  }
  return tasks;
}