@aglflorida/android-archivist

CLI tool to archive Android release artifacts (.aab, mapping.txt, sourcemap) into a structured folder hierarchy keyed by bundle ID, version, and version code.

Installation

npm install -g @aglflorida/android-archivist
# or as a dev dependency in your project
npm install --save-dev @aglflorida/android-archivist

After install, run the setup command once to configure:

android-archivist-init

Config is stored at the XDG location:

$XDG_CONFIG_HOME/android-archivist/config.json
# defaults to:
~/.config/android-archivist/config.json

Or create it manually:

{
  "archiveRoot": "/absolute/path/to/archive/root"
}

Usage

android-archivist <version> <androidVersionCode> <bundleId>

Example:

android-archivist 1.3.0 16 com.example.myapp

This copies from android/app/build/outputs/... into:

archiveRoot/
  com.example.myapp/
    1.3.0/
      16/
        app-release.aab
        mapping.txt
        16.sourcemap

Or via npx without installing:

npx @aglflorida/android-archivist 1.3.0 16 com.example.myapp

Local File Server

Serve the archive directory over HTTP for local browsing:

android-archivist-serve

Prints a clickable link and serves archiveRoot at http://localhost:8000. Stop with Ctrl+C.

Reads archiveRoot from the same XDG config. Can also be run directly:

python3 serve.py

Development

Prerequisites

• Node.js >= 22
• Python >= 3.12

npm install
pip install -r requirements-dev.txt

Scripts

Command	Description
npm run build	Compile scripts/archive.ts → dist/archive.js
npm test	TypeScript tests
npm run test:py	Python tests
npm run lint	Biome lint (TypeScript/JS)
npm run lint:py	Ruff lint (Python)
npm run lint:fix	Auto-fix lint issues
npm run verify	Full check (lint + test + typecheck)
android-archivist-serve	Start local file server with browser link

Makefile

make venv     # Create Python venv in ./android_archive
make start    # Start the Python file server
make clean    # Remove venv

License

MIT