V-Play has a new name, say hi to Felgo!Learn More

Gradle Build System

Felgo uses the Gradle build system for Android builds. In order to use Gradle make sure that you adapt the following settings:

Installing Gradle Dependencies

Before using Gradle make sure that you already installed the Android Stand-alone SDK Tools on your system.

Open the Android SDK Manager and check that the following extra packages are installed:

  • Android Support Repository
  • Google Repository

Enable Gradle Build System

Open your project's build settings by selecting the Projects tab in the left pane of Qt Creator. Select your Android build target and open the Build Android APK detail pane. Make sure that the checkbox Use Gradle is checked like in the screenshot below.

You can also enable Gradle support for all projects in the Qt Creator settings ("Android").

Create Gradle Template Files

Note: If you create your project with one of our project wizards, these files are automatically created for you and you don't have to perform this step.

Most plugins require you to adapt a Gradle build file. If your project does not have a custom build.gradle file yet open the Build Android APK detail pane like described above and click the button Create Templates.

This step adds several files to a subfolder called android within your project file tree, one of them is called build.gradle and contains all relevant build settings for usage with Felgo.

Upgrading Your Project to Gradle

If your project currently uses the legacy Ant build system you can perform following steps to migrate to the new Gradle build system:

  • Remove the android/project.properties and android/local.properties files if present.
  • Make sure to follow the steps as described in Enable Gradle Build System and Create Gradle Template Files.
  • Add the Felgo repository URL to your build.gradle to automatically fetch dependencies, so that it looks like the following block:
     allprojects {
       repositories {
         maven { url 'https://sdk.v-play.net/maven/' } // Add this line to your build.gradle file
  • If you're using Felgo Plugins, add the dependencies to your build.gradle file as stated in the specific plugin integration guide.

AndroidManifest.xml File

Felgo uses a custom activity for your Android project. Perform the following steps migrate your existing project for usage with Felgo 2.8.2 and above:

Note: If AndroidManifest.xml does not yet exist in your project, follow the steps above.

Open the AndroidManifest.xml file found under Other files in your project tree (switch to the XML Source tab at the top of Qt Creator's editor window or use an external text editor) and change the

<application>'s android:name parameter from "org.qtproject.qt5.android.bindings.QtApplication" to "net.vplay.helper.VPlayApplication"

and the

<activity>'s android:name parameter from "org.qtproject.qt5.android.bindings.QtActivity" to "net.vplay.helper.VPlayActivity".

Note: If you already added your own custom activity you can keep the value the activity name, make however sure that your custom activity uses the base class net.vplay.helper.VPlayActivity and all your overridden methods call the equivalent super(); methods.

Using Legacy Ant Build System

Felgo can still be used with Android's legacy Ant build system. This however requires you to maintain the required dependencies on your own and is therefore not recommended by us.

Voted #1 for:

  • Easiest to learn
  • Most time saving
  • Best support

Develop Cross-Platform Apps and Games 50% Faster!

  • Voted the best supported, most time-saving and easiest to learn cross-platform development tool
  • Based on the Qt framework, with native performance and appearance on all platforms including iOS and Android
  • Offers a variety of plugins to monetize, analyze and engage users
create apps
create games
cross platform
native performance
3rd party services
game network
level editor
easiest to learn
biggest time saving
best support