Known Limitations

Overview

The External Applications SDK is actively evolving. The items below are the main constraints to keep in mind when building and testing your app today.

glibc 2.26 Compatibility

External Applications must remain compatible with glibc 2.26, which is the stable Linux baseline used by the device firmware.

glibc is part of the device's core Linux system, so updating it is much more involved than updating a single app or library. A newer glibc version could affect existing firmware services and apps across supported devices. For now, glibc 2.26 remains the compatibility target.

The SDK checks this automatically during builds and rejects binaries that depend on newer glibc symbols. You can also run the check manually:

sdk/check-compat.sh dist/external/my-game/my-game.elf

Display Support

The SDK does not yet include helper tooling for every device screen, display layout, or resolution profile. Some Legends devices have different screen sizes, aspect ratios, orientations, or UI expectations, so your app may need its own layout and scaling logic for the devices you want to support.

For now, treat display handling as part of your app's responsibility:

We plan to add SDK tools and helpers for display profiles in a future update so apps can target multiple screens more easily.