summaryrefslogtreecommitdiff
path: root/README
authormickeyl <mickeyl>2003-12-09 23:11:46 (UTC)
committer mickeyl <mickeyl>2003-12-09 23:11:46 (UTC)
commita18b79ad644cfc1a48a87b7d0d06266737d21cbf (patch) (unidiff)
tree44d9e2449048ee3978d575fba22059cca77f497a /README
parentb2dc1cd012f2426b3ffa5b29879cf1760cfbc2e6 (diff)
downloadopie-a18b79ad644cfc1a48a87b7d0d06266737d21cbf.zip
opie-a18b79ad644cfc1a48a87b7d0d06266737d21cbf.tar.gz
opie-a18b79ad644cfc1a48a87b7d0d06266737d21cbf.tar.bz2
improve wording and correct facts
Diffstat (limited to 'README') (more/less context) (ignore whitespace changes)
-rw-r--r--README81
1 files changed, 23 insertions, 58 deletions
diff --git a/README b/README
index 2d04968..f1788b2 100644
--- a/README
+++ b/README
@@ -1,121 +1,86 @@
11. How to use the new build system 11. How to use the Opie build system
2=============================== 2====================================
3There's a great document at: 3There's a tutorial document at:
4
5http://www.uv-ac.de/opiedev/opiedev.html 4http://www.uv-ac.de/opiedev/opiedev.html
6 5
7and the API is at: 6The API reference currently is at:
8http://handhelds.org/~zecke/apidocs/index.html 7http://handhelds.org/~zecke/apidocs/index.html
9 8
10 9You will need qvfb, uic and
11You will need qvfb, designer, and uic from a qt-x11-2.3.2 package. 10(if you want to develop applications) designer
11compiled and linked against qt-x11.
12That means you must download and configure/make it. 12That means you must download and configure/make it.
13wget ftp://ftp.trolltech.com/qt/source/qt-x11-2.3.2.tar.gz 13wget ftp://ftp.trolltech.com/qt/source/qt-x11-2.3.2.tar.gz
14 14(Alternatively, you can get static binaries from http://www.vanille.de/tools)
15 15
16The recommended version of Qt embedded is qt-embedded-2.3.7 16The recommended version of Qt embedded is qt-embedded-2.3.7
17 17
18You can get it from: 18You can get it from:
19ftp://ftp.trolltech.com/qt/source/qt-embedded-2.3.7.tar.bz2 19ftp://ftp.trolltech.com/qt/source/qt-embedded-2.3.7.tar.bz2
20Other version will found in that directory.
21
22 20
23Set QTDIR to point to your qt/embedded source tree, such as: 21Set QTDIR to point to your qt/embedded source tree, such as:
24
25export QTDIR=/opt/qt-2.3.7 22export QTDIR=/opt/qt-2.3.7
26 23
27Then you need to do 24You need to do set the OPIEDIR environment variable:
28export OPIEDIR=`pwd` 25export OPIEDIR=`pwd`
29or 26or
30export OPIEDIR=~/projects/sources/opie 27export OPIEDIR=~/projects/sources/opie
31or where ever you placed Opie sources. 28or whereever you placed the Opie sources.
32 29
33and then do: 30You need to adjust your runtime library search path,
31so that the Qt/Embedded and Opie libraries can be found:
34export LD_LIBRARY_PATH=$OPIEDIR/lib:$QTDIR/lib:$LD_LIBRARY_PATH 32export LD_LIBRARY_PATH=$OPIEDIR/lib:$QTDIR/lib:$LD_LIBRARY_PATH
35 33
36You will want to apply the patches in the $OPIEDIR/qt directory to qt-embedded 34You have to apply the qte<version>-all.patch to the Qt/Embedded
37*NOTE* You can skip the qte234-for-opie091-simpad.patch 35sources and copy the qconfig-qpe.h file to $QTDIR/src/tools:
38patch, unless you are compiling for simpad.
39
40cd $QTDIR; cat $OPIEDIR/qt/qte<version>*.patch | patch -p0 36cd $QTDIR; cat $OPIEDIR/qt/qte<version>*.patch | patch -p0
37cp $OPIEDIR/qt/qpe-config.h $QTDIR/src/tools
41 38
39You are now ready to configure and build Qt/Embedded
42 40
43 41cd $QTDIR
44 42echo 'yes' | ./configure -qconfig qpe -depths 4,16,24,32 -system-jpeg -system-libpng -system-zlib -no-xft -qvfb
45Now Qt Embedded is patched and ready to go! You are ready to configure and make qt embedded. 43make
46
47I run this script to configure qte
48------------------- start script
49#!/bin/bash
50## this file is for easy configuring of qt embedded for Qtopia development, on x86
51
52configure_make () {
53 if configure_qt; then
54 make;
55 else exit -1
56fi
57}
58
59configure_qt () {
60 cd $QTDIR;
61 echo 'yes' | ./configure -qconfig qpe -depths 4,16,24,32 -system-jpeg -system-libpng -system-zlib -no-xft -qvfb;
62
63}
64
65# default configuration of Qt embedded for Opie
66echo "Configuring Qt Embedded for Opie development....";
67if [ ! -e $QTDIR/src/tools/qconfig-qpe.h ]; then
68 cp $OPIEDIR/qt/qconfig-qpe.h $QTDIR/src/tools
69fi
70
71configure_make;
72
73
74------------------- end script
75 44
76Once you have these compiled, be sure to set the PATH to ensure your (cross)compiler 45Once you have these compiled, be sure to set the PATH to ensure your (cross)compiler
77is available. 46is available.
78 47
79Then do the following in the opie source tree: 48Then do the following in the opie source tree:
80 49
81make clean 50make clean
82make menuconfig 51make menuconfig
83 52
84Now you can move through the menu and select or deselect anything.. 53Now you can move through the menu and select or deselect anything..
85Exit and save the configuration and enter "make" to create opie... 54Exit and save the configuration and enter "make" to create opie...
86 55
87Have fun with it ! 56Have fun with it !
88 57
89If you get into trouble there are other make's 58If you get into trouble there are other makefile targets
90 59
91make clean-configs 60make clean-configs
92is a useful one. 61is a useful one.
93 62
94
95Ciao, Stefan
96and ljp <lpotter@trolltech.com>
97
98
992. Used Libraries 632. Used Libraries
100================ 64================
101 65
102The following Libraries are used in Opie. 66The following Libraries are used in Opie.
103For a successfull build you must install these librarys and headers. 67For a successfull build you must install these librarys and headers.
104The versions are known-good versions. If you successfully try newer ones, 68The versions are known-good versions. If you successfully try newer ones,
105commit a new README or send mail to opie-devel@handhelds.org 69commit a new README or send a mail to opie-devel@handhelds.org
106 70
107* libsdl 1.2 71* libsdl 1.2
108 http://www.libsdl.org/download-1.2.php 72 http://www.libsdl.org/download-1.2.php
109 73
110* libxine 1.0 beta 11 74* libxine 1.0 beta 11
111 http://prdownloads.sourceforge.net/xine/ 75 http://prdownloads.sourceforge.net/xine/
112 76
113* libpcap 0.7.2 77* libpcap 0.7.2
114 http://www.tcpdump.org/release/ 78 http://www.tcpdump.org/release/
115 79
116* libetpan 0.30 + patch (in CVS) 80* libetpan 0.30 + patch (in $OPIEDIR/noncore/net/mail/libetpan)
117 http://prdownloads.sourceforge.net/libetpan/ 81 http://prdownloads.sourceforge.net/libetpan/
118 82
119* libsqlite 2.8.6 83* libsqlite 2.8.6
120 http://www.sqlite.org/download.html 84 http://www.sqlite.org/download.html
121 85
86