The wiki is in the process of moving to Please make your edits there.

Setup_Necessitas_SDK_on_Windows | Qt Wiki | Qt Project

Setup Necessitas SDK on Windows

  • 7 July 2011 Update from the maintainer of Necessitas, Android Qt port. They are planning to install Ant and JDK with the Necessitas installer. When that happens we will no longer need to install them separately.

Downloads and Installation locations


Necessitas 0.3 Alpha included the download of Ant.
Location: C:\Users\<Username>\necessitas\apache-ant-1.8.2

  • WinAnt – Windows installer for Apache Ant.
    Binary: winant-install-v7.exe
    SHA1: e02dbd46418fff6b8258ca358ab22368334e857d

Windows 32-bit platform – C:/Program Files/WinAnt/bin/ant.bat
Windows 64-bit platform – C:/Program Files (x86)/WinAnt/bin/ant.bat

JDK (Java Development Kit) and JRE (Java Runtime Environment)

Windows 32-bit platform – C:\Program Files\Java\ with subdirectories jdk1.7.0_01 and jre7
Windows 64-bit platform – C:\Program Files (x86)\Java\ with subdirectories jdk1.7.0_01 and jre7

Necessitas SDK Windows online installer.

Release date: Saturday, 29 October 2011.
Version: 0.3 Alpha
Binary: necessitas-0.3-online-sdk-installer-windows.exe
SHA1: 0f7578946bd43f5a66fc5ffa8120a8eed6c98425

Download the Windows online installer.
Use the default install location suggested by the installer: C:\Users\<Username>\necessitas

Ministro Service

Binary: Ministro II.apk
SHA1: 82520c34339e405161c36486f7d6e39dcd79ef27

Binary: MinistroConfigurationTool II.apk
SHA1: 94a90ca876cc25f05b786ec10cd09a5543d14d6b

Location: C:\QT_test\Ministro II.apk

  • Hint: Make the whole directory write access and not read only for all of the above! Unblock Ministro.


Create AVD (Android Virtual Device)

C:\Users\<Username>\necessitas\android-sdk-windows\ SDK-Manager.exe
A popup dialog appears which refreshes the available devices. Ignore it or cancel.
NEVER DO Update and install : to get other virtual devices. Stick to the ones Necessitas provides.

On the left you have a selection list.
Installed packages
It shows you about 8 entries with different versions of Android SDK platforms.
Virtual devices
Here you create your AVD
Click the button new. Give it a name e.g. Android2.3.3. Choose a target e.g. Android 2.3.3 – API level 10. Size : 1024 mb. Snapshot enabled. Skin : HVGA
Press the button Create AVD and the name you choose appears in the list.

Android Qt Creator settings


You only have to set the path to ant.bat. The other fields are filled in automatically.
You can see your AVD target you made earlier.


Debug version

In Qt Creator select the build …Arm v 5 Debug and start using the green arrow bug button “Start debugging” or F5. This will make the which you will need later for the next step. It is possible that Qt Creator cannot get through, but that’s no problem. The most important is you have the .so file.


Build version

The next step is to choose for build …Arm v 5 Release.


On Tab Manifest

choose for Android 10

On Tab Permissions


On Tab Libraries

Click the button “Read information from application (must be compiled)”
This will read the necessary libraries like
You don’t have to click the libraries, even if the checkboxes are not checked it will work…

Check the option : “Install Ministro system wide qt shared libraries installer” and click the button “Choose apk” to point to the Ministro-2.0.apk file you installed earlier.

Click Run or CTRL + R
Then you see your app icon, it launches and wants to download files (only the first time).
Your app will start automatically now.

Have fun!

Appendix : Environment variables

User variables

C:\Program Files (x86)\WinAnt;
C:\Users\<Username>\necessitas\apache-ant-1.8.2; (Downloaded automatically on Necessitas SDK 0.3 Alpha release.)

C:\Program Files\Java\jdk1.7.0_01;

C:\Program Files (x86)\WinAnt\bin;C:\Users\<Username>\necessitas\android-sdk-windows\tools;C:\Users\<Username>\necessitas\QtCreator\bin\;


System variables

C:\Program Files (x86)\Java\jre6\lib\ext\

Path (Related Necessitas SDK paths.)
C:\QtSDK\Desktop\Qt\4.7.4\mingw\bin\; C:\Users\<Username>\necessitas\android-sdk-windows\tools;


C:\Program Files (x86)\Java\jre6\lib\ext\;


Don’t know why “Redirect to a more accurate wiki page” does not inherit the article history.
Thanks to all contributors from How_to_use_Necessitas_Emulator_on_Windows_7 [] page.