×
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
flaviofabricioferreira (Talk | contribs)
divanov (Talk | contribs)
Line 42: Line 42:
 
  [sbox-FREMANTLE_ARMEL: ~/HelloWorld] > make
 
  [sbox-FREMANTLE_ARMEL: ~/HelloWorld] > make
  
===Creating the Tree of Debian Package===
+
===Creating the Debian Source Package===
  
This is the method thats i preferred but exists other methods to create .deb packages like this([http://wiki.maemo.org/Packaging_a_Qt_application Maemo.org]).
+
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].
  
After that , you need to create the following folders:
+
===Building the Debian Package===
  
[sbox-FREMANTLE_ARMEL: ~/HelloWorld] cd ..
+
To build both source and binary packages with checking build dependencies use the following command
[sbox-FREMANTLE_ARMEL: ~] > mkdir HelloWorldApplication
+
[CODE]
[sbox-FREMANTLE_ARMEL: ~] > mkdir HelloWorldApplication/DEBIAN
+
[sbox-FREMANTLE_ARMEL: ~/HelloWorld] > dpkg-buildpackage -i -rfakeroot -D
 
+
[/CODE]
You'll need to create a control file for your package using a simple text edit. In this post I use the '''Vi'''.
+
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.
 
+
[sbox-FREMANTLE_ARMEL: ~] > vi  HelloWorldApplication/DEBIAN/control
+
 
+
In this step we'll look at what each field in the control file means and what kind of information you need to provide.
+
The syntax for the control fields is very simple: the name of the field, followed by a colon, and then the body or value of the field.
+
 
+
Package: HelloWorld
+
Priority: optional
+
Version: 1.0
+
Architecture: all
+
Maintainer: Flavio Fabricio <flaviofabricio@gmail.com>
+
Depends: libqt4-dev
+
Description: This is a HelloWorld Application
+
 
+
Returns to '''HelloWorld''' Application directory and create the folders below:
+
 
+
[sbox-FREMANTLE_ARMEL: ~] > cd  HelloWorldApplication/
+
[sbox-FREMANTLE_ARMEL: ~/HelloWorldApplication] > mkdir usr
+
 
+
Creating the /usr subdirectories:
+
 
+
[sbox-FREMANTLE_ARMEL: ~/HelloWorldApplication] > cd usr/
+
[sbox-FREMANTLE_ARMEL: ~/HelloWorldApplication/usr] > mkdir bin
+
[sbox-FREMANTLE_ARMEL: ~/HelloWorldApplication/usr] > mkdir lib
+
[sbox-FREMANTLE_ARMEL: ~/HelloWorldApplication/usr] > mkdir share
+
 
+
Creating the /share subdirectories:
+
 
+
[sbox-FREMANTLE_ARMEL: ~/HelloWorldApplication/usr] > cd share/
+
[sbox-FREMANTLE_ARMEL: ~/HelloWorldApplication/usr/share] > mkdir applications
+
[sbox-FREMANTLE_ARMEL: ~/HelloWorldApplication/usr/share] > mkdir pixmaps
+
 
+
Creating the '''hildon''' subdirectory that is the folder where is the '''.desktop''' files :
+
 
+
[sbox-FREMANTLE_ARMEL: ~/HelloWorldApplication/usr/share] > cd applications
+
[sbox-FREMANTLE_ARMEL: ~/HelloWorldApplication/usr/share/applications] > mkdir hildon
+
 
+
===Creating the file thats put the Application on Maemo Menu===
+
 
+
You'll need to create too, a .desktop file that the '''Maemo''' uses to put application at Menu.
+
 
+
[sbox-FREMANTLE_ARMEL: cd /HelloWorldApplication/usr/share/applications/hildon
+
[sbox-FREMANTLE_ARMEL: ~/HelloWorldApplication/usr/share/applications/hildon]>vi helloworld.desktop
+
 
+
Here we'll to add the address of executable file , image icon file , etc...
+
 
+
[Desktop Entry]
+
Categories=Qt;
+
Encoding=UTF-8
+
Version=0.1
+
Type=Application
+
Name=HelloWorld
+
Exec=/usr/bin/HelloWorld
+
Icon=helloworld
+
 
+
===Copying the Application Compiled  to Deb Tree===
+
 
+
[sbox-FREMANTLE_ARMEL: ~] > cd HelloWorld
+
[sbox-FREMANTLE_ARMEL: ~/HelloWorld] > ls
+
HelloWorld    helloworld.cpp  main.cpp      helloworld.png 
+
HelloWorld.pro helloworld.h    helloworld.ui  ui_helloworld.h
+
 
+
In this step, you will to copy the executable file to /usr/bin folder. This executable is called by helloworld.desktop at line '''Exec=/usr/bin/HelloWorld''' on the file described above.
+
+
[sbox-FREMANTLE_ARMEL: ~/HelloWorld] > cp helloworld ../HelloWorldApplication/usr/bin/
+
 
+
Now, you will to copy the sources files to /usr/lib folder.This is recommended , but not required.  
+
 
+
[sbox-FREMANTLE_ARMEL: ~/HelloWorld] > cp HelloWorld.pro ../HelloWorldApplication/usr/lib/
+
[sbox-FREMANTLE_ARMEL: ~/HelloWorld] > cp helloworld.cpp ../HelloWorldApplication/usr/lib/
+
[sbox-FREMANTLE_ARMEL: ~/HelloWorld] > cp helloworld.h ../HelloWorldApplication/usr/lib/
+
[sbox-FREMANTLE_ARMEL: ~/HelloWorld] > cp helloworld.ui ../HelloWorldApplication/usr/lib/
+
[sbox-FREMANTLE_ARMEL: ~/HelloWorld] > cp main.cpp ../HelloWorldApplication/usr/lib/
+
 
+
You will need a picture to use like Icon. You can search some image at the [http://images.google.com/ Google Images].In this case I renamed the picture to '''helloworld.png'''.This image is called by '''helloworld.desktop''' at line '''Icon=helloworld''' on the file described above and save to '''/usr/share/pixmaps/''' folder.
+
 
+
[sbox-FREMANTLE_ARMEL: ~/HelloWorld] > cp helloworld.png ../HelloWorldApplication/usr/share/pixmaps/
+
 
+
===Creating the Deb Package===
+
 
+
[sbox-FREMANTLE_ARMEL: ~/HelloWorld] > cd ..
+
[sbox-FREMANTLE_ARMEL: ~] > dpkg-deb -b HelloWorldApplication
+
  
 
===Sending the .Deb Package to Maemo Device===
 
===Sending the .Deb Package to Maemo Device===

Revision as of 10:24, 21 April 2010

Featured Article
{{{width}}}

Contents

Introduction

In this article, I will present how to build a .deb package . This is a usual implementation, but the difference is the 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.

Helloworldmaemo5qt 4.png

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

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 here and for Qt on Maemo click here.

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.

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}/

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

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.

Building the Debian Package

To build both source and binary packages with checking build dependencies use the following command [CODE] [sbox-FREMANTLE_ARMEL: ~/HelloWorld] > dpkg-buildpackage -i -rfakeroot -D [/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.

Sending the .Deb 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/

Installing the Deb 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 :

Snapshoot of HelloWorld Application

Helloworldmaemo5qt 5.png

This post is avaiable too at QtEfforts of the Efforts Projects in the Embedded Systems and Pervasive Computing Laboratory.

177 page views in the last 30 days.
×