# `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.

## 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&lt;string&gt; | no | `[]` | Files and directory roots processed into the bundle |
| `prebuild_actions` | list&lt;string&gt; | no | `[]` | Ordered serialized scripts run before resource processing |
| `prepackage_actions` | list&lt;string&gt; | no | `[]` | Ordered serialized resource generators run before packaging |
| `postbuild_actions` | list&lt;string&gt; | no | `[]` | Ordered serialized scripts run after resource assembly; untracked scripts bypass caching |
| `structured_resources` | list&lt;string&gt; | 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"]
```

`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.

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"]