Installing Qt Gradle Plugin

The following sections cover installing Qt Gradle Plugin and the required dependencies.

Installing dependencies

To use the the plugin and build a deployable APK, you need to install the minimum required Qt dependencies:

  • Qt for Android installation (6.8.0 or later)
  • The Android SDK

Installing Qt for Android

There are two ways to get Qt for Android, but for most users, we recommended the following way:

Installing Qt for Android with Qt Online Installer

To download and install Qt for Android, follow the instructions on the Get and Install Qt page, and do a custom install that includes at least the minimum requirements:

  • Qt for Android
  • CMake
  • Ninja

The following instructions assume you don't want to install Qt Design Studio and Qt Creator. These would normally be installed by default but the instructions here explicitly deselect these and anything not required.

  1. Select custom install. If you change the location, make sure to note this as you will need it later.
  2. Deselect Qt Design Studio.
  3. Expand Qt 6.8 or later and select Qt for Android.
  4. Deselect Developer and Designer Tools.
  5. Select CMake and Ninja.
  6. Select any optional Qt modules you might need.
  7. Proceed to install.

Cloning, building and installing Qt yourself

This method should only be used by developers who are working with unreleased or modified Qt builds. It won't be covered here.

See Qt for Android - Building from Source.

Installing the Android SDK

Install and note the location of a compatible Android SDK. See Android Supported Platforms.

Installing the plugin

You can find the plugin here: Maven Gerrit

Using the plugin from Maven

Modify the settings.gradle(.kts) from your project's root. This downloads the plugin from the Qt Maven instance, and you will be able to refer to its id in the build.gradle(.kts) later on.

Kotlin/Groovy (settings.gradle(.kts))

pluginManagement {
    repositories {
        mavenCentral()
    }
}

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.