Packaging a Qt application
Line 61: Line 61:
* Rules - A makefile containing the rules to build all kinds of packages  
* Rules - A makefile containing the rules to build all kinds of packages  
 +
== Maemo Packaging Policy ==
 +
Maemo packages follow the Debian Policy, but there are some items where Maemo:
 +
* Is more strict (it is an embedded distribution)
 +
* Is more relaxed
 +
**Only a target device (Nokia Internet Tablet)
 +
**Only a specified UI (Hildon)
 +
**Only one user.
 +
*Differs from Debian because Maemo has different:
 +
**Objectives
 +
**Maintainers
 +
**Infrastructure
 +
== Editing the rules file ==
 +
The rules file generated by dh_make will be modified in order to look like this one.
 +
We are using qmake, so we haven't a configure file to run.
 +
<pre>
 +
#!/usr/bin/make -f
 +
APPNAME := my_app_name
 +
builddir:
 +
        mkdir -p builddir
 +
 +
builddir/Makefile: builddir
 +
        cd builddir && qmake-qt4 PREFIX=/usr ../$(APPNAME).pro
 +
 +
build: build-stamp
 +
 +
build-stamp: builddir/Makefile
 +
        dh_testdir
 +
        # Add here commands to compile the package.
 +
        cd builddir && $(MAKE)
 +
        touch $@
 +
 +
clean:
 +
        dh_testdir
 +
        dh_testroot
 +
        rm -f build-stamp
 +
        # Add here commands to clean up after the build process.
 +
        rm -rf builddir
 +
        dh_clean
 +
install: build
 +
        dh_testdir
 +
        dh_testroot
 +
        dh_clean -k
 +
        dh_installdirs
 +
 +
        # Add here commands to install the package into debian/your_appname
 +
        cd builddir && $(MAKE) INSTALL_ROOT=$(CURDIR)/debian/$(APPNAME) install
 +
# Build architecture-independent files here.
 +
binary-indep: build install
 +
# We have nothing to do by default.
 +
 +
# Build architecture-dependent files here.
 +
binary-arch: build install
 +
        dh_testdir
 +
        dh_testroot
 +
        dh_installdocs
 +
        dh_installexamples
 +
        dh_installman
 +
        dh_link
 +
        dh_strip
 +
        dh_compress
 +
        dh_fixperms
 +
        dh_installdeb
 +
        dh_shlibdeps
 +
        dh_gencontrol
 +
        dh_md5sums
 +
        dh_builddeb
 +
 +
binary: binary-indep binary-arch
 +
.PHONY: build clean binary-indep binary-arch binary install configure
 +
</pre>
= Useful Links =
= Useful Links =
[http://qt4.garage.maemo.org Qt4Maemo at garage]
[http://qt4.garage.maemo.org Qt4Maemo at garage]

Revision as of 14:44, 17 September 2008

Contents

Packaging a Qt Application

Looking for a debian package of your Application

If you want to port a popular Qt application probably it is already packaged for debian. You can try to get the package source in a couple of different ways:

  • Adding a debian src repository in your /etc/apt/source.list file 
$echo “deb http://ftp.it.debian.org/debian/ unstable main contrib non-free” >> /etc/apt/source.list
$apt-get update
$apt-cache search app_name
$apt-get source app_name
  • Checking http://packages.debian.org, downloading the following files and running dpkg-source -x app_name.dsc to decompress the upstream source and to apply the changes available in the diff.gz file.
    • upstream source file (.tar.gz)
    • package changes (.diff.gz)
    • meta-data information file (.dsc)

Creating a Debian package for a new Qt Application

If your application has been already packaged, you can jump this section. If your application is quite younger and you need to package it by yourself, in order to creating a new package, you need to:

  • Rename the upstream source directory in Package-Version (eg: myapp-0.1)
  • Create “src” directory in Package-Version/
  • Copy all the files in the src/
  • Rename src/appname.pro in src/src.pro 
$mv myapp myapp-0.1
$cd myapp-0.1
$mkdir src
$cp * src
$mv src/appname.pro src/src.pro
  • Create a myapp-0.1/myapp.pro file like this: 
QMAKEVERSION = $$[QMAKE_VERSION]
ISQT4 = $$find(QMAKEVERSION, ^[2-9])
isEmpty( ISQT4 ) {
error("Use the qmake include with Qt4.4 or greater, on Debian that is qmake-qt4");
}

TEMPLATE = subdirs
SUBDIRS  = src
  • Run dh_make to debianize the source archive, it creates:
    • An archive with the unchanged upstream source (orig.tar.gz)
    • Some basic files in the debian directory
    • Some example files (*.EX *.ex) 
dh_make --createorig --single -e maintainer@email.org -c gpl

Having a look inside the debian/ dir

At this point the directory my-app contains

  • the source directory ( src/ )
  • the debian directory (debian/)

Inside the debian dir we have the files need for the creation of the debian package

  • Changelog - Application's change log
  • Compat - Debian helper compatibly version
  • Control - Describes the packages to be made
  • Copyright - Copyright text
  • Rules - A makefile containing the rules to build all kinds of packages

Maemo Packaging Policy

Maemo packages follow the Debian Policy, but there are some items where Maemo:

  • Is more strict (it is an embedded distribution)
  • Is more relaxed
    • Only a target device (Nokia Internet Tablet)
    • Only a specified UI (Hildon)
    • Only one user.
  • Differs from Debian because Maemo has different:
    • Objectives
    • Maintainers
    • Infrastructure

Editing the rules file

The rules file generated by dh_make will be modified in order to look like this one. We are using qmake, so we haven't a configure file to run. 

#!/usr/bin/make -f
APPNAME := my_app_name
builddir:
        mkdir -p builddir

builddir/Makefile: builddir
        cd builddir && qmake-qt4 PREFIX=/usr ../$(APPNAME).pro

build: build-stamp

build-stamp: builddir/Makefile
        dh_testdir
        # Add here commands to compile the package.
        cd builddir && $(MAKE)
        touch $@

clean:
        dh_testdir
        dh_testroot
        rm -f build-stamp
        # Add here commands to clean up after the build process.
        rm -rf builddir
        dh_clean
install: build
        dh_testdir
        dh_testroot
        dh_clean -k
        dh_installdirs

        # Add here commands to install the package into debian/your_appname
        cd builddir && $(MAKE) INSTALL_ROOT=$(CURDIR)/debian/$(APPNAME) install
# Build architecture-independent files here.
binary-indep: build install
# We have nothing to do by default.

# Build architecture-dependent files here.
binary-arch: build install
        dh_testdir
        dh_testroot
        dh_installdocs
        dh_installexamples
        dh_installman
        dh_link
        dh_strip
        dh_compress
        dh_fixperms
        dh_installdeb
        dh_shlibdeps
        dh_gencontrol
        dh_md5sums
        dh_builddeb

binary: binary-indep binary-arch
.PHONY: build clean binary-indep binary-arch binary install configure

Useful Links

Qt4Maemo at garage

Official Qt 4.4 Documentation

Retrieved from "https://wiki.maemo.org/Packaging_a_Qt_application"