mirrors/lqml
1
Fork 0
mirror of https://gitlab.com/eql/lqml.git synced 2025-12-06 02:30:38 -08:00
Code Issues Projects Releases Packages Wiki Activity
A lightweight QML-only ECL binding to Qt5/Qt6.
316 commits 1 branch 0 tags 16 MiB
Find a file
pls.153 b25acd28c0 revisions
2023-03-22 20:06:44 +01:00
cpp-lib add convenience macro WITH-ROOT-ITEM (for e.g. QML Repeater items with identical object names) 2022-10-31 20:28:17 +01:00
doc add convenience macro WITH-ROOT-ITEM (for e.g. QML Repeater items with identical object names) 2022-10-31 20:28:17 +01:00
examples revisions 2023-03-22 20:06:44 +01:00
platforms revisions 2023-02-25 12:08:53 +01:00
screenshots add screenshot of example 'camera' 2022-11-07 13:00:43 +01:00
slime revisions 2022-03-18 07:59:44 +01:00
snippets add new snippet 'snippets/toast' (like android 'Toast') 2023-03-15 08:34:54 +01:00
src revisions 2023-02-25 12:08:53 +01:00
.gitignore example 'cl-repl': prepare for manually adding OpenSSL on android (not included here) 2022-12-09 15:51:28 +01:00
beginners-guide-android.md some revisions 2022-05-17 21:45:40 +02:00
beginners-guide-ios.md some revisions 2022-05-17 21:45:40 +02:00
license.txt ini 2022-01-13 15:56:44 +01:00
readme-build.md small revisions 2022-06-17 12:55:48 +02:00
readme-prepare-android.md add example 'wear-os' (android WearOS 2+ watches only) 2022-05-10 11:02:23 +02:00
readme-prepare-ios.md small revisions 2022-06-17 12:55:48 +02:00
readme-qml-live-preview-and-slime.md revisions 2022-04-16 07:09:07 +02:00
readme-qt.md make example work on android; revisions 2022-02-11 13:05:59 +01:00
readme-windows.md revisions 2022-04-23 15:21:15 +02:00
readme.md add hack to make 'unzip' work on iOS 2022-11-30 09:59:35 +01:00

readme.md

Description

A lightweight ECL based QML-only binding to Qt5/Qt6.

This small project aims to simplify all the steps needed for building cross-platform apps. The same sources can be used to build executables for both desktop (Linux/macOS/Windows) and mobile (android/iOS).

QML auto reload

A new feature is auto reloading of QML files after saving any changes. This works both on the desktop and on mobile.

As a concrete example, you may have running your app on the desktop, and have both an android mobile device plus an iOS mobile device pointing to the IP of the desktop. Now you will see any change to QML on all 3 screens simultaneously.

This even works (with some limitations, and only in this advanced example) at QML file level, which means: only the QML file currently edited is reloaded, preserving the state of all other QML files, and -- more importantly -- the current view in case of nested page structures.

License

ECL and Qt5/Qt6 are LGPL. LQML can be considered public domain.

Tested

The examples are only tested with Qt5.15. The binding also works with Qt6, but would need some adaption of QML in most examples. It's recommended to use the new Qt online installer (see readme-qt), where you can choose to install different Qt versions side by side, sharing the same Qt Creator.

TODO

  • port to CMake

macOS note

Qt works (obviously) perfectly well on Linux.

On macOS instead, I found this a little annoying bug: after a QML property change in Slime, the QQuickView is not updating. So, for a visual update you need to click on the view; but it seems to work for subsequent property changes.

Windows note

The Windows version is only meant to run on the desktop, using the (free) MSVC compiler. Please see readme-windows for details.

Known issues

  • on iOS, functions read-sequence, read-char etc. don't update file-position (ECL bug?); for a workaround see hack here