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, select the Qt version and 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. The plugin will now provide you with a code snippet to copy and paste into the app/build.gradle file of your Android project.

  5. Once you have done that, press Sync, and your QML project will appear in your Android project tree.

  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.

© 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.