×
Namespaces

Variants
Actions
(Difference between revisions)

Creating Debian packages for Maemo 5 Qt applications and showing in the application menu

From Nokia Developer Wiki
Jump to: navigation, search
divanov (Talk | contribs)
lpvalente (Talk | contribs)
m (Lpvalente -)
 
(19 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{FeaturedArticle}}
+
[[Category:Maemo]][[Category:Qt]][[Category:Code Examples]][[Category:MeeGo Harmattan]][[Category:Symbian]]
{{ReviewerApproved}}
+
{{Archived|timestamp=20130223192105|user=[[User:Lpvalente|Lpvalente]]}}
  
[[Category:Maemo]][[Category:Qt]][[Category:Qt for Maemo]][[Category:How To]]
 
  
===Introduction===
+
{{Abstract|This article shows how to build a '''.deb''' package for a [[:Category:Qt|Qt]] application on Maemo.  Note that the Qt SDK produces Debian package for you, so this is not mandatory to read and follow this article.}} The other problem that this article will address is how to put the Qt application at  '''Menu of Maemo Device'''. The proposed strategy does not use dh_make to create the basic debian package structure, as described in [[Qt for Maemo Developers Guide]].
  
In this article, I will present how to build a '''.deb''' package . This is a usual implementation, but the difference is the '''[[::Category:Qt for Maemo|Qt for Maemo]]''' application. The other problem that this article will address is how  to put the Qt application at  '''Menu of Maemo Device'''. The proposed strategy does not use dh_make to create the basic debian package structure, as described in [[Qt_for_Maemo_Developers_Guide|Qt for Maemo Developers Guide]].
+
{{ArticleMetaData <!-- v1.2 -->
 +
|sourcecode= [[Media:Sample-0.0.1.zip]]
 +
|installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) -->
 +
|devices= <!-- Devices tested against - e.g. ''devices=Nokia 6131 NFC, Nokia C7-00'') -->
 +
