mirror of
https://github.com/apple/device-management.git
synced 2026-07-11 05:23:42 +02:00
Cyrus Daboo
74 lines
2.2 KiB
YAML
74 lines
2.2 KiB
YAML
title: Package
|
|
description: The declaration to configure a package.
|
|
payload:
|
|
declarationtype: com.apple.configuration.package
|
|
supportedOS:
|
|
iOS:
|
|
introduced: n/a
|
|
macOS:
|
|
introduced: '26.0'
|
|
allowed-enrollments:
|
|
- supervised
|
|
allowed-scopes:
|
|
- system
|
|
tvOS:
|
|
introduced: n/a
|
|
visionOS:
|
|
introduced: n/a
|
|
watchOS:
|
|
introduced: n/a
|
|
apply: multiple
|
|
payloadkeys:
|
|
- key: ManifestURL
|
|
title: Manifest URL
|
|
type: <string>
|
|
presence: required
|
|
content: The URL of the manifest document for the package that the device downloads.
|
|
The manifest is returned as a `ManifestURL` property list. The `url` property
|
|
of the manifest must point to the package (.pkg) file to install.
|
|
- key: InstallBehavior
|
|
title: Install behavior
|
|
type: <dictionary>
|
|
presence: optional
|
|
content: A dictionary that describes how and when to install the package.
|
|
subkeys:
|
|
- key: Install
|
|
title: Install
|
|
type: <string>
|
|
presence: optional
|
|
rangelist:
|
|
- Optional
|
|
- Required
|
|
default: Optional
|
|
content: |-
|
|
A string that specifies when the system installs the package:
|
|
|
|
- `Optional`: The user can install the package after the system activates the configuration.
|
|
- `Required`: The system installs the package after it activates the configuration.
|
|
- key: UninstallBehavior
|
|
title: Uninstall behavior
|
|
supportedOS:
|
|
macOS:
|
|
introduced: '27.0'
|
|
type: <dictionary>
|
|
presence: optional
|
|
content: A dictionary that describes how to uninstall the package.
|
|
subkeys:
|
|
- key: Remove
|
|
title: Remove
|
|
type: <boolean>
|
|
presence: optional
|
|
default: false
|
|
content: If `true`, the system removes the files that the package installs when
|
|
removing the configuration.
|
|
notes:
|
|
- title: ''
|
|
content: This declaration installs a package on a device. Packages can contain apps,
|
|
fonts, documents, and other items. Apps that a package installs aren't automatically
|
|
managed; you can manage them using the `AppManaged` declaration.
|
|
examples:
|
|
- title: Configuration example
|
|
files:
|
|
- description: This configuration installs a required package.
|
|
file: examples/declarative/declarations/configurations/package/example1.json
|