EnvironmentSetup/es

From OOo4Kids

OOo4Kids

Setup Environment

• Linux setup

Draft

Environment Setup on Linux

• Mac OS X setup

Draft

Environment Setup on Mac OS X

• Windows setup

Draft

Environment Setup on Windows XP (or superior)

This a temporary guide for setup your development environment on MacOS and Linux.

As we don't have a code repository yet for OOo4kids, we get the source code for the OOo 3.0 milestone 47 and we apply some patches. FYI milestone 47 is roughly the code for OOo 3.2.

Prerequisites

You will need at least followings packages. Feel free to copy/paste what you need ;-)

sudo apt-get install libarchive-zip-perl
sudo apt-get install gcc
sudo apt-get install g++
sudo apt-get install libpam-dev
sudo apt-get install gperf
sudo apt-get install python-dev
sudo apt-get install curl
sudo apt-get install libcurl4-gnutls-dev
sudo apt-get install libxaw7-dev
sudo apt-get install libxrandr-dev
sudo apt-get install bison
sudo apt-get install flex
sudo apt-get install libgconf2-dev
sudo apt-get install libgtk2.0-dev

Checkout the source code

The goal of this step is to get the source code for OpenOffice 3.0 milestone 47. The total size is 4,4 Go. This can take a lot of time depending of your bandwidth connection. (i.e.: With my 1MO DSL it take me more than 4 hours)

Firstly, you need to install subversion package. On a debian-like OS :

apt-get install subversion

The command to to use is :

svn checkout svn://svn.services.openoffice.org/ooo/tags/DEV300_m47

Get the patch

The goal of this step is to get all the modifications done to the OpenOffice 3.0 to transform it in OOo4Kids. As the code is not public at the moment you have to contact a developer on the IRC chanel #EducOOo to get the necessary patch.

The most up to date archive containing everything, including the needed patch to ask is:

OOo4Kids_archive_09_05_07.tar.gz

IMPORTANT: the name of the patch does contain the date it was created. So the name ot the patch may vary :-)

Unzip and put in place the patch

• unzip the patch receveid
• put each files with the same folder hierachy into the DEV300_m47 folder

All files have a different name apart from some icons from the start center. Just accept changes.

Apply the patch

Goto the source folder :

cd /path/to/DEV300_m47

Copy the patch here

cp /path/to/the/patch/new_complete_OOo4Kids_0.3_09_05_07.diff .

First try to patch as dummy for testing:

patch --dry-run -p0 < new_complete_OOo4Kids_0.3_09_05_07.diff 

If it's ok, patch for real with:

patch  -p0 < new_complete_OOo4Kids_0.3_09_05_07.diff

Regenerate the "configure"

Just type:

autoconf

Exports for ccache (OPTIONAL)

ccache may save you a lot of time if you have to compile again the software. Let's say it may divide compilation time by 2 or 3 but will need an additional 1 Go disk space. Using ccache is NOT mandatory.

If you want to install ccache, you can follow the short tutorial to install ccache

When ccache is installed, it's time to make an export:

export CC="ccache gcc"
export CXX="ccache g++"

Launch the configure

Always in DEV300_m47 folder, you have different files all starting with "my_configure". Just choose the one relevant to your architecture. Let's say that you are running GNU/Linux with an Interl like processor, just type:

cat my_configure_Linux_Intel.txt

This will print on your terminal a quite big commandline to execute with all parameters. (you can change the option --with-vendor="Eric Bachard" )

The command looks like :

./configure --with-lang=fr --disable-cups --disable-neon --disable-crashdump --disable-fontconfig --with-epm=internal --with-system-python ... and so on !

Copy/paste and execute this command

The bootstrap (compilation of dmake)

Just type the following command in /path/to/DEV300_m47

./bootstrap

Source the compilation environment

Use the following command under Mac OS X Intel:

source MacOSXX86Env.Set.sh

Use the following command under Mac OS X PowerPC:

source MacOSXPPCEnv.Set.sh

Use the following command under linux Intel:

source LinuxX86Env.Set.sh

Use the following command under linux PowerPC:

source LinuxPPCEnv.Set.sh

Check if all is ok with:

set | grep OOo4Kids 

You should have:

OOo4Kids=YES

Launch the compilation

Use the following commands:

cd instsetoo_native
build --all -P4

or with time command to have timing stats in the end

time build --all -P4

... and be patient !

If you have a slow computer, replace P4 by P3

to complete the compilation:

export PKGFORMAT=installed
build

CTRL+C to stop the process then you will have to enter the command again.

CTRL+Z to pause it if you want to free some memory or processor time for something else temporarly. To start again :

fg

Estimated compilation time for a configuration (based on concretes tests)

µProcessor	Frequence	RAM	Time estimation
Pentium 4 HT	3.2 Ghz	2 GB	~ 7Hours
Intel(R) Pentium(R) M	1.73GHz	1 GB	~ 7/8Hours
AMD Athlon(tm) 64 X2 3800+	2GHz	2 GB	~ 2/3Hours
64bits Loongson™ 2F by STMicroelectronics	900 MHz	512 MB	~ 2 days
IBM PowerPC 74xx (G4)	1,25 GHz	1,5 GB	~ 17 hours

Feel free to complete this table with your personnal information

Test the result

No that the compilation is finish, you would probably want to try launch your OOo4kids :)

On macOS

• Go to /DEV300_m47/instetoo_native/unxmacxi.pro/OOo4Kids/dmg/install/fr/
• Mount the DMG file (i.e: OOo4Kids_0.3_YYMMDD_MacOSIntel_install_fr.dmg)
• Drag and drop the OOoKids icon to the application folder
• Double click on OOoKids
• The .dmg archive size is around 104 MB

On GNU/Linux

• Go to DEV300_m47/instsetoo_native/unxlngi6.pro/OOo4Kids/installed/install/fr/ooo4kids0.3/program
• Execute soffice

Note : If you want to copy/paste OOo4kids somewhere else, you need to carry only the fr directory. Size once zipped is around 95 Mo.