Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/patrickelectric/qhot
Hot reload for nested qml files
https://github.com/patrickelectric/qhot
debug hot-reload qhot qml qt reload test
Last synced: 3 days ago
JSON representation
Hot reload for nested qml files
- Host: GitHub
- URL: https://github.com/patrickelectric/qhot
- Owner: patrickelectric
- License: gpl-3.0
- Created: 2019-06-14T23:07:36.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-04-21T16:25:44.000Z (8 months ago)
- Last Synced: 2024-04-21T21:41:14.092Z (8 months ago)
- Topics: debug, hot-reload, qhot, qml, qt, reload, test
- Language: C++
- Homepage:
- Size: 4.96 MB
- Stars: 169
- Watchers: 8
- Forks: 20
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-made-by-brazilians - QHot
README
# QHot
Live preview of your qml modifications. It works with nested qml components !
Check the online version [qmlonline](https://patrickelectric.work/qmlonline/) (Now as an official KDE project) !
## Install
### Downloads :package:
- Qt6:
- :computer: [Windows](https://github.com/patrickelectric/qhot/releases/download/qt6-1.0.0/qhot-Windows.zip)
- :apple: [MacOS](https://github.com/patrickelectric/qhot/releases/download/qt6-1.0.0/qhot.dmg)
- :penguin: [Linux](https://github.com/patrickelectric/qhot/releases/download/qt6-1.0.0/qhot.AppImage)
- Qt5:
- :computer: [Windows](https://github.com/patrickelectric/qhot/releases/download/qt5-1.0.0/qhot_release.zip)
- :apple: [MacOS](https://github.com/patrickelectric/qhot/releases/download/qt5-1.0.0/qhot.dmg)
- :penguin: [Linux](https://github.com/patrickelectric/qhot/releases/download/qt5-1.0.0/qhot.AppImage)
### Arch Linux :zap:
- AUR: `qhot-git`
### Build for local Qt kit
Build qhot from sources for your specific Qt kit, and install it alongside the
other Qt tools. This way qhot will find all the Qt plugins that you already
have installed on your local system. No need for a large package.
```sh
git clone https://github.com/patrickelectric/qhot.git
cd qhot
# Configure
cmake -B build -DCMAKE_BUILD_TYPE=Release
# Or use CMAKE_PREFIX_PATH where QTDIR should point to a Qt kit, e.g. C:/Qt/5.15.2/msvc2019_64
cmake -S . -B my-build -DCMAKE_BUILD_TYPE=Release -DCMAKE_PREFIX_PATH="$Env:QTDIR"
# Compile
cmake --build build --parallel --config Release
# Install qhot in the bin folder, e.g. C:/Qt/5.15.2/msvc2019_64/bin
cmake --build build --target install
```
## How to use
To run qhot:
`./qhot.exe myFile.qml` or `./qhot.dmg myFile.qml` or `./qhot.AppImage myFile.qml`
### Supported commands
```sh
--help, -h, -? Give this friendly help message for our confort
--desktop Force use of desktop GL (AA_UseDesktopOpenGL)
--gles Force use of GLES (AA_UseOpenGLES)
--software Force use of software rendering (Qt::AA_UseSoftwareOpenGL)
--scaling Enable High DPI scaling (AA_EnableHighDpiScaling)
--no-scaling Disable High DPI scaling (AA_DisableHighDpiScaling)
--import-path, -I Add list of **import** paths (path:path)
--plugin-path, -P Add list of **plugin** paths (path:path)
--translation Set the translation file (file)
--style Change style
--profile-path Path (including filename) to qhot-profile.json (file)
--background Set the background color (color)
--quick-controls-conf Path (including filename) to qtquickcontrols2.conf (file)
--app-name Name of the application running inside qhot (name)
```
### Store options in a profile
All the command line options can also be set in a ```qhot-profile.json``` file. For
example:
```json
{
"import-path": [
"lib/qml/modules",
"src/qml"
],
"background": "#808080",
"quick-controls-conf": "src/qml/qtquickcontrols2.conf"
}
```
The import paths in the example above are relative to the file itself, but can
also be absolute. The relative paths make it more convenient to add it to a
vcs repository.
### Integrate in QtCreator
Integrating qhot in QtCreator makes it very easy to quickly prototype within
the IDE. See [Using External Tools](https://doc.qt.io/qtcreator/creator-editor-external.html).
Example configuration:
1. Executable: `C:\Qt\5.15.2\msvc2019_64\bin\qhot.exe`
2. Arguments: `%{CurrentDocument:FilePath} --profile-path "%{ActiveProject:Path}/qhot-profile.json"`
3. Environment: `QT_ASSUME_STDERR_HAS_CONSOLE=1` (This will append stdout to the console)
It is also quite handy to add a shortcut in QtCreator to launch qhot. See
[Keyboard Shortcuts](https://doc.qt.io/qtcreator/creator-keyboard-shortcuts.html).
### Shortcuts
- **Ctrl+Meta+F1** Launch popup to change background
- **Ctrl+Meta+Q** Quit application
### Loading Test Data
QHot has the same functionality as qmlscene to load dummy test data and it
works exactly the same way:
[load test data](https://doc.qt.io/qt-5/qtquick-qmlscene.html#loading-test-data).