Skip to content

emericg/QmlAppTemplate

Repository files navigation

QmlAppTemplate

GitHub action GitHub action GitHub issues License: GPL v3

A Qt6 / QML application template, with a full set of visual controls, helper modules, as well as build and deploy scripts and CI setups.

About

Dependencies

You will need a C++17 compiler and Qt 6.5+.
For macOS and iOS builds, you'll need Xcode (13+) installed.
For Android builds, you'll need the appropriates JDK (17) SDK (24+) and NDK (25+). You can customize Android build environment using the assets/android/gradle.properties file.

Building QmlAppTemplate

$ git clone https://github.com/emericg/QmlAppTemplate.git --recursive
$ cd QmlAppTemplate/build/
$ qmake .. # configure with QMake
$ cmake .. # OR configure with CMake
$ make

C++ modules

AppUtils Various general purpose helpers

MobileUI Interact with Android and iOS UI

MobileSharing Use Android and iOS cross application sharing features

SingleApplication Keep only one instance of your application active at a time

QML component library

TODO

Deploy scripts

Linux application ZIP and AppImage

macOS application ZIP (unsigned)

Windows application ZIP and NSIS installer

GitHub CI workflows

These files are also useful to get an idea about the whole build and deploy process.

Desktop (qmake) Linux, macOS and Windows workflow (with GitHub deployment)

Desktop (cmake) Linux, macOS and Windows workflow

Mobile (qmake) Android and iOS workflow

Mobile (cmake) Android and iOS workflow (with store deployment)

Linux flatpak "on demand" workflow

Screenshots

GUI_MOBILE

GUI_DESKTOP1 GUI_DESKTOP2

License

QmlAppTemplate is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
Read the LICENSE file or consult the license on the FSF website directly.

Emeric Grange emeric.grange@gmail.com

About

Qt6 / QML application template, with a full set of visual controls, as well as CI setups with build and deploy scripts.

Topics

Resources

License

Stars

Watchers

Forks