Technologies›App Extensions & System Integration

SystemExtensions

iOSmacOStvOSwatchOSvisionOS

SystemExtensions lets you request the activation, deactivation, and management of OS system extensions such as drivers and network extensions. You build an OSSystemExtensionRequest for activation or deactivation, submit it through OSSystemExtensionManager, and respond to its progress and result through an OSSystemExtensionRequestDelegate. To inspect installed extensions, use OSSystemExtensionProperties and OSSystemExtensionInfo, and observe changes to the set of active extensions with OSSystemExtensionsWorkspace and its OSSystemExtensionsWorkspaceObserver; failures are reported as OSSystemExtensionError.

Submitting Requests 3

Build and submit requests to activate or deactivate system extensions, and respond to their progress and results.

  • Cl
    OSSystemExtensionManagermacOS 10.15+
    An object that submits requests to activate, deactivate, and manage OS system extensions.
  • Cl
    OSSystemExtensionRequestmacOS 10.15+
    An object that describes a request to activate or deactivate a system extension.
  • Pr
    OSSystemExtensionRequestDelegatemacOS 10.15+
    A protocol for responding to the progress and outcome of a system extension request.

Inspecting Installed Extensions 2

Examine the properties and metadata of system extensions installed on the host.

  • Cl
    OSSystemExtensionPropertiesmacOS 10.15+
    An object that describes the properties of a system extension, such as its identifier and version.
  • Cl
    OSSystemExtensionInfomacOS 15.1+
    An object that provides metadata about an installed system extension.

Observing the Extensions Workspace 2

Track changes to the set of active system extensions over time.

  • Cl
    OSSystemExtensionsWorkspacemacOS 15.1+
    @note Using the workspace API requires the system extension entitlement
  • Pr
    OSSystemExtensionsWorkspaceObservermacOS 15.1+
    A protocol for receiving notifications when the set of active system extensions changes.

Handling Errors 1

Diagnose failures that occur while activating, deactivating, or managing system extensions.

  • St
    OSSystemExtensionErrormacOS 10.15+
    A structure that describes errors encountered while activating, deactivating, or managing a system extension.
← App Extensions & System Integration