background_downloader

• Fix task updates stream suppression when task tracking or transfers is enabled: isolate internal Transfers callbacks from user-registered callbacks using dedicated groupTransfer callback maps in BaseDownloader, preventing internal callbacks from suppressing events on FileDownloader().updates, and preserving callback reference equality in registerCallbacks/unregisterCallbacks (fixes #727)
• [Android] Fix Kotlin compiler warnings: align serializer visibility with public enums in Models.kt, remove unnecessary safe calls in UIDTJobService.kt, and streamline UriUtils.kt

• Expand connectivity_plus version constraint to >=6.1.3 <8.0.0 to support connectivity_plus 7.x (fixes #722)
• [iOS] Native task status and progress closures on BDPlugin: add optional static closures BDPlugin.onNativeTaskStatusChange and BDPlugin.onNativeTaskProgressChange to allow native iOS host apps to observe task status and throttled progress directly in Swift (e.g. for Live Activities and WidgetKit) when the Dart isolate is suspended during background URLSession wake-ups (closes #702, refs #705)
• [iOS] Partial upload slicing optimization: use FileHandle.seek(toOffset:) instead of reading and discarding leading bytes in createTempFileWithRange, eliminating quadratic disk reads when slicing chunked uploads (#723)
• [Android] Enforce Wi-Fi constraint via NetworkRequest on Android API 28+: require TRANSPORT_WIFI and NET_CAPABILITY_INTERNET for tasks requiring Wi-Fi, preventing downloads over cellular even when reported as unmetered by the carrier, with fallback to NETWORK_TYPE_UNMETERED on older Android versions (fixes #717)
• [Android] Fix Android R8 build error in CI and update minimum Flutter SDK in CI (#725)
• [Documentation] Clarify requiresWiFi behavior on Android API 28+ vs earlier Android versions

Add test/mtls_test.dart to the false_secrets allowlist in pubspec.yaml
to prevent package publish validation from flagging the dummy mTLS test
private key as a leaked secret.

• Bump package version to 9.5.9 in pubspec.yaml
• Add 9.5.9 release notes documenting mTLS desktop support, Config.tempFilePath, expedited timeout reduction, Android and iOS stability fixes, desktop temp file cleanup, and documentation updates

Merge pull request #697 from 781flyingdutchman/issue-695-require-wifi…

• [Android] Bug fixes:
  • Fixes group notification sticking in running state when cancelling tasks from holding queue
  • Fixes ConcurrentModificationException in canSendCancellation when processing concurrent status updates
• [iOS] Bug fixes:
  • Fixes group notification sticking in running state when cancelling tasks from holding queue
  • Serializes access to group notification registry to prevent EXC_BAD_ACCESS race condition under concurrent status updates
• [General] Defer JsonProcessor idle shutdown while requests are pending to prevent unexpected background isolate shutdown errors

• [Android] Bug fixes and build improvements:
  • Fixes Application Not Responding (ANR) crash when canceling binary uploads via notification action (fixes #664)
  • Corrects ETag validation logic and saves the correct server ETag during a timeout-pause (fixes #683)
  • Adds fallback to legacy kotlin-android plugin in Gradle build if builtInKotlin is configured to false (closes #674)
• [iOS] Swift Package Manager (SPM) and build fixes:
  • Resolves package dependency resolution errors when using SPM by removing invalid FlutterFramework dependency path in Package.swift
  • Restores compatibility with older Flutter SDKs in the example app's AppDelegate.swift
• [Chore / Maintenance] Updated GitHub Actions workflow configurations to resolve Node 20 deprecation warnings

• [Android] Bug fixes and performance improvements:
  • Fixes a potential UI freeze during application startup
  • Prevents App Not Responding (ANR) crashes when tapping notification actions (Cancel/Pause/Resume) under heavy system load
  • Fixes group notifications running in the foreground (issue #648)
  • Migrated build configuration to Flutter's built-in Kotlin Gradle plugin configuration and upgraded Gradle to 8.14
• [iOS] Group notification and permission improvements:
  • Fixes redundant updates and visual "flashing" of group notifications (fixes #656)
  • Migrated the example app to native Swift Package Manager (SPM) and added environment-variable-based compile-time permission bypass flags for SPM users
  • Removed 'Background Fetch' requirement from documentation and example plist files, preventing unexpected wake-ups when the device is locked and resolving potential keychain access issues (fixes #668)
• [Desktop] Temp directory fallback:
  • Added fallback to the target download directory on desktop platforms when the system temporary directory is inaccessible (e.g., in macOS app sandbox mode, fixes #649)
• [Chore / Maintenance] Code formatting updated to match the latest Dart formatter

• Add TaskOptions to DataTask with similar functionality as in DownloadTask
• Bug fixes

V9.5.3 Fix race condition in TaskWorker where setForeground could…

V9.5.2 Moves LocalStorePersistentStorage to isolate model to off-load…

• [iOS] Support for UISceneDelegate in iOS 13.0 and above

• Introduces Android User Initiated Data Transfer (UIDT), triggered when task priority is set to 0 (max priority) on Android 14+, provided a notification is also configured. Explanation of Android execution options:
  • WorkManager (default and preferred for most tasks): Used for most tasks. Subject to a 9-minute execution limit in the background. If the task is not finished within 9 minutes, it will be terminated (unless allowPause is true, in which case it will pause and resume).
  • Foreground Service: Triggered via Config.runInForeground. Displays a persistent notification and is not subject to the 9-minute limit on many Android versions. Requires FOREGROUND_SERVICE_DATA_SYNC permission on Android 14+.
  • User Initiated Data Transfer (UIDT): Triggered by setting priority: 0 on Android 14+. This is a specialized JobScheduler mode that does not have the 9-minute limit and is designed for large, user-aware data transfers. It requires a notification to be shown.
    • Note: Using UIDT requires adding the RUN_USER_INITIATED_JOBS permission to your AndroidManifest.xml, as well as a service declaration for .UIDTJobService. See the README for details.
• [Android] Fixes HoldingQueue logic to correctly include UIDT jobs and prevent race conditions
• [Android] Properly captures WorkManager cancellations to ensure task status is updated to failed
• [Android] Improvements for Android 14+ compatibility and Android 15 timeout logging
• [Android] Updated minimum Kotlin compiler version to 2.1.0
• [iOS] Updates to openFile and privacy manifest for iOS 16/17 compatibility
• Replaces sync with async IO in LocalStorePersistentStorage to prevent UI stutter
• [General] Documentation refactor: broken down README into separate files in doc/ directory

• [Android] MinSDK is now 23 (was 21), required because the latest Android WorkManager is required to properly support Android 15+
• [Android] Fixes bug fix related to foreground service in Android 15+
• Performance improvements related to Task.filePath, Task.split and ParallelDownloadTask pause

• Improve JSON processing to reduce UI jank
• Optimize database operations
• Add database.cleanUp() to simplify and automate database maintenance, and added database clean-up to start() command
• Fix iOS background callback performance

• Improve Android notification handling
• Add local test server to reduce test suite flakiness
• Improve code documentation

• Refine TaskQueue pauseAll/resumeAll to support specific tasks and groups. Updated TaskQueue interface to accept optional tasks and group parameters in pauseAll and resumeAll and implemented this for the MemoryTaskQueue
• Change platform checks from Platform.isAndroid etc to defaultTargetPlatform which should lead to better tree shaking and smaller memory size

• Improves concurrency on mobile platforms by moving JSON encoding and decoding to an isolate, and introducing a job queue to ensure ordered message execution.
• Adds Config.skipExistingFiles configuration option to skip the download if the destination file already exists (and conditionally does this only for files greater than a certain size)

Main change is in Android concurrency, triggered by the Great Thread Merge that causes UI blocking issues for recent versions of Flutter. The concurrency approach has been changed, but note this can cause minor changes in - for example - the sequence in which certain events happen.

• Feature improvements

  • Add pause and resume functionality to TaskQueue using pauseAll and resumeAll. These methods are now called when pausing or resuming all tasks using the FileDownloader

• Bug fixes

  • Fix issue with MultiUploadTask when uploading only one file
  • UriUtils subclasses are now private, as they should have been to start with
  • Address Dart analyzer recommendations

• Bug fix

  • [Android] Fix Tap to open (on notification) bug, introduced in 9.2.4

• Version upgrades

  • [Android] compileSDK set to 36, targetSDK for example app set to 36, Kotlin compiler in example app set to 2.1.0

• Minor bug fixes
  • [iOS] catch file write errors in multi-part uploads
  • [iOS] fix optional unwrap error

• Minor bug fixes
  • [iOS] Notification update after killed app resumes
  • [Android] Use of UTF-8 characters in post field
  • Multipart upload remove extraneous CR/LF after header
  • [Android] Fallback for expedited tasks when encountering OS error
  • [Android] fix enqueAll and similar calls when no Activity attached

• Minor bug fixes
  • [Android] Unmarking temp files as cache after move to download destination
  • [iOS] Improved permissions bypassing
  • [Android] Use of $ sign in notification substitutions
  • [iOS] Crash on returning app to foreground when app is suspended

• Adds option to set the Content-Disposition header for binary uploads
• Fixes bug on iOS when using openFile with a filepath containing spaces

For binary uploads, the Content-Disposition header will be:

• set to 'attachment = "filename"' if the task.headers field does not contain an entry for 'Content-Disposition' (the prior default)
• not set at all (i.e. omitted) if the task.headers field contains an entry for 'Content-Disposition' with the value '' (an empty string)
• set to the value of task.headers['Content-Disposition'] in all other cases

• Minor bug fixes

• Adds updates broadcast stream to the database property, which emits every TaskRecord update made to the database.
• Fixes issue with start and rescheduleKilledTasks when using group names for tasks
• Minor bug fixes and enhancements

• Adds optional group parameter to resumeAll
• Fixes concurrency bugs in Android

• Adds pauseAll, cancelAll and resumeAll
• Improves handling enqueuAll to not starve the UI thread
• Fixes compilation bug when compiling with XCode 16.2

• Introduces URI operations, including file/photo/video/directory pickers, under the uri property, and UriDownloadTask and UriUploadTask. See Working with URIs.
• [Breaking] removes references to asAndroidUri - use the new methods on the uri property instead
• Adds enqueueAll to enqueue a list of tasks (non-blocking and with better performance when compared to calling enqueue for each task)
• Adds native callback beforeTaskStartCallback to TaskOptions, that is called just before the task starts executing. If it returns a non-null TaskStatusUpdate then this forces the task to finish before it starts, with that TaskStatusUpdate
• Adds option to configure a canceled notification (instead of cancellation defaulting to the error notification)
• Fixes bug with request when using PUT or PATCH requests
• Fixes bug for multi-part uploads when field values are formatted as a JSON string and contain non-ASCII characters
• Bumps minimum iOS version to 14

Uri operations

Uri operations abstract away platform differences, including content provider on Android (used for the Storage Access Framework), and file, photo and directory pickers on iOS and Android. This enables largely platform-independent code for file operations, and on Android downloads directly to destination, bypassing the temp file in internal storage.

The FileDownloader().uri property provides access to a set of utility functions for working with URIs, including:

• pickDirectory(): Opens a directory picker dialog and returns the selected directory's URI.
• pickFile(): Opens a file picker dialog and returns the selected file's URI.
• pickFiles(): Opens a file picker dialog and allows selection of multiple files, returning their URIs in a list.
• createDirectory(): Creates a new directory within a specified parent directory URI.
• getFileBytes(): Retrieves the file data (bytes) for a given URI.
• copyFile(): copies a file from a source uri to a destination. Destination can be a Uri, a File or a String containing a file path
• moveFile(): moves a file from a source uri to a destination. Destination can be a Uri, a File or a String containing a file path. If the move fails, it is possible that the file was copied but the source was not deleted
• deleteFile(): Deletes the file at the given URI.
• openFile(): Opens the file at a given URI.
• moveToSharedStorage(): Moves a file to a shared storage location.
• activate(): Activates a previously accessed directory or file. Only relevant if you use persistedUriPermission or use the photo/video picker.

The pick... methods and createDirectory take an optional persistedUriPermission argument (defaults to false) that when true registers the picked directory with the OS, allowing access in a later session.

New/modified Task types:

• UriDownloadTask: Downloads a file to a specified directory URI. On Android, this bypasses the temp file used in the traditional approach and downloads directly to the destination.
• UriUploadTask: Uploads a file from a given file URI. If the filename is omitted, it will be based on the task's URL.
• MultiUploadTask: now accepts Uri where previously only filename or file path was allowed

• Fixes issue with start and rescheduleKilledTasks when using group names for tasks

• Modifies the interval between TaskProgressUpdate such that an update is sent at least once every 2.5 seconds if progress has been made, even if it less than 2% of the file size
• Improves rescheduleKilledTasks to also reschedule tasks marked as waitingToRetry but not registered as such

• Adds start which ensures the various start-up calls are executed in the correct order. Use this instead of calling trackTasks, resumeFromBackground and rescheduleKilledTasks separately
• Adds rescheduleKilledTasks which will compare enqueued/running tasks in the database with those active in the downloader, and reschedules those that have been killed by the user
• [iOS] Removes limit on range of partial file uploads using the Range header (was 2GB)

• Adds rescheduleMissingTasks, which compares tasks in the database with tasks in the native downloader, and reschedules those tasks that are present in the database (and therefore should be enqueued or running) but are not present in the native downloader. Returns two lists of Task - successfully rescheduled ones, and tasks that failed to reschedule.
• Upgraded minimum Dart SDK to 3.5.0 / Flutter SDK 3.24.0 to stay in sync with dependency updates
• [Android] Fix bug when uploading files greater than 2GB, that was introduced in V8.9.0

• [iOS] Adds Privacy Manifest
• [iOS] Adds support for Swift Package Manager and defaults the example app to using it

• Adds options field to Task, which take a TaskOptions object to configure less common task specific options - currently onTaskStart, onTaskFinished and auth
  • onTaskStart is a callback with signatureFuture<Task?> Function(Task original), called just before the task starts executing. Your callback receives the original task about to start, and can modify this task if necessary. If you make modifications, you return the modified task - otherwise return null to continue execution with the original task. You can only change the task's url (including query parameters) and headers properties - making changes to any other property may lead to undefined behavior.
  • onTaskFinished is a callback with signature Future<void> Function(TaskStatusUpdate taskStatusUpdate), called when the task has reached a final state (regardless of outcome). Your callback receives the final TaskStatusUpdate and can act on that.
  • auth is an optional Auth object that helps manage accessToken and accessToken refresh - see the README for details
  • NOTE: The callback functionality is experimental for now, and its behavior may change without warning in future updates. Please provide feedback on callbacks
• Upgrades Android Java version to version 17 (modifies build.gradle)
• Fixes concurrency issue on iOS
• Changes how numTotal is calculated for group notifications: numTotal is now increment when a task is enqueued, instead of when it starts running. Note that this can lead to a '0/20 files' type notification if the tasks are enqueued but cannot start due to a constraint such as requiring WiFi
• Expands type of Android URI that can be used to upload a file (was MediaStore URIs only, now accepts any Android URI, e.g. one provided by a document provider such as a file picker)

• Fixes Android bug where timeout timer is not cleaned up after use

• [iOS] Adds configuration option to exclude downloaded files from iCloud backup
• Adds allGroups parameter to allTasks and allTaskIds methods, to retrieve all tasks regardless of group
• [Android] Fixes issue with un-commanded restart of a download in specific scenarios

• Fix for compilation issue on Kotlin 2

• Adds option to specify a file location for upload using a Mediastore URI on Android, using UploadTask.fromUri. A Mediastore URI can also be requested from methods moveToSharedStorage and pathInSharedStorage by adding asAndroidUri = true to the call.
• Fixes bug with ParallelDownload when an error occurs
• Updates dependency on package mime to 2.0, therefore also Dart 3.2 (Flutter 3.16.0) or greater. Use dependency_overrides in pubspec.yaml to resolve (background_downloader works with 1.0 and 2.0)

• Adds option for partial uploads, for binary uploads only. Set the byte range by adding a "Range" header to your binary UploadTask, e.g. a value of "bytes=100-149" will upload 50 bytes starting at byte 100. You can omit the range end (but not the "-") to upload from the indicated start byte to the end of the file. The "Range" header will not be passed on to the server. Note that on iOS an invalid range will cause enqueue to fail, whereas on Android and Desktop the task will fail when attempting to start.
• Fixes issue in iOS when multiple Flutter engines register the plugin
• Fixes issue with lingering HTTP connections on desktop
• Adds CI workflow (formatting, lints, build Android, build iOS)

• Fixes desktop upload cancellation bug
• Adds Url-encoding of Content-Disposition header for binary uploads. Note for multipart uploads, filename is 'browserEncoded' which does not encode Non-ASCII characters
• Fixes bug with creation of unique filename on iOS

• Fixes concurrent database write bug for TaskRecords

• If the value of a fields entry of an UploadTask is in JSON format (defined as start/end with {} or []) then the field's mime-type will be set to application/json, whereas it would not have been set prior
• Fixes an issue on iOS where use of the holding queue can lead to deadlock
• For Windows, when using BaseDirectory.root, fixes an issue with Task.split and Task.baseDirectoryPath. When using BaseDirectory.root on Windows, your task's directory must contain the drive letter.

• Bug fixes
• Improvements to documentation

• Removes references to dart:html to allow web compilation using WASM. Note the package still does not work on the web
• Adds auto-decode of post field if Map or List. Throws if jsonEncode cannot convert the object, in which case you have to encode it yourself using a custom encoder

• Fixes an issue where temporary files were not deleted when canceling a paused parallel download task

• Adds DataTask for scheduled server requests
• Fixes bug omitting Content-Type header for iOS uploads, and Content-Disposition header for desktop uploads

DataTask

The downloader already supported server requests for immediate execution using FileDownloader.request(Request request). This change adds the option to scheduled a server request similar to scheduling any other Task.

To schedule a server request using the background mechanism (e.g. if you want to wait for WiFi to be available), create and enqueue a DataTask. A DataTask is similar to a DownloadTask except it:

• Does not accept file information, as there is no file involved
• Does not allow progress updates
• Accepts post data as a String, or
• Accepts json data, which will be converted to a String and posted as content type application/json
• Accepts contentType which will set the Content-Type header value
• Returns the server responseBody, responseHeaders and possible taskException in the final TaskStatusUpdate fields

Typically you would use enqueue to enqueue a DataTask and monitor the result using a listener or callback, but you can also use transmit to enqueue and wait for the final result of the DataTask.

• Fixes iOS/Android issue where retrieveLocallyStoredData retrieves only a basic TaskStatusUpdate, without responseCode, responseBody etc

• Fixes iOS/Android bug with ParallelDownloadTask hanging when number of chunks exceeds ~10

• Fixes Android bug when using Config.runInForeground that can lead to a crash

• Adds optional holding queue to manage how many tasks are executed concurrently
• Fixes bug with using unique parameter in context of server suggested filename
• Transition from imperative to declarative Gradle plugin application, see here

Holding queue

Once you enqueue a task with the FileDownloader it is added to an internal queue that is managed by the native platform you're running on (e.g. Android). Once enqueued, you have limited control over the execution order, the number of tasks running in parallel, etc, because all that is managed by the platform. If you want more control over the queue, you need to use a TaskQueue or a HoldingQueue:

• A TaskQueue is a Dart object that you can add to the FileDownloader. You can create this object yourself (implementing the TaskQueue interface) or use the bundled MemoryTaskQueue implementation. This queue sits "in front of" the FileDownloader and instead of using the enqueue and download methods directly, you now simply add your tasks to the TaskQueue. Because this is a Dart object, the queue will suspend when the OS suspends your application, and if the app gets killed, tasks held in the TaskQueue will be lost (unless you have implemented persistence)
• A HoldingQueue is native to the OS and can be configured using FileDownloader().configure to limit the number of concurrent tasks that are executed (in total, by host or by group). When using this queue you do not change how you interact with the FileDownloader, but you cannot implement your own holding queue. Because this queue is native, it will continue to run when your app is suspended by the OS, but if the app is killed then tasks held in the holding queue will be lost (unlike tasks already enqueued natively, which persist)

This update adds the holding queue.

Use a holding queue to limit the number of tasks running concurrently. Calling await FileDownloader().configure(globalConfig: (Config.holdingQueue, (3, 2, 1))) activates the holding queue and sets the constraints maxConcurrent to 3, maxConcurrentByHost to 2, and maxConcurrentByGroup to 1. Pass null for no constraint for that parameter.

Using the holding queue adds a queue on the native side where tasks may have to wait before being enqueued with the Android WorkManager or iOS URLSessions. Because the holding queue lives on the native side (not Dart) tasks will continue to get pulled from the holding queue even when the app is suspended by the OS. This is different from the TaskQueue, which lives on the Dart side and suspends when the app is suspended by the OS

When using a holding queue:

• Tasks will be taken out of the queue based on their priority and time of creation, provided they pass the constraints imposed by the maxConcurrent values
• Status messages will differ slightly. You will get the TaskStatus.enqueued update immediately upon enqueuing. Once the task gets enqueued with the Android WorkManager or iOS URLSessions you will not get another "enqueue" update, but if that enqueue fails the task will fail. Once the task starts running you will get TaskStatus.running as usual
• The holding queue and the native queues managed by the Android WorkManager or iOS URLSessions are treated as a single queue for queries like taskForId and cancelTasksWithIds. There is no way to determine whether a task is in the holding queue or already enqueued with the Android WorkManager or iOS URLSessions

• Adds responseStatusCode to TaskStatusUpdate for tasks that result in TaskStatus.complete or TaskStatus.notFound (null otherwise).
• Adds Task.split to extract the baseDirectory, directory and filename from an absolute filePath or a File. This is saver than using .fromFile and preferred
• Adds UploadTask.fromFile to create an UploadTask from an existing File object. Note that this will create a task with an absolute path reference and BaseDirectory.root, which can cause problems on mobile platforms, so use with care
• Fixes bug on Android API 34 when using configuration Config.runInForeground

Extracting baseDirectory, directory and filename from a filePath or File

If you already have a path to a file or a File object, you can extract the values for baseDirectory, directory and filename using Task.split to create the task:

final (baseDirectory, directory, filename) = await Task.split(filePath: yourPath);
final task = UploadTask(
        url: 'https://yourserver.com',
        baseDirectory: baseDirectory,
        directory: directory,
        filename: filename);

Using foreground service on Android targeting API 34

If targeting API 34 or greater, you must add to your AndroidManifest.xml a permission declaration <uses-permission android:name="android.permission.FOREGROUND_SERVICE_DATA_SYNC" /> and the foreground service type definition (under the application element):

<service
  android:name="androidx.work.impl.foreground.SystemForegroundService"
  android:foregroundServiceType="dataSync"
  tools:node="merge" />

• Adds option to specify multiple values for a single field name in the UploadTask.fields property by formatting the value as '"value1", "value2", "value3"' (note the double quotes and the comma to separate the values).

• Adds Future<bool> requireWiFi(RequireWiFi requirement, {final rescheduleRunningTasks = true}) to set a globally enforced WiFi requirement, and pause/resume or cancel/restart tasks accordingly. This is helpful when implementing a global toggle switch to prevent data download over metered (cellular) networks. iOS and Android only

• Adds responseHeaders to TaskStatusUpdate for tasks that complete successfully (null otherwise). Per Dart convention, header names are lower-cased
• Added ext.kotlin_version back to build.gradle

Android minSdk now 21 (was 24) and compileSdk now 34 (was 33)

Kotlin compiler V1.9

Kotlin compiler version moved from 1.8 to 1.9, typically this means changing your project's build.gradle entry:

buildscript {
    ext.kotlin_version = '1.9.0' # changed from '1.8.0'
    repositories {
        google()
        mavenCentral()
    }

Enable multiple application instances on Android

• Changes approach to backgroundChannel and activity fields in Kotlin plugin
• Allows use of android:launchMode="standard" in Android manifest

Improvements and bug fixes

• Notification handling on Android when app is suspended
• Kotlin code refactoring for posting on backgroundChannel
• Web compilation

Bypassing permissions on iOS

By default, the downloader allows any of the permissions to be requested, but that also means that Apple requires you to add things like Photo Library Usage Description to your Info.plist, even if you never move files to the Photo Library.

On iOS, to bypass the permission code altogether at compile time (and therefore remove the need to provide the Info.plist entry) modify your app's Podfile as follows:

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
    
    # The following loop has been added to bypass compilation of specific
    # permissions.
    # If you want to bypass one or more permissions (so that you don't
    # have to include things like a Photo Library Usage Description
    # if you don't add files to the Photo Library) then add this loop
    # and uncomment the permissions you want to bypass.
    # If you bypass (by including the line below) then the
    # check will not happen, and the permission is aways denied. If you
    # bypass you do not need to include the associated entry in your
    # Info.plist file
    target.build_configurations.each do |config|
      config.build_settings['OTHER_SWIFT_FLAGS'] ||= ['$(inherited)']
      #config.build_settings['OTHER_SWIFT_FLAGS'] << '-D BYPASS_PERMISSION_NOTIFICATIONS'
      #config.build_settings['OTHER_SWIFT_FLAGS'] << '-D BYPASS_PERMISSION_IOSADDTOPHOTOLIBRARY'
      #config.build_settings['OTHER_SWIFT_FLAGS'] << '-D BYPASS_PERMISSION_IOSCHANGEPHOTOLIBRARY'
      end
  end
end

and uncomment the line items that you want to bypass by deleting the # mark at the start of the line.