EnvironmentSetup/fr

Ceci est un guide provisoire destiné à vous aider à mettre en place votre environnement de développement sur MacOS et Linux.

Comme nous n'avons pas encore de repository pour le code d'OOo4Kids, nous utilisons le source "OOo 3.0 milestone 50" auquel nous appliquons quelques patches. Pour info, milestone 50 est à peu de choses près le futur code d'OOo 3.2.

Linux

 * Configuration sous Linux
 * Draft Environment Setup on Linux

Mac OSX

 * Configuration sous Mac OS X
 * Draft Environment Setup on Mac OS X

Windows

 * Configuration sous Windows
 * Draft Environment Setup on Windows XP (or superior)

Prérequis
Vous aurez au moins besoin des packages suivants. Vous pouvez copier/coller ce dont vous avez besoin ;-)

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

Vérifier le code source
Le but de cette étape est d'obtenir le code source d'OpenOffice 3.0 milestone 50. Sa taille totale est de 4,4 GiO. Cela peut prendre beaucoup de temps, en fonction du débit de votre connexion. (Par exemple, avec ma liaison 1 MiO, cela prend plus de 4 heures)

En premier, vous devez installer le package subversion. Sur un O.S. du type Debian, cela donne : apt-get install subversion

La commande à utiliser, est : svn checkout svn://svn.services.openoffice.org/ooo/tags/DEV300_m50

Télécharger le patch
Le but de cette étape est de charger toutes les modifications qui ont été faites à OpenOffice 3.0 pour le transformer en OOo4Kids. Comme le code n'est pas encore public, pour le moment, vous devez contacter un développeur sur l'irc IRC chanel #EducOOo afin d'obtenir le patch nécessaire.

L'archive la plus à jour contenant tout, y compris le patch nécessaire à demander, est :

OOo4Kids_archive_09_06_13.tar.gz

IMPORTANT: Le nom du patch contient la date à laquelle il a été créé Le nom du patch peut donc varier :-)

Décompresser et mettre en place le patch

 * dézipper le patch reçu
 * mettre chaque fichier dans la même hiérarchie de l'arborescence, dansle dossier DEV300_m50

Tous les fichiers ont un nom différent, sauf en ce qui concerne quelques icônes du centre de lancement. Accepter les changements.

Appliquer le patch
Aller dans le répertoire du source :

cd /path/to/DEV300_m50

Copier the patch ici

cp /path/to/the/patch/new_complete_OOo4Kids_DEV300_m50_0.3_09_06_13.diff.

Essayer en premeir de patcher "en dummy" pour tester :

patch --dry-run -p0 < new_complete_OOo4Kids_DEV300_m50_0.3_09_06_13.diff

Si tout se passe bien, patcher pour de vrai, avec :

patch -p0 < new_complete_OOo4Kids_0.3_09_05_07.diff

Régénérer le "configure"
Taper seulement: autoconf

Exports pour ccache (OPTIONNEL)
ccache peut vous faire gagner beaucoup de temps si vous devez recompiler ultérieurement le programme. Disons qu'il peut diviser le temps de compilation par deux ou trois, mais nécessitera un espace additionnel de 1 GiO sur le disque. L'utilisation de ccache est optionnelle, mais fortement recommandée, surtout si vous devez recommencer une compilation (très utile pour du développement et/ou du déboggage).

Si vous souhaitez installer ccache, vous pouvez suivre le bref tutoriel pour installer ccache

Lorsque ccache est installé, c'est alors le moment de faire un export: export CC="ccache gcc" export CXX="ccache g++"

Lancer le configure
Toujours dans le dossier DEV300_m50, il y a différents fichiers commençant tous par "my_configure". Choisissez celui correspondant à vote architecture. Supposons que vous soyez sur GNU/Linux avec un processeur du type Intel. Tapez seulement : cat my_configure_Linux_Intel.txt

Cela affichera sur vote terminal une grosse ligne de commande à exécuter avec tous les paramètres. (vous pouvez modifier l'option --with-vendor="Eric Bachard" )

La commande ressemble à :

./configure --with-lang=fr --disable-cups --disable-neon --disable-crashdump --disable-fontconfig --with-epm=internal --with-system-python ... etc...

Copier / Coller et exécuter cette commande.

Le bootstrap (compilation de dmake)
Entrer la commande suivante dans /path/to/DEV300_m50 ./bootstrap

Mettre en place le source de l'environnement de compilation
Utiliser la commande suivante sous Mac OS X Intel: source MacOSXX86Env.Set.sh

Utiliser la commande suivante sous Mac OS X PowerPC: source MacOSXPPCEnv.Set.sh

Utiliser la commande suivante sous linux Intel: source LinuxX86Env.Set.sh

Utiliser la commande suivante sous linux PowerPC: source LinuxPPCEnv.Set.sh

Vérifier si tout est OK, avec : set | grep OOo4Kids

Vous devriez obtenir : OOo4Kids=YES

Lancer la compilation
Utiliser les commandes suivantes : cd instsetoo_native build --all -P4

ou avec la commande time, pour avoir des stats de temps à la fin time build --all -P4 ... et soyez patient !

Si vous avez un PC lent, remplacer P4 par P3

Pour compléter la compilation : export PKGFORMAT=installed build

CTRL+C stoppe le processus et vous devrez alors entrer la commande à nouveau.

CTRL+Z met en pause si vous voulez libérer un peu de mémoire ou de ressource proc pour une autre tâche temporaire. Pour relancer :

fg

Vous pouvez compléter cette table avec vos informations personnelles.

Tester le résultat
Maintenant que la compilation est terminée, vous souhaitez probablement essayer de lancer votre OOo4kids :)

Sur MacOS

 * Aller à /DEV300_m50/instetoo_native/unxmacxi.pro/OOo4Kids/dmg/install/fr/
 * Monter le fichier DMG (i.e: OOo4Kids_0.3_YYMMDD_MacOSIntel_install_fr.dmg)
 * Drag and drop l'icône OOoKids dans le dossier application.
 * Double clic sur OOoKids
 * La taille de l'archive .dmg est d'environ 104 MiO

Sur GNU/Linux

 * Aller à DEV300_m50/instsetoo_native/unxlngi6.pro/OOo4Kids/installed/install/fr/ooo4kids0.3/program
 * Executer soffice

Note : Si vous voulez copier / coller OOo4kids ailleurs, il vous suffit de déplacer le répertoire fr. La taille une fois zippé est d'environ 95 MiO.