|sdk= <!-- SDK(s) built and tested against (e.g. [http://linktosdkdownload/ Nokia Qt SDK 1.1]) -->
 +
|platform= <!-- Compatible platforms - e.g. Symbian^1 and later, Qt 4.6 and later -->
 +
|devicecompatability= <!-- Compatible devices e.g.: All* (must have internal GPS) -->
 +
|dependencies= <!-- Any other/external dependencies e.g.: Google Maps Api v1.0 -->
 +
|signing= <!-- Signing requirements - empty or one of: Self-Signed, DevCert, Manufacturer -->
 +
|capabilities= <!-- Capabilities required by the article/code example (e.g. Location, NetworkServices. -->
 +
|keywords= <!-- APIs, classes and methods (e.g. QSystemScreenSaver, QList, CBase -->
 +
|language= <!-- Language category code for non-English topics - e.g. Lang-Chinese -->
 +
|translated-by= <!-- [[User:XXXX]] -->
 +
|translated-from-title= <!-- Title only -->
 +
|translated-from-id= <!-- Id of translated revision -->
 +
|review-by= <!-- After re-review: [[User:username]] -->
 +
|review-timestamp= <!-- After re-review: YYYYMMDD -->
 +
|update-by= <!-- After significant update: [[User:username]]-->
 +
|update-timestamp= <!-- After significant update: YYYYMMDD -->
 +
|creationdate= 20090925
 +
|author= [[User:Flaviofabricioferreira]]
 +
}}
  
[[File:helloworldmaemo5qt_4.png|500x300px]]
+
[[File:helloworldmaemo5qt 4.png|500x300px]]
  
===.Deb Packages In Brief===
+
===Debian Packages In Brief===
  
'''Deb''' is the extension of the Debian software package format and the most often used name for such binary packages. Like the '''Deb''' part of the term Debian. '''Debian''' packages are used in distributions based on '''Debian''', such as '''Ubuntu''' and others.
+
'''.deb''' is the extension of the Debian software package format and the most often used name for such binary packages. Like the '''Deb''' part of the term Debian. '''Debian''' packages are used in distributions based on '''Debian''', such as '''Ubuntu''' and others.
  
 
=== Prerequisites ===
 
=== Prerequisites ===
  
You need to have '''libqt4-dev''' ,'''ScratchBox''' and '''Maemo SDK'''  installed on your Computer and '''libqt4-dev''' installed on your '''Scratchbox ARM''' target and your '''Maemo Device''' . For more information on '''ScratchBox''' Installation click [http://www.scratchbox.org/ here] and for '''Qt''' on '''Maemo''' click [http://qt4.garage.maemo.org/diablo.html here].
+
You need to have '''libqt4-dev''' and '''Maemo 5 SDK'''  installed on your Computer and '''libqt4-dev''' installed on your '''Scratchbox ARM''' target. For more information on '''Maemo 5 SDK''' Installation follow [http://www.developer.nokia.com/Resources/Tools_and_downloads/Other/Maemo/ the link].
  
 
===Creating the Application===
 
===Creating the Application===
  
[[File:helloworldmaemo5qt_1.png|500x300px]]
+
[[File:helloworldmaemo5qt 1.png|500x300px]]
  
 
You need to create a simple '''Qt HelloWorld'''  Project on computer. I created a project with two labels how is showed below. Remember of to set the size of QWidget to 720 of Width and 420 of Height because the resolution of Maemo Device.
 
You need to create a simple '''Qt HelloWorld'''  Project on computer. I created a project with two labels how is showed below. Remember of to set the size of QWidget to 720 of Width and 420 of Height because the resolution of Maemo Device.
Line 26: Line 46:
 
===Copying the Application to Scratchbox===
 
===Copying the Application to Scratchbox===
  
First , copy the sources files of application to a folder at '''Scratchbox'''. In general the address is '''/scratchbox/users/username/home/username/'''. I do this:
+
First, copy the sources files of application to a folder at '''Scratchbox'''. In general the address is '''/scratchbox/users/username/home/username/'''. I do this:
  
  flavio@flavio-desktop:~/workspace$ cp -r HelloWorld/ /scratchbox/users/${USER}/home/${USER}/
+
  flavio@flavio-desktop:~/workspace$ cp -r HelloWorld/ /scratchbox/users/${USER}/home/${USER}/
  
 
===Compiling the Application at Scratchbox===
 
===Compiling the Application at Scratchbox===
Line 45: Line 65:
  
 
The method of creation Debian packages is described in an external article [http://wiki.maemo.org/Packaging_a_Qt_application Packaging a Qt application]. Maemo is derivative of Debian Linux distribution,
 
The method of creation Debian packages is described in an external article [http://wiki.maemo.org/Packaging_a_Qt_application Packaging a Qt application]. Maemo is derivative of Debian Linux distribution,
thus, should you have a question, feel free to consult Debian documentation [http://www.debian.org/doc/maint-guide/ Debian New Maintainer's Guide].
+
thus, should you have a question, feel free to consult Debian documentation [http://www.debian.org/doc/manuals/maint-guide/ Debian New Maintainer's Guide].
 +
 
 +
Sample source Debian package containing a very simple Qt application [[File:Sample-0.0.1.zip]].
  
 
===Building the Debian Package===
 
===Building the Debian Package===
  
 
To build both source and binary packages with checking build dependencies use the following command
 
To build both source and binary packages with checking build dependencies use the following command
[CODE]
+
<code>
 
[sbox-FREMANTLE_ARMEL: ~/HelloWorld] > dpkg-buildpackage -i -rfakeroot -D
 
[sbox-FREMANTLE_ARMEL: ~/HelloWorld] > dpkg-buildpackage -i -rfakeroot -D
[/CODE]
+
</code>
 
Append "-nc -b" keys to avoid cleaning the source tree. This will speed up building a binary package. This is relevant for huge packages like Qt libraries, which are being built for several hours.
 
Append "-nc -b" keys to avoid cleaning the source tree. This will speed up building a binary package. This is relevant for huge packages like Qt libraries, which are being built for several hours.
  
===Sending the .Deb Package to Maemo Device===
+
===Sending the Debian Package to Maemo Device===
  
I used the '''scp''' command with the '''IP''' address of device. The '''IP''' address of device is searched at '''Settings->Connection Manager''' , after that , click at Connection Manager at '''left-Up-Corner->internet connection->IP address'''.
+
I used the '''scp''' command with the '''IP''' address of device. The '''IP''' address of device is searched at '''Settings->Connection Manager''' , after that, click at Connection Manager at '''left-Up-Corner->internet connection->IP address'''.
  
 
  [sbox-FREMANTLE_ARMEL: ~/HelloWorld] > scp hello-world-application.deb root@10.0.0.13:/home/user/
 
  [sbox-FREMANTLE_ARMEL: ~/HelloWorld] > scp hello-world-application.deb root@10.0.0.13:/home/user/
  
===Installing the Deb Package at Maemo Device===
+
===Installing the Debian Package at Maemo Device===
  
 
  [sbox-FREMANTLE_ARMEL: ~/HelloWorld] > ssh root@10.0.0.13 dpkg -i /home/user/hello-world-application.deb
 
  [sbox-FREMANTLE_ARMEL: ~/HelloWorld] > ssh root@10.0.0.13 dpkg -i /home/user/hello-world-application.deb
Line 77: Line 99:
 
===Snapshoot of HelloWorld Application===
 
===Snapshoot of HelloWorld Application===
  
[[File:helloworldmaemo5qt_5.png||500x300px]]
+
[[File:helloworldmaemo5qt 5.png||500x300px]]
 
+
<!-- Translation --> [[pt:Como criar Pacotes Debian para aplicações em Qt para Maemo 5 e mostrá-la no Menu]]
This post is avaiable too at [http://efforts.embedded.ufcg.edu.br/qt/ QtEfforts ] of the [http://efforts.embedded.ufcg.edu.br Efforts Projects] in the [http://embedded.ufcg.edu.br/indexen.html Embedded Systems and Pervasive Computing Laboratory].
+

Latest revision as of 22:21, 23 February 2013

Archived.pngArchived: This article is archived because it is not considered relevant for third-party developers creating commercial solutions today. If you think this article is still relevant, let us know by adding the template {{ReviewForRemovalFromArchive|user=~~~~|write your reason here}}.

The article is believed to be still valid for the original topic scope.


This article shows how to build a .deb package for a Qt application on Maemo. Note that the Qt SDK produces Debian package for you, so this is not mandatory to read and follow this article. The other problem that this article will address is how to put the Qt application at Menu of Maemo Device. The proposed strategy does not use dh_make to create the basic debian package structure, as described in Qt for Maemo Developers Guide.

Article Metadata
Code ExampleCompatibility
Platform(s):
Symbian
Article
Created: flaviofabricioferreira (25 Sep 2009)
Last edited: lpvalente (23 Feb 2013)

Helloworldmaemo5qt 4.png

Contents

[edit] Debian Packages In Brief

.deb is the extension of the Debian software package format and the most often used name for such binary packages. Like the Deb part of the term Debian. Debian packages are used in distributions based on Debian, such as Ubuntu and others.

[edit] Prerequisites

You need to have libqt4-dev and Maemo 5 SDK installed on your Computer and libqt4-dev installed on your Scratchbox ARM target. For more information on Maemo 5 SDK Installation follow the link.

[edit] Creating the Application

Helloworldmaemo5qt 1.png

You need to create a simple Qt HelloWorld Project on computer. I created a project with two labels how is showed below. Remember of to set the size of QWidget to 720 of Width and 420 of Height because the resolution of Maemo Device.

[edit] Copying the Application to Scratchbox

First, copy the sources files of application to a folder at Scratchbox. In general the address is /scratchbox/users/username/home/username/. I do this:

flavio@flavio-desktop:~/workspace$ cp -r HelloWorld/ /scratchbox/users/${USER}/home/${USER}/

[edit] Compiling the Application at Scratchbox

At Start, you need login at Scratchbox:

~$ /scratchbox/login

If necessary select the ARM target using sb-conf se FREMANTLE_ARMEL . To compile do this :

[sbox-FREMANTLE_ARMEL: ~] > cd HelloWorld
[sbox-FREMANTLE_ARMEL: ~/HelloWorld] > qmake
[sbox-FREMANTLE_ARMEL: ~/HelloWorld] > make

[edit] Creating the Debian Source Package

The method of creation Debian packages is described in an external article Packaging a Qt application. Maemo is derivative of Debian Linux distribution, thus, should you have a question, feel free to consult Debian documentation Debian New Maintainer's Guide.

Sample source Debian package containing a very simple Qt application File:Sample-0.0.1.zip.

[edit] Building the Debian Package

To build both source and binary packages with checking build dependencies use the following command

[sbox-FREMANTLE_ARMEL: ~/HelloWorld] > dpkg-buildpackage -i -rfakeroot -D

Append "-nc -b" keys to avoid cleaning the source tree. This will speed up building a binary package. This is relevant for huge packages like Qt libraries, which are being built for several hours.

[edit] Sending the Debian Package to Maemo Device

I used the scp command with the IP address of device. The IP address of device is searched at Settings->Connection Manager , after that, click at Connection Manager at left-Up-Corner->internet connection->IP address.

[sbox-FREMANTLE_ARMEL: ~/HelloWorld] > scp hello-world-application.deb root@10.0.0.13:/home/user/

[edit] Installing the Debian Package at Maemo Device

[sbox-FREMANTLE_ARMEL: ~/HelloWorld] > ssh root@10.0.0.13 dpkg -i /home/user/hello-world-application.deb

Now, the application is installed at Maemo Device.

You will need to click at More... Menu and you will can see the HelloWorld Application with a icon of N900 :

[edit] Snapshoot of HelloWorld Application

Helloworldmaemo5qt 5.png

This page was last modified on 23 February 2013, at 22:21.
263 page views in the last 30 days.
×