--- title: Configuring an unmanaged Background Assets project framework: backgroundassets role: article role_heading: Article path: backgroundassets/configuring-an-unmanaged-background-assets-project --- # Configuring an unmanaged Background Assets project Manage and download individual assets yourself by configuring your app and extension targets. ## Overview Overview To opt out of Managed Background Assets, add a Self-Hosted, Unmanaged extension target to your project, configure the App Groups capability for both the app and extension target, and add some Background Asset keys to the app’s information property list. Then the system notifies your extension when system events occur so that your extension can initiate downloads. note: For information about Apple-Hosted Background Assets, see Downloading Apple-hosted asset packs. The system launches the extension during the first install and subsequent updates, before a person launches the app, and periodically in the background when the app isn’t running. The sequence of events is: A person installs or updates your app on the device. The system prevents the app from launching and begins downloading your manifest file using the URL you provide. During the manifest download, the system reports progress to the App Store. When the download completes, the system launches your app extension, sending it a content request with the location of the manifest file on disk. The extension uses the manifest file, which should contains the asset URLs and file sizes, to return a set of download requests to the system. The system pauses, or terminates, the extension and begins the downloads. When the downloads complete, the system notifies the extension and allows the app to launch. The flow for periodic content requests is identical to the app install and updates, except the system determines when periodic events occur, depending on a person’s usage and their system settings. For example, the system factors in whether a person enables the Low Power Mode and Background App Refresh settings. note: It’s your responsibility to create manifest files for your self-hosted, unmanaged assets (using your format of choice) that your code parses to get the URLs and file sizes to the system. Add a Self-Hosted, Unmanaged extension to your project Choose New > Target, select the Background Download template under Application Extension, and click Next. In the dialog, enter a product name, choose Self-Hosted, Unmanaged as the extension type, and click Finish. In the next dialog, click Activate to use the extension scheme Xcode creates. If you don’t have an Xcode project for your app, first create one from an Application template under the platform you support, such as iOS or macOS. For more information, see Creating an Xcode project for an app. Add the App Groups capability Add your app and extension targets to the same app group so that they can communicate and share data. Add the App Groups capability to both your app and extension target. For macOS apps, also add the App Sandbox capability to both targets. For more information, see Adding capabilities to your app. Then, add both targets to the same app group. In the project editor, select the app target, and then add a unique ID for the group under App Groups on the Signing & Capabilities pane. Xcode automatically selects the new group ID. Select the extension target, then go to App Groups, click Refresh, and select the same group ID. The app and extension are now in the same app group and can share the asset files. For more information on configuring app groups, and additional steps for macOS apps, see Configuring app groups. Add required information property list keys Configure Background Assets for your app target by setting information property list keys. In the project editor, select the app target and click the Info tab. Then, add the following keys to the information property list file: For more examples of these information property list keys, see the Downloading essential assets in the background sample code project. For more information on editing the information property list file, see Managing your app’s information property list values. ## See Also ### Unmanaged asset downloads - [Downloading essential assets in the background](backgroundassets/downloading-essential-assets-in-the-background.md) - [BAManifestURL](bundleresources/information-property-list/bamanifesturl.md) - [BAInitialDownloadRestrictions](bundleresources/information-property-list/bainitialdownloadrestrictions.md) - [BAEssentialMaxInstallSize](bundleresources/information-property-list/baessentialmaxinstallsize.md) - [BAMaxInstallSize](bundleresources/information-property-list/bamaxinstallsize.md) - [BADownloadManager](backgroundassets/badownloadmanager.md) - [BADownloaderExtension](backgroundassets/badownloaderextension-qwaw.md) - [BADownloaderExtensionConfiguration](backgroundassets/badownloaderextensionconfiguration.md) - [BAURLDownload](backgroundassets/baurldownload.md) - [BADownload](backgroundassets/badownload.md)