ServicesBackgroundTasks

The declaration to configure background tasks.

Declaration

object ServicesBackgroundTasks

Properties

Name	Type	Description
`ExecutableAssetReference`	string	Specifies the identifier of an asset declaration containing a reference to the files to be used for the background task configuration. The corresponding asset must be of type `com.apple.asset.data`. The referenced data must be a zip archive of an entire directory, that will be expanded and stored in a well known location for the background task. The asset’s “ContentType” and “Hash-SHA-256” keys in the “Reference” key are required. This file should contain background task executables, scripts, and configuration files, but not the `launchd` configuration files.
`LaunchdConfigurations`	[`ServicesBackgroundTasksLaunchdItemObject`]	An array of `launchd` configuration files used to run the background tasks.
`TaskDescription`	string	A description of the set of background tasks managed by this configuration.
`TaskType` Required	string	The unique identifier of the set of background tasks managed with this configuration. This should be a reverse DNS style identifier. The system uses this identifier to differentiate between tasks in different configurations.

Discussion

Specify com.apple.configuration.services.background-tasks as the declaration type.

One or both of ExecutableAssetReference or LaunchdConfigurations needs to be present.

If ExecutableAssetReference is present, the POSIX permissions of the files in the zip archive need to be set correctly. For example, executables must have the “x” bit set.

If LaunchdConfigurations is present, the device stores the launchd configuration files in a secure location and loads them into launchd. When the device updates a launchd configuration, it kills and restarts any associated running tasks.

If both ExecutableAssetReference and LaunchdConfigurations are present, and the device changes just the executable data, it kills and restarts any running tasks associated with the launchd configurations.

Configuration availability


Allowed in supervised enrollment	macOS
Allowed in device enrollment	NA
Allowed in user enrollment	NA
Allowed in local enrollment	NA
Allowed in system scope	macOS
Allowed in user scope	NA

Configuration example

{
    "Type": "com.apple.configuration.services.background-tasks",
    "Identifier": "EB13EE2B-5D63-4EBA-810F-5B81D07F5017",
    "ServerToken": "E180CA9A-F089-4FA3-BBDF-94CC159C4AE8",
    "Payload": {
        "TaskType": "com.example.bgtask",
        "TaskDescription": "Test script",
        "ExecutableAssetReference": "5840A1CB-A769-4C08-8968-13E8BA705B3E",
        "LaunchdConfigurations": [
            {
                "FileAssetReference": "F6A59159-FFA5-4DA9-B2E8-316AC4C99C78",
                "Context": "daemon"
            }
        ]
    }
}

Topics

Objects

ServicesBackgroundTasksLaunchdItemObject