aosp

Python wrapper around an AOSP (Android Open Source Project) source tree. Sources build/envsetup.sh, runs lunch, exposes the resulting build environment as a Python object, and provides convenience accessors for the product-out tree.

Requires sh and yautil (uses docker_sh for sandboxed builds).

Install

pip install -e .

Python ≥ 3.9.

API

from aosp import Aosp, load_aosp, get_env

Aosp

Main object representing one AOSP checkout + build target.

aosp = Aosp(path="/path/to/aosp", build_target="aosp_arm64-eng")
# or
aosp = Aosp.from_path("/path/to/aosp", build_target="aosp_arm64-eng")

Notable properties:

AospProductOut

Returned by Aosp.out. Helpers for locating files under $ANDROID_PRODUCT_OUT:

load_aosp(...)

Module-level factory (see aosp.aosp.load_aosp) that constructs an Aosp from a config profile.

get_env(path, target=None) -> dict

Lower-level helper: sources build/envsetup.sh in path (and optionally runs lunch <target>), then returns the resulting environment as a dict.

env = get_env("/path/to/aosp", "aosp_arm64-eng")
print(env["ANDROID_PRODUCT_OUT"])