Android Builder

Android Builder is a Termux-oriented shell tool for bootstrapping simple Android app projects, installing the required Android SDK pieces, and building/exporting APKs from the command line.

Installation

Before installing:

optionally run termux-change-repo
run pkg update
run pkg upgrade -y
install curl if it is not already present: pkg install -y curl

Then run the bootstrap installer inside Termux:

pkg update
pkg upgrade -y
pkg install -y curl
curl -fsSL https://git.dark98.co.uk/Dark98/Termux-Android-Builder/raw/branch/main/install.sh | bash

The bootstrapper will:

install the required Termux packages
clone or update the Android Builder checkout
add ~/android-builder/bin to your PATH

Usage

After installation, the main command is:

android-builder help

Available commands:

android-builder setup
android-builder doctor
android-builder new MyApp
android-builder wrapper
android-builder new MyApp --template empty
android-builder build
android-builder export

Command Layout

The CLI is now split into smaller scripts for readability and maintenance:

bin/android-builder is the command dispatcher
shared helpers live in lib/common.sh
individual command implementations live in lib/commands/

Project Generation

android-builder new creates a basic Android app skeleton with:

Gradle settings and properties
a single app module
vendored Gradle wrapper files for the generated project
a minimal MainActivity
a simple default theme and string resources

The template defaults are controlled in one place through environment variables:

ANDROID_BUILDER_GRADLE_VERSION defaults to 8.7
ANDROID_BUILDER_AGP_VERSION defaults to 8.5.2
ANDROID_BUILDER_GRADLE_DISTRIBUTION_SHA256 defaults to the official checksum for gradle-8.7-bin.zip

The project generator and the generated projects themselves do not need a system gradle binary anymore.

Notes

The project is designed around Termux.
android-builder setup installs the SDK command-line tools and platform packages into ~/android-sdk.
android-builder export copies the built APK into ~/storage/documents after storage permission is granted.

Troubleshooting

If android-builder export says storage is not configured, run termux-setup-storage, grant the permission prompt, then rerun android-builder export.
If android-builder build says ./gradlew is missing, regenerate the project with android-builder new <ProjectName>.
If you have an existing Android project and want to add wrapper files, run android-builder wrapper from the project root.
If Android SDK packages are missing, rerun android-builder setup.

2.7 KiB Raw Permalink Blame History