author | mickeyl <mickeyl> | 2006-05-25 22:38:40 (UTC) |
---|---|---|
committer | mickeyl <mickeyl> | 2006-05-25 22:38:40 (UTC) |
commit | 22caa97cd10f2b81107bc83f50deab373afd2ca8 (patch) (unidiff) | |
tree | f4785d55c24cf2f18d00fb25bd3f117b19a5457b /README | |
parent | 7cfd27c0f29c6d7e2b90ce718d762433b82c1fe3 (diff) | |
download | opie-22caa97cd10f2b81107bc83f50deab373afd2ca8.zip opie-22caa97cd10f2b81107bc83f50deab373afd2ca8.tar.gz opie-22caa97cd10f2b81107bc83f50deab373afd2ca8.tar.bz2 |
prepare for release
-rw-r--r-- | README | 15 |
1 files changed, 12 insertions, 3 deletions
@@ -1,112 +1,121 @@ | |||
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 | You will need Qt/Embedded 2.3.10. Note that we don't support any | 16 | You will need Qt/Embedded 2.3.10. Note that we don't support any |
17 | other Qt/Embedded version anymore. | 17 | other Qt/Embedded version anymore. Qt/Embedded 2.3.12 is not recommended atm. |
18 | 18 | ||
19 | You can get it from: | 19 | You can get it from: |
20 | ftp://ftp.trolltech.com/qt/source/qt-embedded-2.3.10-free.tar.bz2 | 20 | ftp://ftp.trolltech.com/qt/source/qt-embedded-2.3.10-free.tar.bz2 |
21 | 21 | ||
22 | Set QTDIR to point to your qt/embedded source tree, such as: | 22 | Set QTDIR to point to your qt/embedded source tree, such as: |
23 | export QTDIR=/opt/qt-2.3.10 | 23 | export QTDIR=/opt/qt-2.3.10 |
24 | 24 | ||
25 | You need to do set the OPIEDIR environment variable: | 25 | You need to do set the OPIEDIR environment variable: |
26 | export OPIEDIR=`pwd` | 26 | export OPIEDIR=`pwd` |
27 | or | 27 | or |
28 | export OPIEDIR=~/projects/sources/opie | 28 | export OPIEDIR=~/projects/sources/opie |
29 | or wherever you placed the Opie sources. | 29 | or wherever you placed the Opie sources. |
30 | 30 | ||
31 | You need to adjust your runtime library search path, | 31 | You need to adjust your runtime library search path, |
32 | so that the Qt/Embedded and Opie libraries can be found: | 32 | so that the Qt/Embedded and Opie libraries can be found: |
33 | export LD_LIBRARY_PATH=$OPIEDIR/lib:$QTDIR/lib:$LD_LIBRARY_PATH | 33 | export LD_LIBRARY_PATH=$OPIEDIR/lib:$QTDIR/lib:$LD_LIBRARY_PATH |
34 | 34 | ||
35 | You have to apply the patches corresponding to your Qt/Embedded version | 35 | You have to apply the patches corresponding to your Qt/Embedded version |
36 | and copy the qconfig-qpe.h file to $QTDIR/src/tools: | 36 | and copy the qconfig-qpe.h file to $QTDIR/src/tools: |
37 | cd $QTDIR; cat $OPIEDIR/qt/qt-<version>.patch/qte<version>-all.patch | patch -p1 | 37 | cd $QTDIR; cat $OPIEDIR/qt/qt-<version>.patch/qte<version>-all.patch | patch -p1 |
38 | cp $OPIEDIR/qt/qconfig-qpe.h $QTDIR/src/tools | 38 | cp $OPIEDIR/qt/qconfig-qpe.h $QTDIR/src/tools |
39 | 39 | ||
40 | You are now ready to configure and build Qt/Embedded | 40 | You are now ready to configure and build Qt/Embedded |
41 | 41 | ||
42 | cd $QTDIR | 42 | cd $QTDIR |
43 | echo 'yes' | ./configure -qconfig qpe -depths 4,16,24,32 -system-jpeg -system-libpng -system-zlib -no-xkb -no-sm -no-xft -qvfb | 43 | echo 'yes' | ./configure -qconfig qpe -depths 4,16,24,32 -system-jpeg -system-libpng -system-zlib -no-xkb -no-sm -no-xft -qvfb |
44 | make | 44 | make |
45 | 45 | ||
46 | Note that the above command ( -qvfb ) compiles in the Virtual | 46 | Note that the above command ( -qvfb ) compiles in the Virtual |
47 | Framebuffer and is mostly meant for development on your host system. | 47 | Framebuffer and is mostly meant for development on your host system. |
48 | For cross compiling, you will need to use the -xplatform switch. | 48 | For cross compiling, you will need to use the -xplatform switch. |
49 | See ./configure --help for details about the possible options. | 49 | See ./configure --help for details about the possible options. |
50 | 50 | ||
51 | Once you have these compiled, be sure to set the PATH to ensure your (cross)compiler | 51 | Once you have these compiled, be sure to set the PATH to ensure your (cross)compiler |
52 | is available. | 52 | is available. |
53 | 53 | ||
54 | Then do the following in the opie source tree: | 54 | Then do the following in the opie source tree: |
55 | 55 | ||
56 | make clean | 56 | make clean |
57 | make menuconfig | 57 | make menuconfig |
58 | 58 | ||
59 | Now you can move through the menu and select or deselect anything.. | 59 | Now you can move through the menu and select or deselect anything.. |
60 | Exit and save the configuration and enter "make" to build everything selected. | 60 | Exit and save the configuration and enter "make" to build everything selected. |
61 | 61 | ||
62 | Have fun! | 62 | Have fun! |
63 | 63 | ||
64 | 2. Required Libraries | 64 | 2. Required Libraries |
65 | ===================== | 65 | ===================== |
66 | 66 | ||
67 | For a successful Opie build, you need to install the following libraries and headers: | 67 | For a successful Opie build, you need to install the following libraries and headers: |
68 | 68 | ||
69 | * libsdl >= 1.2.0 | 69 | * libsdl >= 1.2.0 |
70 | http://www.libsdl.org/download-1.2.php | 70 | http://www.libsdl.org/download-1.2.php |
71 | 71 | ||
72 | * libxine >= 1.0 | 72 | * libxine >= 1.0 && <= 1.1 |
73 | http://prdownloads.sourceforge.net/xine/ | 73 | http://prdownloads.sourceforge.net/xine/ |
74 | 74 | ||
75 | * libpcap >= 0.7.2 | 75 | * libpcap >= 0.7.2 |
76 | http://www.tcpdump.org/release/ | 76 | http://www.tcpdump.org/release/ |
77 | 77 | ||
78 | * libetpan >= 0.34 | 78 | * libetpan >= 0.34 |
79 | http://prdownloads.sourceforge.net/libetpan/ | 79 | http://prdownloads.sourceforge.net/libetpan/ |
80 | 80 | ||
81 | * libsqlite >= 3.0.0 | 81 | * libsqlite >= 3.0.0 |
82 | http://www.sqlite.org/download.html | 82 | http://www.sqlite.org/download.html |
83 | 83 | ||
84 | * libipk >= 138 | 84 | * libipk >= 138 |
85 | ftp://handhelds.org/linux/packages/ipkg | 85 | ftp://handhelds.org/linux/packages/ipkg |
86 | 86 | ||
87 | * libobexftp >= 0.19 | 87 | * libobexftp >= 0.19 |
88 | http://triq.net/obexftp.html | 88 | http://triq.net/obexftp.html |
89 | 89 | ||
90 | * libsword >= 1.5.8 | ||
91 | http://www.crossfire.org/sword | ||
92 | |||
93 | * libbluez >= 2.25 | ||
94 | http://www.bluez.org | ||
95 | |||
96 | * libfreetype6 >= 2.21 | ||
97 | http://www.freetype.org | ||
98 | |||
90 | 3. Required Programs | 99 | 3. Required Programs |
91 | ==================== | 100 | ==================== |
92 | 101 | ||
93 | For a successful usage of Opie, you should install the following programs: | 102 | For a successful usage of Opie, you should install the following programs: |
94 | 103 | ||
95 | * obexftpd | 104 | * obexftpd |
96 | * obextool | 105 | * obextool |
97 | 106 | ||
98 | 4. Supported Devices | 107 | 4. Supported Devices |
99 | ==================== | 108 | ==================== |
100 | 109 | ||
101 | Sharp Zaurus SL-5x00, SL-B500, SL-C7x0, SL-C8x0, SL-C1000, SL-C3000, SL-C3100, SL-6000 | 110 | Sharp Zaurus SL-5x00, SL-B500, SL-Cxx0, SL-Cxx00, SL-6000 |
102 | 111 | ||
103 | HP iPAQ 36xx, 37xx, 38xx, 39xx, 54xx, 55xx | 112 | HP iPAQ 36xx, 37xx, 38xx, 39xx, 54xx, 55xx |
104 | 113 | ||
105 | SIEMENS SIMpad CL4, SL4, SLC, T-SinusPAD | 114 | SIEMENS SIMpad CL4, SL4, SLC, T-SinusPAD |
106 | 115 | ||
107 | MasterIA Beagle, Tradesquare.NL Tuxpad 1 | 116 | MasterIA Beagle, Tradesquare.NL Tuxpad 1 |
108 | 117 | ||
109 | GMate Yopy 3x00 | 118 | GMate Yopy 3x00 |
110 | 119 | ||
111 | Motorola EZX A780, E680 | 120 | Motorola EZX A780, E680 |
112 | 121 | ||