backgroundassets-debug(1) General Commands Manual backgroundassets-debug(1)

backgroundassets-debug — A tool used to simulate content requests in a Background Download Extension. Most Background Assets extension entry-points fire based on App Store installation, update, or system events.

backgroundassets-debug [-hlsdb] [---app-bundle-id com.example.app] [---device-id, --d 00000000-0000000000000000] [---simulate --app-install --app-update --app-periodic-check]

backgroundassets-debug With the Background Assets framework, you can improve the experience of your app or game by reducing or eliminating the time people have to wait while your app downloads any required assets at first launch. For example, a game might use the Background Assets framework to download additional content immediately after installation, such as level packs, 3D character models, and textures. Add a Background Assets extension to your app’s target, and let the system notify that extension about an app installation or subsequent update. Then use the download manager to schedule background downloads of required content from your servers or content delivery network (CDN), and have those downloads finish even when the app isn’t running. Check for updated content when the system periodically launches the extension (dependent on app usage) and, when content is available, schedule it for immediate download. The framework leverages ExtensionKit and common types such as URLRequest.

This tool permits the ability to trigger a background download extension's entry points for a given application running on an attached iOS device. The extension will launch and invokes the BADownloaderExtension content request method for --app-install, --app-update, --app-periodic-check.

In production, the App Store gives the user the ability to disable Background Assets when the app hasn't been launched. Simulating an extension entry-point with backgroundassets-debug will automatically grant the extension the ability to launch without the app running. backgroundassets-debug will also permit downloads over cellular to occur.

Prints useful information and options for the backgroundassets-debug tool.
Lists the connected devices paired with the Mac for development.
--app-install --app-update --app-periodic-check
Launches the background download extension for the containing app and performs the simulation events specified.
com.example.app
The application's bundle identifier that contains a background download extension. Do not pass the identifier of the extension, only pass the app's identifier.
<00000000-0000000000000000>
A chosen device's unique identifier to perform actions against. This identifier can be obtained through the --list-devices command.
June 10, 2022 macOS