How to Create and Run Qt Application for Android: Difference between revisions
No edit summary |
No edit summary |
||
Line 1: | Line 1: | ||
[[Category:Developing_with_Qt::Ports::Android]]<br />[[Category:HowTo]]<br />[[Category:Tutorial]] | |||
= | [toc align_right="yes&quot; depth="2&quot;] | ||
'''English''' [[How_to_Create_and_Run_Qt_Application_for_Android_Bulgarian|Български]] | |||
= | = How to Create and Run Qt Application for Android = | ||
* Installed Necessitas | Using "Necessitas&quot;:http://developer.qt.nokia.com/wiki/Necessitas Qt SDK developers can deploy Qt application on Android devices. The following tutorial will show the basics steps to create a simple Qt application for Android. | ||
== Requirements == | |||
* Installed Necessitas SDK | |||
* Android device | * Android device | ||
==Tutorial== | == Tutorial == | ||
# Start Qt Creator from Necessitas Qt | # Start Qt Creator from Necessitas Qt SDK | ||
# Press '''File > New file or project…''' and follow the instructions of the wizard | # Press '''File > New file or project…''' and follow the instructions of the wizard | ||
# Select '''Qt Widget Project''' and '''Qt Gui Application''' | # Select '''Qt Widget Project''' and '''Qt Gui Application''' | ||
Line 20: | Line 24: | ||
# Modify the source code and when ready run the application on the device | # Modify the source code and when ready run the application on the device | ||
===Hints=== | === Hints === | ||
* To modify general information about the application, Android Manifest file, Android Permissions or the list of libraries from Qt Creator go to '''Projects > Run Settings > Package configuration > Details'''. | * To modify general information about the application, Android Manifest file, Android Permissions or the list of libraries from Qt Creator go to '''Projects > Run Settings > Package configuration > Details'''. | ||
* To select Android target | * To select Android target SDK that you want to use from Qt Creator go to '''Projects > Run Settings > Package configuration > Details > Manifest'''. | ||
* To modify deploy configuration of the project from Qt Creator go to '''Projects > Run Settings > Configuration configuration > Details'''. | * To modify deploy configuration of the project from Qt Creator go to '''Projects > Run Settings > Configuration configuration > Details'''. | ||
==Source Code== | == Source Code == | ||
As you can see the source code does not include any specific Android features which makes absolutely portable. Some additional files required by necessitas are added at pro file of the project. | As you can see the source code does not include any specific Android features which makes absolutely portable. Some additional files required by necessitas are added at pro file of the project. | ||
* test.pro | * test.pro | ||
<code>QT ''= core gui | |||
<br />TARGET = test<br />TEMPLATE = app | |||
<br />SOURCES''= main.cpp mainwindow.cpp | |||
HEADERS ''= mainwindow.h | |||
<br />FORMS''= mainwindow.ui | |||
CONFIG ''= mobility<br />MOBILITY = | |||
<br />OTHER_FILES''= android/AndroidManifest.xml android/res/drawable-hdpi/icon.png android/res/drawable-ldpi/icon.png android/res/drawable-mdpi/icon.png android/res/values/libs.xml android/res/values/strings.xml android/src/eu/licentia/necessitas/industrius/QtActivity.java android/src/eu/licentia/necessitas/industrius/QtApplication.java android/src/eu/licentia/necessitas/industrius/QtLayout.java android/src/eu/licentia/necessitas/industrius/QtSurface.java android/src/eu/licentia/necessitas/ministro/IMinistro.aidl android/src/eu/licentia/necessitas/ministro/IMinistroCallback.aidl android/src/eu/licentia/necessitas/mobile/QtAndroidContacts.java android/src/eu/licentia/necessitas/mobile/QtCamera.java android/src/eu/licentia/necessitas/mobile/QtFeedback.java android/src/eu/licentia/necessitas/mobile/QtLocation.java android/src/eu/licentia/necessitas/mobile/QtMediaPlayer.java android/src/eu/licentia/necessitas/mobile/QtSensors.java android/src/eu/licentia/necessitas/mobile/QtSystemInfo.java</code> | |||
* main.cpp | * main.cpp | ||
<code>#include <QtGui/QApplication&gt;<br />#include "mainwindow.h&quot; | |||
int main(int argc, char '''argv[])<br />{<br /> QApplication a(argc, argv);<br /> MainWindow w;<br />#if defined(Q_WS_S60)<br /> w.showMaximized();<br />#else<br /> w.show();<br />#endif | |||
<br /> return a.exec&amp;#40;&#41;;<br />}</code> | |||
<br />''' mainwindow.h | |||
<code>#ifndef MAINWINDOW_H<br />#define MAINWINDOW_H | |||
#include <QMainWindow&gt;<br />#include <QLabel&gt; | |||
namespace Ui {<br /> class MainWindow;<br />} | |||
class MainWindow : public QMainWindow<br />{<br /> Q_OBJECT | |||
public:<br /> explicit MainWindow(QWidget '''parent = 0);<br /> ~MainWindow(); | |||
<br />private: | |||
<br /> // from QMainWindow<br /> void resizeEvent(QResizeEvent''' event); | |||
private: | |||
QLabel* m_pLabel;<br />}; | |||
#endif // MAINWINDOW_H</code> | |||
* mainwindow.cpp | * mainwindow.cpp | ||
<code>#include "mainwindow.h&quot; | |||
#include <QApplication&gt;<br />#include <QDesktopWidget&gt;<br />#include <QtCore/QCoreApplication&gt; | |||
MainWindow::MainWindow(QWidget '''parent) :<br /> QMainWindow(parent),<br /> m_pLabel(NULL)<br />{<br /> m_pLabel = new QLabel("Hello Qt for Android!", this);<br /> m_pLabel->setGeometry(QApplication::desktop()<s>>screenGeometry());<br /> m_pLabel</s>>setAlignment(Qt::AlignCenter);<br /> m_pLabel->setStyleSheet("background-color:#006600; color:#FFFFFF&quot;);<br />} | |||
<br />MainWindow::~MainWindow()<br />{ | |||
<br />} | |||
<br />void MainWindow::resizeEvent(QResizeEvent''' /*event*/)<br />{<br /> m_pLabel->setGeometry(QApplication::desktop()->screenGeometry());<br />}</code> | |||
== Testing == | |||
Connect your device to the computer and run the application from Necessitas Qt SDK Qt Creator. The Qt application will automatically start on the Android device. You might be prompted to download dependencies using Ministro. Follow the instruction to install all required components. | |||
This example application has been successfully tested on "LG GT540 Optimus&quot;:http://www.gsmarena.com/lg_gt540_optimus-3081.php with Android 2.1. | |||
== | == See Also == | ||
"How to use Necessitas 0.2.1 Emulator on Windows 7&quot;:http://developer.qt.nokia.com/wiki/How_to_use_Necessitas_Emulator_on_Windows_7<br />"How to write Qt apps for Android&quot;:http://sourceforge.net/p/necessitas/wiki/How to write Qt apps for Android/<br />"Setup QtCreator&quot;:http://sourceforge.net/p/necessitas/wiki/Setup QtCreator/ | |||
Revision as of 14:12, 23 February 2015
[toc align_right="yes" depth="2"]
English Български
How to Create and Run Qt Application for Android
Using "Necessitas":http://developer.qt.nokia.com/wiki/Necessitas Qt SDK developers can deploy Qt application on Android devices. The following tutorial will show the basics steps to create a simple Qt application for Android.
Requirements
- Installed Necessitas SDK
- Android device
Tutorial
- Start Qt Creator from Necessitas Qt SDK
- Press File > New file or project… and follow the instructions of the wizard
- Select Qt Widget Project and Qt Gui Application
- Enter project name and path to its directory
- Select Android as a Target
- When the project is created open the Projects view and verify the configurations for Build and Run settings
- Modify the source code and when ready run the application on the device
Hints
- To modify general information about the application, Android Manifest file, Android Permissions or the list of libraries from Qt Creator go to Projects > Run Settings > Package configuration > Details.
- To select Android target SDK that you want to use from Qt Creator go to Projects > Run Settings > Package configuration > Details > Manifest.
- To modify deploy configuration of the project from Qt Creator go to Projects > Run Settings > Configuration configuration > Details.
Source Code
As you can see the source code does not include any specific Android features which makes absolutely portable. Some additional files required by necessitas are added at pro file of the project.
- test.pro
QT ''= core gui
<br />TARGET = test<br />TEMPLATE = app
<br />SOURCES''= main.cpp mainwindow.cpp
HEADERS ''= mainwindow.h
<br />FORMS''= mainwindow.ui
CONFIG ''= mobility<br />MOBILITY =
<br />OTHER_FILES''= android/AndroidManifest.xml android/res/drawable-hdpi/icon.png android/res/drawable-ldpi/icon.png android/res/drawable-mdpi/icon.png android/res/values/libs.xml android/res/values/strings.xml android/src/eu/licentia/necessitas/industrius/QtActivity.java android/src/eu/licentia/necessitas/industrius/QtApplication.java android/src/eu/licentia/necessitas/industrius/QtLayout.java android/src/eu/licentia/necessitas/industrius/QtSurface.java android/src/eu/licentia/necessitas/ministro/IMinistro.aidl android/src/eu/licentia/necessitas/ministro/IMinistroCallback.aidl android/src/eu/licentia/necessitas/mobile/QtAndroidContacts.java android/src/eu/licentia/necessitas/mobile/QtCamera.java android/src/eu/licentia/necessitas/mobile/QtFeedback.java android/src/eu/licentia/necessitas/mobile/QtLocation.java android/src/eu/licentia/necessitas/mobile/QtMediaPlayer.java android/src/eu/licentia/necessitas/mobile/QtSensors.java android/src/eu/licentia/necessitas/mobile/QtSystemInfo.java
- main.cpp
#include <QtGui/QApplication&gt;<br />#include "mainwindow.h&quot;
int main(int argc, char '''argv[])<br />{<br /> QApplication a(argc, argv);<br /> MainWindow w;<br />#if defined(Q_WS_S60)<br /> w.showMaximized();<br />#else<br /> w.show();<br />#endif
<br /> return a.exec&amp;#40;&#41;;<br />}
mainwindow.h
#ifndef MAINWINDOW_H<br />#define MAINWINDOW_H
#include <QMainWindow&gt;<br />#include <QLabel&gt;
namespace Ui {<br /> class MainWindow;<br />}
class MainWindow : public QMainWindow<br />{<br /> Q_OBJECT
public:<br /> explicit MainWindow(QWidget '''parent = 0);<br /> ~MainWindow();
<br />private:
<br /> // from QMainWindow<br /> void resizeEvent(QResizeEvent''' event);
private:
QLabel* m_pLabel;<br />};
#endif // MAINWINDOW_H
- mainwindow.cpp
#include "mainwindow.h&quot;
#include <QApplication&gt;<br />#include <QDesktopWidget&gt;<br />#include <QtCore/QCoreApplication&gt;
MainWindow::MainWindow(QWidget '''parent) :<br /> QMainWindow(parent),<br /> m_pLabel(NULL)<br />{<br /> m_pLabel = new QLabel("Hello Qt for Android!", this);<br /> m_pLabel->setGeometry(QApplication::desktop()<s>>screenGeometry());<br /> m_pLabel</s>>setAlignment(Qt::AlignCenter);<br /> m_pLabel->setStyleSheet("background-color:#006600; color:#FFFFFF&quot;);<br />}
<br />MainWindow::~MainWindow()<br />{
<br />}
<br />void MainWindow::resizeEvent(QResizeEvent''' /*event*/)<br />{<br /> m_pLabel->setGeometry(QApplication::desktop()->screenGeometry());<br />}
Testing
Connect your device to the computer and run the application from Necessitas Qt SDK Qt Creator. The Qt application will automatically start on the Android device. You might be prompted to download dependencies using Ministro. Follow the instruction to install all required components.
This example application has been successfully tested on "LG GT540 Optimus":http://www.gsmarena.com/lg_gt540_optimus-3081.php with Android 2.1.
See Also
"How to use Necessitas 0.2.1 Emulator on Windows 7":http://developer.qt.nokia.com/wiki/How_to_use_Necessitas_Emulator_on_Windows_7
"How to write Qt apps for Android":http://sourceforge.net/p/necessitas/wiki/How to write Qt apps for Android/
"Setup QtCreator":http://sourceforge.net/p/necessitas/wiki/Setup QtCreator/