TinyAPK Lab
Настоящие Android-приложения, собранные вручную, размером в килобайты.
Чистый Java · Android SDK · Без Gradle · Без AndroidX · Без Kotlin
English · Русский · Быстрый старт · Проекты · Сборочная цепочка · Структура
Две играбельные игры. Два APK весом менее 21 КБ. Ноль зависимости от системы сборки.
Сделано одним разработчиком · собрано пятью консольными инструментами
Note
Внутри нет проекта Gradle. Эти приложения компилируются и упаковываются вручную:
aapt2 -> ecj -> d8/R8 -> zipalign -> apksigner. Нетbuild.gradle, нет проекта Android Studio, нет AndroidX — только исходники на Java, платформенный SDK и несколько консольных утилит.
TinyAPK Lab — небольшая, аккуратно собранная коллекция Android-приложений, написанных на чистом Java поверх «сырых» API Android SDK. Без Gradle, без Kotlin, без AndroidX, без игровых движков — только SurfaceView, Canvas и сборочная цепочка, целиком состоящая из консольных инструментов. Смысл — показать, насколько маленьким, прозрачным и переносимым может быть настоящее, устанавливаемое Android-приложение.
Tip
Release-сборки укладываются в 21 КБ. Пустой проект «Hello World» из Android Studio обычно весит 1.5–3 МБ ещё до того, как написана хоть одна строчка логики. Эти приложения в 70–150 раз меньше — и при этом полностью играбельны.
Рендеринг через |
|
Подписанные, устанавливаемые release-сборки размером 16.8–20.9 КБ лежат прямо в репозитории. |
Содержание
- Быстрый старт
- Проекты
- Скриншоты
- Сборочная цепочка
- Стек технологий
- Структура репозитория
- Зачем это нужно
- Документация
- Принципы
- Лицензия

Быстрый старт

Вариант A — установить готовый APK
В каждом проекте уже есть подписанная release-сборка в папке build/:
adb install "Tetris/build/LowBlocks-release.apk"
adb install "Sandbox/build/LowSand-release.apk"

Вариант B — собрать самостоятельно
Без Gradle, без проекта для открытия в IDE — нужны только инструменты сборки платформы в PATH:
aapt2 compile -o compiled/ res/**/*
aapt2 link -o app-unsigned.apk -I android.jar --manifest AndroidManifest.xml compiled/*.zip
ecj -d classes -classpath android.jar src/**/*.java
d8 --release --output . classes/**/*.class
zip -j app-unsigned.apk classes.dex
zipalign -f 4 app-unsigned.apk app-aligned.apk
apksigner sign --ks debug.keystore --out app-release.apk app-aligned.apk
Полные пошаговые заметки по каждому проекту — в manual-build/, включая гайд по R8-сжатию (EN / RU).

Проекты
| Проект | Что внутри | Артефакты сборки |
|---|---|---|
| Классический Tetris со свайп-управлением — 7 тетромино, ghost piece, wall kick, очки, уровни, превью следующей фигуры. | LowBlocks.apk — 16 811 БLowBlocks-release.apk — 16 811 Б | |
| Песочница с падающим песком — порошки, вода, семена, жар, пар, простое выращивание, кулинарные реакции. | LowSand.apk — 20 907 БLowSand-release.apk — 16 811 Б | |
Заметки по ручной сборке через aapt2 -> ecj -> d8/R8 -> zipalign -> apksigner, плюс рекомендации по R8. | Документация |

Скриншоты

Сборочная цепочка
flowchart LR
SRC["Исходники Java<br/>+ ресурсы"] --> AAPT["aapt2<br/>compile & link"]
AAPT --> ECJ["ecj<br/>компиляция в .class"]
ECJ --> D8["d8 / R8<br/>.class -> .dex"]
D8 --> ZIP["zipalign<br/>выравнивание"]
ZIP --> SIGN["apksigner<br/>подпись"]
SIGN --> APK["Подписанный APK<br/>16.8-20.9 КБ"]
Никакого демона Gradle, разрешения зависимостей или annotation processor'ов — пять инструментов, одно направление, полностью проверяемый результат на каждом шаге.

Стек технологий
Java 8 — язык
Android SDK APIs — платформа, без support-библиотек
SurfaceView + Canvas — рендеринг, без игрового движка
aapt2 -> ecj -> d8/R8 -> zipalign -> apksigner — сборочная цепочка
Намеренно не используется: Gradle, Kotlin, AndroidX/Jetpack, сторонние UI- или игровые фреймворки, внешние зависимости.

Структура репозитория
.
├── README.md # этот файл (English)
├── README.ru.md # русская версия
├── PROGUARD_README.md # гайд по R8 / ProGuard (EN)
├── PROGUARD_README.ru.md # гайд по R8 / ProGuard (RU)
├── LICENSE # MIT (EN)
├── LICENSE.ru.md # MIT (RU)
├── THIRD_PARTY_TOOLS.md # уведомление о лицензиях Android SDK / build tools (EN)
├── THIRD_PARTY_TOOLS.ru.md # уведомление о лицензиях Android SDK / build tools (RU)
├── .github/
│ └── assets/
│ ├── banner.svg
│ ├── badges/
│ └── icons/
├── docs/
│ └── images/
│ ├── tetris-shot-v2.jpg
│ ├── sandbox_en.jpg
│ └── sandbox_ru.jpg
├── manual-build/ # гайды по ручной сборке
│ ├── README.md
│ ├── SKILL.md
│ ├── proguard/SKILL.md
│ └── tetris/SKILL.md
├── tools/ # бинарники сборки и keystore-файлы
│ └── windows/
├── Tetris/
│ ├── README.md
│ ├── build.ps1
│ └── build/
└── Sandbox/
├── README.md
├── build.ps1
└── build/

Зачем это нужно
Большинство туториалов по Android начинаются с Gradle, AndroidX и пары сотен мегабайт инфраструктуры ещё до того, как отрисован хоть один пиксель. Этот репозиторий идёт в обратную сторону: насколько маленьким, прозрачным и свободным от зависимостей может быть настоящее, устанавливаемое Android-приложение, если собирать его вручную, инструмент за инструментом?
Это одновременно и справочник по ручной цепочке aapt2 -> d8 -> apksigner, и proof of concept того, что Android-приложения в масштабе килобайт без Gradle всё ещё вполне реальны.

Документация
| Геймплей, управление, структура исходников | |
| Правила частиц, выращивание, механика готовки | |
Пошагово: aapt2 -> ecj -> d8/R8 -> zipalign -> apksigner | |
| Сжатие, обфускация, уменьшение размера | |
| Заметки о лицензиях Android SDK / build tools |

Принципы
- Минимализм по умолчанию. Если для чего-то нужен Gradle, AndroidX или менеджер зависимостей — этому не место здесь.
- Прозрачность. Никакой скрытой магии сборки — каждый шаг цепочки это обычная команда, которую можно запустить самому.
- Переносимость. Сборка из терминала, без ничего лишнего, кроме консольных инструментов Android SDK и JDK.
- Малый размер по умолчанию. Каждая release-сборка коммитится в репозиторий, чтобы было видно, что реально значит «масштаб килобайт».

Лицензия
Оригинальный код и документация распространяются под лицензией MIT (EN / RU). Отдельное уведомление об инструментах (EN / RU) поясняет, что проекты собираются с помощью Android SDK и build tools, которые остаются под своими собственными лицензиями.
TinyAPK Lab · настоящие Android-приложения в масштабе килобайт
Лицензия MIT · подробности в LICENSE.ru.md
