
Preface
-------

Please note that it will take you probably several hours to setup everything
correctly, if you want to develop for mobile. Here you will find many links to
other places.


Install Qt5.15
--------------

For mobile we don't want latest Qt6, which currently still misses important QML
modules. There is basically no way around the online installer, because you
don't want to build the cross-compiled part of Qt for yourself.

See [reademe-qt](readme-qt.md) for the Qt online installer. You'll need to
register with an email.

Make sure to select the following in the online installer (assuming Linux):

* [Qt5.15 Desktop, Android](doc/img/qt-desktop-android.png)

Even on Linux you really want the online installer. Yes it's a 1 GB download,
but it brings all the examples, demos, tutorials, documentation, Qt Designer,
all QML modules, so you won't miss anything. And you can easily add/remove
parts later (see `~/Qt/MaintainanceTool` after installation), or install Qt6
in the future (side by side).


Cross-compile ECL
-----------------

Next step is cross-compiling ECL. See
[readme-prepare-android](readme-prepare-android.md).


Build LQML
----------

Now build both the `lqml` executable and library, see
[readme-build](readme-build.md).

You may now try to run a desktop example, to see if it works. Every example has
a readme which explains everything.


Install example on android device
---------------------------------

The best example to take as a template for development on mobile is
[examples/advanced-qml-auto-reload](examples/advanced-qml-auto-reload).

Please see `readme` and `readme-build` of that example.
