|
diff --git a/README b/README index cb7d5d4..3881652 100644 --- a/ README+++ b/ README |
|
@@ -1,86 +1,91 @@ |
1 | 1. How to use the Opie build system |
1 | 1. How to use the Opie build system |
2 | ==================================== |
2 | ==================================== |
3 | There's a tutorial document at: |
3 | There's a tutorial document at: |
4 | http://www.uv-ac.de/opiedev/opiedev.html |
4 | http://www.uv-ac.de/opiedev/opiedev.html |
5 | |
5 | |
6 | The API reference currently is at: |
6 | The API reference currently is at: |
7 | http://handhelds.org/~zecke/apidocs/index.html |
7 | http://handhelds.org/~zecke/apidocs/index.html |
8 | |
8 | |
9 | You will need qvfb, uic and |
9 | You will need qvfb, uic and |
10 | (if you want to develop applications) designer |
10 | (if you want to develop applications) designer |
11 | compiled and linked against qt-x11. |
11 | compiled and linked against qt-x11. |
12 | That means you must download and configure/make it. |
12 | That means you must download and configure/make it. |
13 | wget ftp://ftp.trolltech.com/qt/source/qt-x11-2.3.2.tar.gz |
13 | wget ftp://ftp.trolltech.com/qt/source/qt-x11-2.3.2.tar.gz |
14 | (Alternatively, you can get static binaries from http://www.vanille.de/tools) |
14 | (Alternatively, you can get static binaries from http://www.vanille.de/tools) |
15 | |
15 | |
16 | The recommended version of Qt embedded is qt-embedded-2.3.7 |
16 | The recommended version of Qt embedded is qt-embedded-2.3.7 |
17 | |
17 | |
18 | You can get it from: |
18 | You can get it from: |
19 | ftp://ftp.trolltech.com/qt/source/qt-embedded-2.3.7.tar.bz2 |
19 | ftp://ftp.trolltech.com/qt/source/qt-embedded-2.3.7.tar.bz2 |
20 | |
20 | |
21 | Set QTDIR to point to your qt/embedded source tree, such as: |
21 | Set QTDIR to point to your qt/embedded source tree, such as: |
22 | export QTDIR=/opt/qt-2.3.7 |
22 | export QTDIR=/opt/qt-2.3.7 |
23 | |
23 | |
24 | You need to do set the OPIEDIR environment variable: |
24 | You need to do set the OPIEDIR environment variable: |
25 | export OPIEDIR=`pwd` |
25 | export OPIEDIR=`pwd` |
26 | or |
26 | or |
27 | export OPIEDIR=~/projects/sources/opie |
27 | export OPIEDIR=~/projects/sources/opie |
28 | or whereever you placed the Opie sources. |
28 | or whereever you placed the Opie sources. |
29 | |
29 | |
30 | You need to adjust your runtime library search path, |
30 | You need to adjust your runtime library search path, |
31 | so that the Qt/Embedded and Opie libraries can be found: |
31 | so that the Qt/Embedded and Opie libraries can be found: |
32 | export LD_LIBRARY_PATH=$OPIEDIR/lib:$QTDIR/lib:$LD_LIBRARY_PATH |
32 | export LD_LIBRARY_PATH=$OPIEDIR/lib:$QTDIR/lib:$LD_LIBRARY_PATH |
33 | |
33 | |
34 | You have to apply the qte<version>-all.patch to the Qt/Embedded |
34 | You have to apply the qte<version>-all.patch to the Qt/Embedded |
35 | sources and copy the qconfig-qpe.h file to $QTDIR/src/tools: |
35 | sources and copy the qconfig-qpe.h file to $QTDIR/src/tools: |
36 | cd $QTDIR; cat $OPIEDIR/qt/qte<version>*.patch | patch -p0 |
36 | cd $QTDIR; cat $OPIEDIR/qt/qte<version>*.patch | patch -p1 |
37 | cp $OPIEDIR/qt/qpe-config.h $QTDIR/src/tools |
37 | cp $OPIEDIR/qt/qconfig-qpe.h $QTDIR/src/tools |
38 | |
38 | |
39 | You are now ready to configure and build Qt/Embedded |
39 | You are now ready to configure and build Qt/Embedded |
40 | |
40 | |
41 | cd $QTDIR |
41 | cd $QTDIR |
42 | echo 'yes' | ./configure -qconfig qpe -depths 4,16,24,32 -system-jpeg -system-libpng -system-zlib -no-xft -qvfb |
42 | echo 'yes' | ./configure -qconfig qpe -depths 4,16,24,32 -system-jpeg -system-libpng -system-zlib -no-xft -qvfb |
43 | make |
43 | make |
44 | |
44 | |
| |
45 | Note that the above command ( -qvfb ) compiles in the Virtual |
| |
46 | Framebuffer and is mostly meant on your host system. For cross |
| |
47 | compiling you will need to use the -xplatform switch but call |
| |
48 | ./configure --help to see your options. |
| |
49 | |
45 | Once you have these compiled, be sure to set the PATH to ensure your (cross)compiler |
50 | Once you have these compiled, be sure to set the PATH to ensure your (cross)compiler |
46 | is available. |
51 | is available. |
47 | |
52 | |
48 | Then do the following in the opie source tree: |
53 | Then do the following in the opie source tree: |
49 | |
54 | |
50 | make clean |
55 | make clean |
51 | make menuconfig |
56 | make menuconfig |
52 | |
57 | |
53 | Now you can move through the menu and select or deselect anything.. |
58 | Now you can move through the menu and select or deselect anything.. |
54 | Exit and save the configuration and enter "make" to create opie... |
59 | Exit and save the configuration and enter "make" to create opie... |
55 | |
60 | |
56 | Have fun with it ! |
61 | Have fun with it ! |
57 | |
62 | |
58 | If you get into trouble there are other makefile targets |
63 | If you get into trouble there are other makefile targets |
59 | |
64 | |
60 | make clean-configs |
65 | make clean-configs |
61 | is a useful one. |
66 | is a useful one. |
62 | |
67 | |
63 | 2. Used Libraries |
68 | 2. Used Libraries |
64 | ================ |
69 | ================ |
65 | |
70 | |
66 | The following Libraries are used in Opie. |
71 | The following Libraries are used in Opie. |
67 | For a successful build you must install these librarys and headers. |
72 | For a successful build you must install these librarys and headers. |
68 | The versions are known-good versions. If you successfully try newer ones, |
73 | The versions are known-good versions. If you successfully try newer ones, |
69 | commit a new README or send a mail to opie-devel@handhelds.org |
74 | commit a new README or send a mail to opie-devel@handhelds.org |
70 | |
75 | |
71 | * libsdl 1.2 |
76 | * libsdl 1.2 |
72 | http://www.libsdl.org/download-1.2.php |
77 | http://www.libsdl.org/download-1.2.php |
73 | |
78 | |
74 | * libxine 1.0 beta 11 |
79 | * libxine 1.0 beta 11 |
75 | http://prdownloads.sourceforge.net/xine/ |
80 | http://prdownloads.sourceforge.net/xine/ |
76 | |
81 | |
77 | * libpcap 0.7.2 |
82 | * libpcap 0.7.2 |
78 | http://www.tcpdump.org/release/ |
83 | http://www.tcpdump.org/release/ |
79 | |
84 | |
80 | * libetpan 0.31 |
85 | * libetpan 0.31 |
81 | http://prdownloads.sourceforge.net/libetpan/ + patch in noncore/net/mail/libetpanstuff |
86 | http://prdownloads.sourceforge.net/libetpan/ + patch in noncore/net/mail/libetpanstuff |
82 | |
87 | |
83 | * libsqlite 2.8.6 |
88 | * libsqlite 2.8.6 |
84 | http://www.sqlite.org/download.html |
89 | http://www.sqlite.org/download.html |
85 | |
90 | |
86 | |
91 | |
|