prev next Z

Cross-Compiling Qtopia Applications for Zaurus


Packaging Zaurus applications for distribution

Once your application has been tested and cross-compiled, it needs to be packaged into an .ipk file. The iPKG format is simply a gzipped tar archive containing three files:

For example:
tar tzvf zddice_1.0.0_arm.ipk
-rw-rw-r-- root/root   343 2004-04-18 21:06:25 ./control.tar.gz
-rw-rw-r-- root/root 32749 2004-04-18 21:06:27 ./data.tar.gz
-rw-rw-r-- root/root     4 2004-04-18 21:00:52 ./debian-binary

tar tzvf control.tar.gz
-rw-rw-r-- root/root   289 2004-04-18 21:01:30 ./control                                 (Meta Data Control File)

tar tzvf data.tar.gz
drwxr-xr-x root/root     0 2004-04-18 21:00:52 ./opt/
drwxr-xr-x root/root     0 2004-04-18 21:00:52 ./opt/QtPalmtop/
drwxr-xr-x root/root     0 2004-04-18 21:05:52 ./opt/QtPalmtop/bin/
-rwxrwxr-x root/root 80894 2004-04-18 21:01:02 ./opt/QtPalmtop/bin/zddice                (Application Binary)
drwxr-xr-x root/root     0 2004-04-18 21:05:41 ./opt/QtPalmtop/apps/
drwxr-xr-x root/root     0 2004-04-18 21:05:46 ./opt/QtPalmtop/apps/Games/
-rw-rw-r-- root/root   103 2004-04-18 21:05:17 ./opt/QtPalmtop/apps/Games/zddice.desktop (Qt Desktop Config File)
drwxr-xr-x root/root     0 2004-04-18 21:06:03 ./opt/QtPalmtop/pics/
-rw-rw-r-- root/root  2511 2004-04-18 21:01:18 ./opt/QtPalmtop/pics/zddice.png           (Application Icon)

cat ./control
Package: zddice
Installed-Size: 83508
Filename: ./zddice_1.0.0_arm.ipk
Architecture: arm
Arch: SHARP
Version: 1.0.0
Priority: optional                                 (required,standard,important,optional,extra)
Section: qpe/games                                 (qpe/applications,qpe/games,qpe/jeode,qpe/settings)
Maintainer: David Brown <doc.brown@eds.com>
License: GPL
Description: Zaurus D20 Gaming Dice
 Roll them bones! No keyboard required!

cat ./opt/QtPalmtop/apps/Games/zddice.desktop
[Desktop Entry]
Comment=Zaurus D20 Gaming Dice
Exec=zddice                                        (Expects a zddice binary in /opt/QtPalmtop/bin)
Icon=zddice                                        (Expects a zddice.png file in /opt/QtPalmtop/pics)
Type=Application
Name=zD20 Dice                                     (Text appears under the icon on the Games tab)

It is simple enough to setup a directory containing the necessary files and to create the data and control tar files, and then create your .ipk file manually. For more information on the IPKG format or the ipkg-build.sh script, visit docs.zaurus.com.

Slide 4 of 4