dominic/Tactility
1
0
Fork 0
mirror of https://github.com/ByteWelder/Tactility.git synced 2026-08-17 23:55:04 +00:00
Code Issues Packages Projects Releases Wiki Activity
Tactility/.claude/rules/app-framework.md
Ken Van Hoeylandt d6b1d15e56
Various improvements (#614) 
- Auto-select widgets in Launcher and apps with toolbars on devices without touch.
- Improved USB HID input reliability, cleanup
- Updated PSRAM settings to improve boot stability on supported devices.
- Prevented duplicate Wi-Fi event subscriptions during screen rebuilds.
- Updated docs
- Fixes in WifiManage and WifiConnect
- Reduced main task stack size
- Moved USB HID stack size to PSRAM when available
- app_manager_find_manifest() now returns a copy instead of a pointer
2026-08-13 20:30:47 +02:00

1.5 KiB
Raw Blame History

Architecture: App Framework

Apps are event-driven, C API (app-module, <app/*.h>), not a C++ class. Each app has an AppManifest (id, name, category, location, flags) and a main(app_instance_id, argc, argv) entry point (AppMainFn), modelled on a C program's main(). Every app instance gets its own dedicated task for its whole lifetime, and blocks in that task until it returns.

Lifecycle and inter-app communication go through app_manager_*() (app/manager.h) and app_event_*() (app/event.h):

  • app_manager_start()/app_manager_start_with_parameters() launch a plain instance; app_manager_start_for_result() launches a modal child that reports back to a parent instance.
  • An app subscribes with app_event_subscribe()/app_event_await() and reacts to APP_EVENT_CLOSE (terminate now) and APP_EVENT_RESULT (a child it started reported back).
  • An app closes itself by calling app_manager_finish() right before returning from main(); another instance is closed via app_manager_stop().

Apps are registered at startup via app_manager_add(). External apps can be loaded from SD card via manifest.properties files, or side-loaded as ELF binaries on ESP32 (see app/loader.h's AppLoaderApi).

Apps can be loaded from:

  • memory (APP_LOCATION_MEMORY)
  • a path pointing to an install folder where an .app file was installed (APP_LOCATION_PATH)
  • a path pointing to an .elf file (APP_LOCATION_PATH)

An app can build an optional UI via the LVGL window-manager module (see lvgl.md).