SDL/docs/README-ubuntu-touch.md
Semphriss e52dbf4442
Add basic Ubuntu Touch functions #12543
This adds support for:
* System theme
* Sandbox detection
* Device form factor detection

Many things aren't properly supported yet, but changes and upgrades will happen on the Ubuntu Touch side, so SDL should automatically support more Ubuntu Touch features as time goes.
2026-06-21 11:51:15 -07:00

1.1 KiB

Ubuntu Touch / Lomiri

Ubuntu Touch being similar to Ubuntu desktop, most features should be supported out-of-the-box with SDL.

Developing apps

Ubuntu Touch apps are developed using Clickable.

Clickable provides an SDL template. It is highly recommended to use the template as a starting point for both new and existing apps.

Considerations

Ubuntu Touch is similar to the desktop version of Ubuntu, but presents some differences in behavior. Developers should be wary of the following:

SDL_GetPrefPath

The only allowed writable folder is ~/.local/share/<appname>/. SDL_GetPrefPath ignores its arguments and will always return that path on Ubuntu Touch. No changes are needed in apps.

Video driver

Currently, a bug forces SDL to use the Wayland driver on Ubuntu Touch. No changes are needed in apps.

Extra functions

SDL provides SDL_IsUbuntuTouch() to differentiate between Ubuntu Touch and regular Unix, which can help if certain platform-specific tweaks are needed.