`apple_resource_bundle`

Apple resource bundle.

Description#

Processes resources into a named .bundle directory and propagates the bundle through Apple dependency edges to the final application. Localized resources, interface files, asset catalogs, and managed object models use the same resource processing pipeline as application and framework resources.

Processed asset catalogs are compiled together into Assets.car, rather than copied as raw catalog files. Empty catalogs do not produce a compiled output. Structured resource directories are copied intact without processing their contents, preserving explicit Swift Package Manager copy rules.

Attributes#

Attribute	Type	Required	Default	Description
`platform`	string	yes		Apple platform such as `ios`, `macos`, `tvos`, `watchos`, or `visionos`
`minimum_os`	string	no	`13.0`	Minimum supported operating system version
`sdk_variant`	string	no	`simulator`	`simulator` or `device`; ignored on macOS
`bundle_name`	string	no	target name	Bundle name. The `.bundle` suffix is added when omitted
`bundle_id`	string	no	`dev.once.<bundle_name>.resources`	Bundle identifier written to generated metadata
`resources`	list<string>	no	`[]`	Files and directory roots processed into the bundle
`prebuild_actions`	list<string>	no	`[]`	Ordered serialized scripts run before resource processing
`prepackage_actions`	list<string>	no	`[]`	Ordered serialized resource generators run before packaging
`postbuild_actions`	list<string>	no	`[]`	Ordered serialized scripts run after resource assembly; untracked scripts bypass caching
`structured_resources`	list<string>	no	`[]`	Directory roots whose own basename is preserved inside the bundle
`xcode_developer_dir`	string	no	active Xcode	Xcode developer directory used to resolve resource tools

Dependency Edges#

Edge	Accepts	Description
`deps`	`apple_resource`	Resource bundles propagated alongside this bundle

Providers#

The target emits apple_resource. Its provider contains a deterministic list of bundle paths and files that downstream applications embed and sign.

Capabilities#

Capability	Output groups
`build`	`default`, `bundle`

Outputs#

Output	Location
Resource bundle	`.once/out/<target>/<bundle_name>.bundle`
Property list	`.once/out/<target>/<bundle_name>.bundle/Info.plist`

Example#

toml

[[target]]
name = "AppResources"
kind = "apple_resource_bundle"

[target.attrs]
platform = "ios"
resources = ["Resources/**"]
structured_resources = ["Resources/Fixtures"]