MrBeast.art
MrBeast.art

TinyAPK Lab

Настоящие Android-приложения, собранные вручную, размером в килобайты.

Java
Ветки 1

Обновлено

TinyAPK LabTinyAPK Lab

TinyAPK Lab

Настоящие Android-приложения, собранные вручную, размером в килобайты.

Чистый Java · Android SDK · Без Gradle · Без AndroidX · Без Kotlin

English · Русский · Быстрый старт · Проекты · Сборочная цепочка · Структура


Java 8 Android Без Gradle Размер APK MIT License

Zero dependencies Android Studio не нужен 5 шагов сборки 2 проекта



Две играбельные игры. Два 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 раз меньше — и при этом полностью играбельны.

Чистый Java, без лишнего

Рендеринг через SurfaceView + Canvas, без игрового движка, без тяжёлых reflection-фреймворков — каждая строчка читаема.

Ручная сборочная цепочка

aapt2 -> ecj -> d8/R8 -> zipalign -> apksigner — та же цепочка, что Android Studio прячет от вас, запущенная вручную.

APK в масштабе килобайт

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

Скриншоты

Скриншот Tetris
Tetris
Минималистичный UI, ghost piece, очки, уровни.
Скриншот Sandbox
Sandbox
Частицы, жар, выращивание, готовка.

Сборочная цепочка

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 всё ещё вполне реальны.


Документация

Проект TetrisГеймплей, управление, структура исходников
Проект SandboxПравила частиц, выращивание, механика готовки
Гайды по ручной сборкеПошагово: aapt2 -> ecj -> d8/R8 -> zipalign -> apksigner
Гайд по R8 / ProGuardСжатие, обфускация, уменьшение размера
Уведомление о сторонних инструментахЗаметки о лицензиях 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