66 lines
2.8 KiB
Markdown
66 lines
2.8 KiB
Markdown
# AXP Resurrection — AXPR23
|
|
|
|
**AXPR23** is a finished Android 16 ROM project for the Google Pixel 4a
|
|
(`sunfish`). It recreates the AXP.OS user experience on top of LineageOS 23.2,
|
|
while preserving the parts that matter on real hardware: Magisk preroot,
|
|
release signing, AXP-style packaging, hardened userspace/kernel changes,
|
|
microG/Google compatibility, AOSmium WebView and the bundled application
|
|
surface.
|
|
|
|
This is an **archive and reference implementation**. AXPR23 is EOL: LineageOS
|
|
23.2 no longer receives new sunfish nightlies. New Android work belongs to the
|
|
separate AXPR24 / Android 17 line and must not be mixed into this branch.
|
|
|
|
## Read this first
|
|
|
|
| Language | Guide |
|
|
|---|---|
|
|
| Español | [`README.es.md`](README.es.md) |
|
|
| English | [`README.en.md`](README.en.md) |
|
|
|
|
The language guides explain what the project is, what is and is not included,
|
|
how to prepare a build host, how to run the reproducible build wrapper, how to
|
|
verify the resulting ZIP and how to sideload or recover safely.
|
|
|
|
## Repository and architecture
|
|
|
|
- Canonical public repository: <https://gitea.vbits.me/sunfish-admin/AXP-Resurection>
|
|
- Final branch: `009-axp-los23-port`
|
|
- Target device: Pixel 4a / `sunfish`
|
|
- Base: LineageOS 23.2 / Android 16
|
|
- Build worker: a dedicated Linux host; do not build the full ROM on a laptop
|
|
- Android source tree and build output: kept outside this Git repository
|
|
- The sibling KernelSU/split-roadmap tree is a separate project
|
|
|
|
## Important limitations
|
|
|
|
The public repository contains source, patches, scripts and documentation. It
|
|
does **not** contain release keys, proprietary APKs, Google/Qualcomm blobs,
|
|
build output, `out/`, ccache, device dumps or signed ROM ZIPs. A clean clone is
|
|
therefore not, by itself, sufficient to reproduce the shipped binary: the
|
|
builder must supply those inputs legally and use its own signing keys.
|
|
|
|
AXPR23 is not a current-security release. Use it for preservation, study and
|
|
the already validated reference device; use the AXPR24 project for new Android
|
|
17 work.
|
|
|
|
## Key documentation
|
|
|
|
- [`docs/009-eol-20261026.md`](docs/009-eol-20261026.md) — final artifact and
|
|
verified state
|
|
- [`docs/003-build-notes.md`](docs/003-build-notes.md) — vanilla Lineage build
|
|
background
|
|
- [`docs/009-ota-rebuild-checklist.md`](docs/009-ota-rebuild-checklist.md) —
|
|
maintainer preflight and postflight gates
|
|
- [`scripts/009-rebuild-from-los.sh`](scripts/009-rebuild-from-los.sh) —
|
|
canonical AXPR23 rebuild entry point
|
|
- [`specs/009-axp-los23-port/spec.md`](specs/009-axp-los23-port/spec.md) —
|
|
functional scope and acceptance requirements
|
|
|
|
## License and upstream work
|
|
|
|
This repository is a project layer over LineageOS/AOSP and other upstream
|
|
components. Each upstream component retains its own license. Do not assume
|
|
that the project repository grants redistribution rights for proprietary blobs,
|
|
Google applications, firmware or signing material.
|