summaryrefslogtreecommitdiff
path: root/development
Unidiff
Diffstat (limited to 'development') (more/less context) (ignore whitespace changes)
-rw-r--r--development/macosx/README_MACOSX4
1 files changed, 4 insertions, 0 deletions
diff --git a/development/macosx/README_MACOSX b/development/macosx/README_MACOSX
index a468700..5069a2e 100644
--- a/development/macosx/README_MACOSX
+++ b/development/macosx/README_MACOSX
@@ -1,117 +1,121 @@
1Information about porting Opie to MacOS-X (eilers) 1Information about porting Opie to MacOS-X (eilers)
2================================================== 2==================================================
3 3
4Credits: 4Credits:
5-------- 5--------
6 6
7Special thanks to Andreas Junghans (webmaster@lucid-cake.net) for its patches for qt-X11 (2.3.2), 7Special thanks to Andreas Junghans (webmaster@lucid-cake.net) for its patches for qt-X11 (2.3.2),
8QT/E (2.3.5) and qtopia (1.6.1). 8QT/E (2.3.5) and qtopia (1.6.1).
9Without them, I wouldn't be able to provide the port for OPIE to MacOS-X that fast.. 9Without them, I wouldn't be able to provide the port for OPIE to MacOS-X that fast..
10Thanks to Juergen Graf to debug this very generic README !
10 11
11Status: 12Status:
12------- 13-------
13The basic system works quite well. But a lot of applications and plugins, 14The basic system works quite well. But a lot of applications and plugins,
14which are platform specific, need some work to be compileable. 15which are platform specific, need some work to be compileable.
15 16
16What is ready: 17What is ready:
17 18
18libqpe 19libqpe
19libopie1 20libopie1
20libopie2/opiedb 21libopie2/opiedb
21pim-applications (addressbook, todolist, datebook, today) 22pim-applications (addressbook, todolist, datebook, today)
22A lot of applications and plugins which are not platform specific. 23A lot of applications and plugins which are not platform specific.
23 24
24What will follow soon: 25What will follow soon:
25 26
26libopie2 27libopie2
27 28
28 29
29How to compile Opie for MacOS-X: 30How to compile Opie for MacOS-X:
30------------------------------- 31-------------------------------
31 32
32Before compiling for MacOS-X, you need the following: 33Before compiling for MacOS-X, you need the following:
33 34
34 1. X11-Server+X11SDK (Provided by Apple) 35 1. X11-Server+X11SDK (Provided by Apple)
35 2. QT-2.3.2 for X11 (Provided by Trolltech) 36 2. QT-2.3.2 for X11 (Provided by Trolltech)
36 3. QT/E-2.3.7 (Provided by Trolltech) 37 3. QT/E-2.3.7 (Provided by Trolltech)
37 4. Patches for QT-2.3.2 for MacOSX (take the one in this directory !) 38 4. Patches for QT-2.3.2 for MacOSX (take the one in this directory !)
38 5. Patches for QT/E-2.3.7 for MacOSX (take the one, provided in $OPIEDIR/qt) 39 5. Patches for QT/E-2.3.7 for MacOSX (take the one, provided in $OPIEDIR/qt)
39 40
40The Patch for QT-2.3.2 is provided in this directory and is called "qt232-X11.patch". 41The Patch for QT-2.3.2 is provided in this directory and is called "qt232-X11.patch".
41 42
42The Patch for QT/E for Opie, including all other opie-patches is available in the 43The Patch for QT/E for Opie, including all other opie-patches is available in the
43qt-directory ($OPIEDIR/qt) and is called "qte237-all-macosx.patch". 44qt-directory ($OPIEDIR/qt) and is called "qte237-all-macosx.patch".
44 45
45Please read further, how to compile the stuff. 46Please read further, how to compile the stuff.
46 47
47HOWTO COMPILE: 48HOWTO COMPILE:
48------------- 49-------------
49 50
50Compile QT-2.3.2: 51Compile QT-2.3.2:
51 52
52Go to into the basic directory of qt-2.3.2 and enter 53Go to into the basic directory of qt-2.3.2 and enter
53export QTDIR=`pwd` 54export QTDIR=`pwd`
54export DYLD_LIBRARY_PATH=$QTDIR/lib 55export DYLD_LIBRARY_PATH=$QTDIR/lib
55./configure -no-xft -platform darwin-g++ 56./configure -no-xft -platform darwin-g++
56make 57make
57After compiling successful (I hope) you need qvfb: 58After compiling successful (I hope) you need qvfb:
58cd tools/qvfb 59cd tools/qvfb
59make 60make
60 61
61Compile QT/E-2.3.7: 62Compile QT/E-2.3.7:
62 63
63Got to into the basic directory of qt-2.3.2 and enter 64Got to into the basic directory of qt-2.3.2 and enter
64export QTDIR=`pwd` 65export QTDIR=`pwd`
65export QPEDIR=$QTDIR 66export QPEDIR=$QTDIR
66export DYLD_LIBRARY_PATH=$QTDIR/lib 67export DYLD_LIBRARY_PATH=$QTDIR/lib
67./configure -platform darwin-generic-g++ -qconfig qpe -qvfb -depths 4,8,16,32 68./configure -platform darwin-generic-g++ -qconfig qpe -qvfb -depths 4,8,16,32
68make 69make
69 70
71Now create a link for the uic of qt-2.3.2 into the bin-directory of qt/e 2.3.7 !
72Otherwise OPIE will fail to compile !
73
70Compile OPIE: 74Compile OPIE:
71Set your environment 75Set your environment
72(You may use the script "set_vars.sh" to set your variables successfully ! 76(You may use the script "set_vars.sh" to set your variables successfully !
73BUT: You have to customize this script for YOUR needs !!) 77BUT: You have to customize this script for YOUR needs !!)
74Go into the basic directory of Opie 78Go into the basic directory of Opie
75make menuconfig" 79make menuconfig"
76set "Build Parameters"->"Target Machine"->"Mac OS X (DARWIN)" to activate the platform specific changes. 80set "Build Parameters"->"Target Machine"->"Mac OS X (DARWIN)" to activate the platform specific changes.
77save and exit the menuconfig app 81save and exit the menuconfig app
78make 82make
79 83
80You will see that a lot of applications and plugins/applets will not compile 84You will see that a lot of applications and plugins/applets will not compile
81successfully, due to the fact that they are not ported to this platform. 85successfully, due to the fact that they are not ported to this platform.
82You may disable them to be able to compile the rest. 86You may disable them to be able to compile the rest.
83 87
84Remember: A lot of configuration-settings are not tested and might fail to compile. 88Remember: A lot of configuration-settings are not tested and might fail to compile.
85If you want to avoid misconfigurations, you may want to start with 89If you want to avoid misconfigurations, you may want to start with
86the config-file in this directory. Just copy "config_macosx" to $OPIEDIR/.config 90the config-file in this directory. Just copy "config_macosx" to $OPIEDIR/.config
87to get a working configuration to start with. 91to get a working configuration to start with.
88 92
89(The missing apps/plugins will be ported on demand.) 93(The missing apps/plugins will be ported on demand.)
90 94
91 95
92SPECIAL INFORMATION FOR USERS OF PANTHER 96SPECIAL INFORMATION FOR USERS OF PANTHER
93---------------------------------------- 97----------------------------------------
94I had a lot of problems compiling qt-2.3.2 and QT/E-2.3.7 on Panther. The 98I had a lot of problems compiling qt-2.3.2 and QT/E-2.3.7 on Panther. The
95new release of the X-Server causes a lot of trouble.. 99new release of the X-Server causes a lot of trouble..
96 100
97To compile QT-2.3.2 successfully, you have to disable support of freetype fonts and you have 101To compile QT-2.3.2 successfully, you have to disable support of freetype fonts and you have
98to use the patch in this directory, otherwise your wont't be able to compile ! 102to use the patch in this directory, otherwise your wont't be able to compile !
99Use the param "-no-xft" for the configure script to disable this function ! 103Use the param "-no-xft" for the configure script to disable this function !
100 104
101Information for Developers: 105Information for Developers:
102--------------------------- 106---------------------------
103 107
1041. Platform specific code should be surrounded by 1081. Platform specific code should be surrounded by
105#ifdef Q_OS_MACX 109#ifdef Q_OS_MACX
106MACOS-X CODE 110MACOS-X CODE
107#else 111#else
108OTHER-CODE 112OTHER-CODE
109#endif 113#endif
110 114
1112. The Plugin-Handling by MacOS-X is different than it is by Linux. 1152. The Plugin-Handling by MacOS-X is different than it is by Linux.
112On linux-systems, shared libraries are not different to dynamic loaded libraries 116On linux-systems, shared libraries are not different to dynamic loaded libraries
113(aka plugins). They just are different whether they are loaded automatically 117(aka plugins). They just are different whether they are loaded automatically
114at startup or manually by any application. 118at startup or manually by any application.
115On MacOS-X, the plugins are loaded by a special mechanism and must be in a special 119On MacOS-X, the plugins are loaded by a special mechanism and must be in a special
116binary format. Therefore you have to add the term "plugin" to the CONFIG-clause, as 120binary format. Therefore you have to add the term "plugin" to the CONFIG-clause, as
117for instance: 121for instance: