Diffstat (limited to 'development/macosx/README_MACOSX') (more/less context) (show whitespace changes)
-rw-r--r-- | development/macosx/README_MACOSX | 30 |
1 files changed, 24 insertions, 6 deletions
diff --git a/development/macosx/README_MACOSX b/development/macosx/README_MACOSX index 4cb5908..ac62046 100644 --- a/development/macosx/README_MACOSX +++ b/development/macosx/README_MACOSX | |||
@@ -2,39 +2,38 @@ Information about porting Opie to MacOS-X (eilers) | |||
2 | ================================================== | 2 | ================================================== |
3 | 3 | ||
4 | Credits: | 4 | Credits: |
5 | -------- | 5 | -------- |
6 | 6 | ||
7 | Special thanks to Andreas Junghans (webmaster@lucid-cake.net) for its patches for qt-X11 (2.3.2), | 7 | Special thanks to Andreas Junghans (webmaster@lucid-cake.net) for its patches for qt-X11 (2.3.2), |
8 | QT/E (2.3.5) and qtopia (1.6.1). | 8 | QT/E (2.3.5) and qtopia (1.6.1). |
9 | Without them, I wouldn't be able to provide the port for OPIE to MacOS-X that fast.. | 9 | Without them, I wouldn't be able to provide the port for OPIE to MacOS-X that fast.. |
10 | Thanks to Juergen Graf to debug this very generic README ! | 10 | Thanks to Juergen Graf to debug this very generic README ! |
11 | 11 | ||
12 | Status: | 12 | Status: |
13 | ------- | 13 | ------- |
14 | This work is done, do provide a development platform for Apple-Users! Please do not expect that you | ||
15 | could create a productive Opie system for the Mac with it !! | ||
16 | |||
14 | The basic system works quite well. But a lot of applications and plugins, | 17 | The basic system works quite well. But a lot of applications and plugins, |
15 | which are platform specific, need some work to be compileable. | 18 | which are platform specific, need some work to be compileable. |
16 | 19 | ||
17 | What is ready: | 20 | What is ready: |
18 | 21 | ||
19 | libqpe | 22 | libqpe |
20 | libopie1 | 23 | libopie1 |
21 | libopie2/opiedb | 24 | libopie2 |
22 | pim-applications (addressbook, todolist, datebook, today) | 25 | pim-applications (addressbook, todolist, datebook, today) |
23 | A lot of applications and plugins which are not platform specific. | 26 | A lot of applications and plugins which are not platform specific. |
24 | 27 | ||
25 | What will follow soon: | ||
26 | |||
27 | libopie2 (libopiecore and libopiedb works already !) | ||
28 | |||
29 | ToDO: | 28 | ToDO: |
30 | ----- | 29 | ----- |
31 | There are some functions in the sourcecode which are not yet ported to Mac. If the | 30 | There are some functions in the sourcecode which are not yet ported to Mac. If the |
32 | MacOS environment should be used for real productive work, the following functions | 31 | MacOS environment should be used for real productive work, the following functions |
33 | must be implemented correctly: | 32 | must be implemented correctly: |
34 | 33 | ||
35 | libopie/pim/otimezone.cpp: | 34 | libopie/pim/otimezone.cpp: |
36 | Accessing of "setenv(...)" on Mac caused bus-errors. | 35 | Accessing of "setenv(...)" on Mac caused bus-errors. |
37 | Workaround/Fix: Unknown | 36 | Workaround/Fix: Unknown |
38 | Current-State: setenv() was just commented out. Thus the related functions may behave wrong! | 37 | Current-State: setenv() was just commented out. Thus the related functions may behave wrong! |
39 | 38 | ||
40 | library/filemanager.cpp: | 39 | library/filemanager.cpp: |
@@ -87,37 +86,56 @@ make | |||
87 | 86 | ||
88 | Now create a link for the uic of qt-2.3.2 into the bin-directory of qt/e 2.3.7 ! | 87 | Now create a link for the uic of qt-2.3.2 into the bin-directory of qt/e 2.3.7 ! |
89 | Otherwise OPIE will fail to compile ! | 88 | Otherwise OPIE will fail to compile ! |
90 | 89 | ||
91 | Compile OPIE: | 90 | Compile OPIE: |
92 | Set your environment | 91 | Set your environment |
93 | (You may use the script "set_vars.sh" to set your variables successfully ! | 92 | (You may use the script "set_vars.sh" to set your variables successfully ! |
94 | BUT: You have to customize this script for YOUR needs !!) | 93 | BUT: You have to customize this script for YOUR needs !!) |
95 | Go into the basic directory of Opie | 94 | Go into the basic directory of Opie |
96 | make menuconfig" | 95 | make menuconfig" |
97 | set "Build Parameters"->"Target Machine"->"Mac OS X (DARWIN)" to activate the platform specific changes. | 96 | set "Build Parameters"->"Target Machine"->"Mac OS X (DARWIN)" to activate the platform specific changes. |
98 | save and exit the menuconfig app | 97 | save and exit the menuconfig app |
99 | make | 98 | make (ATTENTION: See Known Bugs below!!) |
100 | 99 | ||
101 | You will see that a lot of applications and plugins/applets will not compile | 100 | You will see that a lot of applications and plugins/applets will not compile |
102 | successfully, due to the fact that they are not ported to this platform. | 101 | successfully, due to the fact that they are not ported to this platform. |
103 | You may disable them to be able to compile the rest. | 102 | You may disable them to be able to compile the rest. |
104 | 103 | ||
105 | Remember: A lot of configuration-settings are not tested and might fail to compile. | 104 | Remember: A lot of configuration-settings are not tested and might fail to compile. |
106 | If you want to avoid misconfigurations, you may want to start with | 105 | If you want to avoid misconfigurations, you may want to start with |
107 | the config-file in this directory. Just copy "config_macosx" to $OPIEDIR/.config | 106 | the config-file in this directory. Just copy "config_macosx" to $OPIEDIR/.config |
108 | to get a working configuration to start with. | 107 | to get a working configuration to start with. |
109 | 108 | ||
110 | (The missing apps/plugins will be ported on demand.) | 109 | (The missing apps/plugins will be ported on demand.) |
111 | 110 | ||
111 | Known Bugs (compilation problems): | ||
112 | ----------- | ||
113 | The Apple-Linker does not load indirect linked libraries automatically ( if somebody | ||
114 | has a solution here, please inform me !!), therefore I had to add "-lopiedb2" and "-lqpe" | ||
115 | for applications/libraries who used libraries which are linked against them. | ||
116 | A goot solution would be to add it in the project files of these application, but this would | ||
117 | influence the linux-platform as well... :( | ||
118 | As a first (but stupid) solution, I added this linker parameter to the global "include.pro" | ||
119 | which adds them for everything.. Yes, also for libqpe etc.. | ||
120 | Therefore this project will not compile out of the box. You have to compile in a two-pass way: | ||
121 | |||
122 | Pass 1: Find the line "LIBS += -lopiedb2 -lqpe" in the file include.pro and comment out it (put a "#" | ||
123 | in front of it) | ||
124 | Do a "make -k" to compile what is already compileable (some will not compile) | ||
125 | Pass 2: Remove the comment from Pass1 and do a "make". The rest should compile now successfully. | ||
126 | |||
127 | |||
128 | I know, this is a silly solution ! But I don't have anything better without influence the Linux build | ||
129 | process too much .. I would be happy, if somebody could help me here ! | ||
112 | 130 | ||
113 | SPECIAL INFORMATION FOR USERS OF PANTHER | 131 | SPECIAL INFORMATION FOR USERS OF PANTHER |
114 | ---------------------------------------- | 132 | ---------------------------------------- |
115 | I had a lot of problems compiling qt-2.3.2 and QT/E-2.3.7 on Panther. The | 133 | I had a lot of problems compiling qt-2.3.2 and QT/E-2.3.7 on Panther. The |
116 | new release of the X-Server causes a lot of trouble.. | 134 | new release of the X-Server causes a lot of trouble.. |
117 | 135 | ||
118 | To compile QT-2.3.2 successfully, you have to disable support of freetype fonts and you have | 136 | To compile QT-2.3.2 successfully, you have to disable support of freetype fonts and you have |
119 | to use the patch in this directory, otherwise your wont't be able to compile ! | 137 | to use the patch in this directory, otherwise your wont't be able to compile ! |
120 | Use the param "-no-xft" for the configure script to disable this function ! | 138 | Use the param "-no-xft" for the configure script to disable this function ! |
121 | 139 | ||
122 | Information for Developers: | 140 | Information for Developers: |
123 | --------------------------- | 141 | --------------------------- |