BackgroundAssets · IOS API REFERENCE

ManagedDownloaderExtension

protocol · iOS 26.0+ · SDK 27.1

protocol ManagedDownloaderExtension : BADownloaderExtension where Self.Configuration : ManagedDownloaderExtensionConfiguration

An app extension that uses the system implementation to schedule asset-pack downloads automatically. The protocol provides default implementations for all of the inherited ``BADownloaderExtension`` requirements. - Warning: Don’t implement any of the inherited ``BADownloaderExtension`` requirements aside from, optionally, ``BADownloaderExtension/backgroundDownload(_:didReceive:)``.

Members (6)

get · iOS 26.0+

configuration

Swift declaration

var configuration: some ManagedDownloaderExtensionConfiguration { get }

method · iOS 26.0+

shouldDownload

Swift declaration

func shouldDownload(_ assetPack: AssetPack) -> Bool

Determines whether a particular asset pack should be downloaded. This default implementation always returns `true`. You can override it to specify your own filtering logic. - Parameter assetPack: An asset pack that’s being considered as a candidate to be downloaded. - Returns: Whether the asset pack should be downloaded.

method · iOS 26.0+

backgroundDownload

Swift declaration

func backgroundDownload(_ download: BADownload, didReceive challenge: URLAuthenticationChallenge) async -> (URLSession.AuthChallengeDisposition, URLCredential?)

Handles an authentication challenge. If your app doesn’t use Apple hosting, then you can override this default implementation to provide your own handling for authentication challenges from your server. - Parameters: - download: The download for which the server presented the authentication challenge. - challenge: The authentication challenge. - Returns: The disposition with which to respond to the authentication challenge and the credential, if any, to use while doing so.

method · iOS 26.0+

backgroundDownload

Swift declaration

func backgroundDownload(_ failedDownload: BADownload, failedWithError error: any Error)

Handles a failed download. - Warning: Don’t override this default implementation. - Parameters: - failedDownload: The failed download. - error: The error.

method · iOS 26.0+

backgroundDownload

Swift declaration

func backgroundDownload(_ finishedDownload: BADownload, finishedWithFileURL fileURL: URL)

Handles a finished download - Warning: Don’t override this default implementation. - Parameters: - finishedDownload: The finished download. - fileURL: The file URL at which the downloaded asset pack was saved.

method · iOS 26.0+

downloads

Swift declaration

func downloads(for request: BAContentRequest, manifestURL: URL, extensionInfo: BAAppExtensionInfo) -> Set<BADownload>

Returns asset-pack downloads to schedule. - Warning: Don’t override this default implementation. - Parameters: - request: The content request. - manifestURL: A file URL to the manifest of asset packs that are available to download. - extensionInfo: Information about the downloader extension. - Returns: The downloads to schedule.

Skipped declarations

No declarations were skipped in this snapshot.

All BackgroundAssets types →