exteraGram Plugin Template

Шаблон плагина для exteraGram / AyuGram, в котором вся логика написана на Kotlin, собирается в DEX и встраивается прямо в .py-файл плагина.

Как это устроено

• <plugin-id>.py — сам плагин: метаданные, i18n, загрузка встроенного DEX через InMemoryDexClassLoader и вызов Kotlin-класса Plugin.
• src/main/kotlin/... — основная логика (хуки, пункты меню, настройки, i18n).
• Gradle-плагин io.github.n08i40k.extera собирает Kotlin в шейженный jar и прогоняет его через R8: задачи buildDexDebug / buildDexRelease кладут результат в dist/dex/<variant>/classes.dex.
• tools/embed_dex.py — вшивает собранный classes.dex в копию .py.
• tools/dev_watch.py — live-reload на устройстве через extera dev-sync (adb).
• libs/Telegram.jar — классы хост-приложения, распакованные из APK рецептом just update-apk (лежит в git через LFS). Gradle-плагин сам чинит в нём вложенные классы и выкидывает пакеты, приходящие из Gradle-зависимостей, прежде чем положить его в compile-classpath.

Требования

java (JDK 21), uv, just, adb. Для update-apk дополнительно dex2jar, для gen-stubs — java2pyi.

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

# переименовать шаблон под себя: пакет, id и отображаемое имя
just init com.example.myplugin my-plugin "My Plugin"

just dex     # debug-сборка DEX
just watch   # live-reload на подключённом устройстве

Сборка релиза

just ci-release 1.2.3    # -> dist/<plugin-id>.plugin: версия, release-DEX и упаковка

just embed вшивает уже собранный release-DEX в dist/<plugin-id>.py, не трогая версию.

Либо workflow Release в GitHub Actions (запуск вручную, версия в формате x.x.x).

Прочие команды

• just loc — перегенерировать i18n-файлы без полной пересборки DEX.
• just gen-stubs <rt.jar> <android.jar> — стабы для автодополнения в Python.
• just update-apk <apk> — обновить libs/Telegram.jar из APK хоста и закоммитить его.

Лицензия

MIT