SDL/docs/README-ubuntu-touch.md

1.4 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>/, where <appname> is the identifier string for the app. It can be found in the manifest.json file under the key "name", and usually looks like appname.yourname.

A future version of SDL may change how SDL_GetPrefPath operates on Ubuntu Touch to make it ignore its arguments and always choose the correct writable folder. For future-proof-ness, using SDL_GetPrefPath("", "<appname>") as a writable directory is a safe choice.

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.