Writing your first application from scratch

1. Open an existing Android Studio project or create a new one.
2. From Android Studio top-left select File -> New -> New Qt Project.

   

3. Set the name for the project, select the projects folder, provide the Qt Path, and select the minimum Qt version. In the Apply Qt Gradle Plugin section, leave it as default to automatically apply the latest version of the Qt Gradle Plugin to the app/build.gradle(.kts) file. Select No if you want to do it manually, for example using Android Version Catalogs. Then, select OK.

   

   This creates four initial files for the project in a folder with the name you specified for your project.

   • The CMakeLists.txt project file.
   • The main.cpp file.
   • The Main.qml file.
   • A .gitignore file, to ignore any files within a future build directory.
4. Your project will automatically sync, and your QML project will appear in your Android project tree.

   

5. You can change more settings by navigating to File -> Settings -> Build, Execution, Deployment -> Qt. These fields (except Qt Path) are optional and are used for fine tuning your build.

   

6. Start writing your first Qt QML application!

If you are a returning user or just getting started with QML, the QML Reference has what you need.

Integrating QML in an Android application

See the Qt Quick for Android overview for information on embedding QML in Android applications.