# `android_resource`

Android resource target.

## Description

Compiles Android resources into a static resource package with `aapt2`
and propagates assets to Android package targets. This is the preferred
place to declare shared `res/` and `assets/` trees. Android libraries
and binaries can depend on it through `deps`.

## Attributes

| Attribute | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `manifest` | string | no | `AndroidManifest.xml` | Package-relative Android manifest |
| `resource_files` | list<string> | no | files under `res` | Android resource file glob patterns |
| `resource_dirs` | list<string> | no | `["res"]` | Resource roots passed to `aapt2 compile` |
| `assets` | list<string> | no | `[]` | Android asset file glob patterns |
| `asset_dirs` | list<string> | no | `["assets"]` | Asset roots propagated to Android package targets |
| `assets_dir` | string | no |  | Single package-relative asset root alias |
| `package` | string | no |  | Generated R package fallback |
| `namespace` | string | no |  | Java package for generated R classes |
| `custom_package` | string | no |  | Alias for generated R package |
| `compile_sdk` | int | no | highest installed | Android SDK API level used for android.jar |
| `min_sdk_version` | int | no | `23` | Minimum Android API level |
| `target_sdk_version` | int | no | `compile_sdk` | Target Android API level |
| `build_tools_version` | string | no | highest installed | Android SDK build-tools version |
| `android_sdk` | string | no | env | Android SDK root, otherwise `ANDROID_HOME` or `ANDROID_SDK_ROOT` |
| `aapt2` | string | no | SDK build-tools | Override `aapt2` path |
| `javac` | string | no | host PATH | Override `javac` path |
| `java` | string | no | host PATH | Override Java runtime path |
| `java_home` | string | no | env | Override `JAVA_HOME` passed to Android SDK tools |

## Dependency Edges

| Edge | Accepts | Description |
| --- | --- | --- |
| `deps` | `android_resource` | Android resources merged into this resource package |

## Providers

The target emits `android_resource`.

## Capabilities

| Capability | Output groups |
| --- | --- |
| `build` | `default`, `resources` |

## Source References

Target kind discovery returns these external concepts for partial graph
adoption:

- [`resource_files` on Bazel rules_android's `android_library`](https://bazelbuild.github.io/rules_android/#android_library)
- [`android_resource` from Buck2](https://buck2.build/docs/prelude/rules/android/android_resource/)
- [Android source sets from the Android Gradle plugin](https://developer.android.com/build/build-variants#sourcesets)

Use them when only a resource or asset node needs to move into the Once graph.

## Outputs

| Output | Location |
| --- | --- |
| Static resource package | `.once/out/<target>/resources.apk` |
| R source directory | `.once/out/<target>/generated/r` |
| R text symbols | `.once/out/<target>/R.txt` |

## Example

```toml
[[target]]
name = "SharedResources"
kind = "android_resource"

[target.attrs]
package = "dev.once.shared"
manifest = "AndroidManifest.xml"
resource_files = ["res/**"]
min_sdk_version = 23
```