EnvironmentSetup/Linux/fr

Back to Environment Setup

This page is Linux dedicated.

Système de fichiers
Voici les systèmes de fichiers compatibles :

Compatible pour compiler : Ext3, Ext4, ReiserFS.

Peut fonctionner mais avec quelques problèmes : NTFS, UFS.

Non compatible pour compiler : Vfat

Pré-requis
Pour compiler OOo4Kids sous Linux (toutes distributions), certains outils de développement sont obligatoires, mais vous n'en n'aurez pas besoin.

Ci-dessous, certains d'entre eux que nous n'avez pas besoin d'installer


 * Vous n'avez pas besoin d'installer Java
 * Vous n'avez pas besoin d'installer Apache-Ant
 * Vous n'avez pas besoin d'installer Mozilla, ni d'autres composants de Mozilla.

Ceci étant dit, voici ci-dessous ce que vous avez besoin d'installer sous Linux ....

Paquets suggérés
Note : apt-get est utilisé ci-dessous, sous Debian et Ubuntu, mais sous Mandriva, vous devrez remplacer apt-get par urpmi (l'uilisation est la même).

Vous aurez besoin au minimum des paquets suivants. N'hésitez pas à faire des copier/coller de ce que vous avez besoin ;-)

sudo apt-get install libarchive-zip-perl sudo apt-get install gcc sudo apt-get install g++ sudo apt-get install libpam0g-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 sudo apt-get install libcupsys2-dev #Sous Ubuntu ce paquet est inclus dans libcups2-dev sudo apt-get install libgstreamer0.10-dev sudo apt-get install libgstreamer-plugins-base0.10-dev sudo apt-get install libcups2-dev sudo apt-get install autoconf sudo apt-get install dmake sudo apt-get install rpm sudo apt-get install librpm-dev sudo apt-get install zip sudo apt-get install unzip sudo apt-get install libxslt1.1 sudo apt-get install libxslt1-dev

Si vous voulez tout installer en une seule ligne de commande, copier ce qui suit : sudo apt-get install libarchive-zip-perl gcc g++ libpam0g-dev gperf python-dev curl libcurl4-gnutls-dev libxaw7-dev libxrandr-dev \ bison flex libgconf2-dev libgtk2.0-dev libcupsys2-dev libgstreamer0.10-dev libgstreamer-plugins-base0.10-dev \ libcups2-dev autoconf dmake rpm librpm-dev zin -unzip libxslt1.1 libxslt1-dev

Outils recommandés
Si vous avez l'intention de compiler OOo4Kids plusieurs fois, vous pouvez tirer profit de ccache qui accroîtra la vitesse de compilation lors des compilations suivantes. La première fois que vous compilez avec ccache, vous ne remarquerez rien, mais les fois suivantes, la compilation ira jusqu'à cinq fois plus vite.
 * ccache

Pour l'installer : sudo apt-get install ccache

Il y a deux manières de faire fonctionner ccache - la première est de définir des variables d'environnement, la seconde consiste à utiliser des liens symboliques.

En utilisant les variables d'environnement : export CC="ccache gcc" export CXX="ccache g++"

Si vous ne voulez pas entrer ces 2 lignes à chaque fois, vous pouvez entrer les 2 lignes de commandes suivantes : echo CC="ccache gcc"  >> ~/.bashrc echo CXX="ccache g++"  >> ~/.bashrc export CC CXX  >> ~/.bashrc Dès lors, quand vous ouvrirez un terminal, ccache se chargement automatiquement.

En se servant des liens symboliques : mkdir ~/bin ln -s /path/to/ccache ~/bin/gcc ln -s /path/to/ccache ~/bin/g++ ln -s /path/to/ccache ~/bin/cc ln -s /path/to/ccache ~/bin/c++ export PATH=~/bin:$PATH
 * 1) créer un répertoire pour les liens
 * 1) créer les liens symboliques pointant vers ccache avec le nom du compileur.
 * 1) Maintenant, tout ce que vous avez besoin pour rendre opérationnel ccache et d'ajouter ~/bin à votre PATH

Pour les deux méthodes, vous pouvez ajouter les lignes "export ..." vers votre ~/.profile - de ce fait, vous n'avez plus besoin de le définir manuellement lors de la compilation. Vous pouvez temporairement désactiver ccache (export CCACHE_DISABLE=1) dans le cas où vous ne voulez pas l'utiliser.

Par défaut le cache est limité à 1Go. Vous pouvez augmenter sa capacité (remplacer 2G par la taille que vous désirez) par la commande :

ccache -M 2G


 * subversion version 1.5.4 et supérieure

Le code source de OOo4Kids's source code est géré actuellement par Subversion. Vous avez besoin d'un client svn pour récupérer les sources.

Pour installer Subversion : sudo apt-get install subversion

Contrôler le code source
Le but de cette étape est de récupérer le code source d'OOo4Kids. La taille totale est de près de 2 Go. Cela peut prendre un certain temps, voire un temps certains selon votre connexion.

Premièrement, vous devez installer le paquet subversion. Sur un système Debian (ou dérivé, tel Ubuntu) : (si vous avez suivi les explications depuis le début de cette page, subversion est déjà installé), sinon faites : apt-get install subversion

La commande à utiliser est : svn checkout -rXXXX svn://svn.adullact.net/svnroot/ooo4kids1/trunk my_OOo4Kids


 * "my_OOo4Kids" est le répertoire dans lequel vous allez télécharger les sources. Vous pouvez bien-sûr lui donner un autre nom. Attention, ce répertoire "my_OOo4Kids" se crée à l'emplacement où vous êtes.
 * Remplacer XXXX dans -rXXXX par le numéro de version dont vous souhaitez récupérer les sources. Si vous souhaitez récupérer les dernières sources, enlevez tout simplement -rXXXX de cette ligne de commande.
 * Ceci va télécharger les sources de la branche entière (1,9 Go). Chez moi, le répertoire my_OOo4Kids pèse 7,9 Go après la compilation en 8 langues.

Si vous souhaitez mettre à jour les sources sans tout recommencer, vous pouvez le faire de la façon suivante :

Vous ouvrez un terminal et vous vous placez dans le répertoire dans lequel se trouvent les sources. Ensuite vous tapez la commande : svn up Seules les modifications seront téléchargées.

Lancer la configuration
... et la ligne de commande de la configuration est : 

Avant de lancer la compilation, il faut indiquer au compilateur certaines options de compilation.

Pour cela, entrez la ligne de commande suivante :

./configure --with-OOo4Kids --disable-gnome-vfs --with-system-libxml --with-lang="LES_LANGUES_QUE_VOUS_VOULEZ"

TRÈS IMPORTANT : pour l'option --with-lang="ar de es fi fr it nb nl pt ru sl uk zh-CN zh-TW", n'indiquez que la ou les langues dont vous voulez avoir une compilation. Pour compiler une version en français, entrez simplement --with-lang="fr"

Ces options ont été vérifiés sous Linux Ubuntu 10.10 Lucid Lynx. pour compiler la 1.1 r1139.

Si vous voulez avoir les fenêtres propres à Gnome, ajoutez l'option suivante à la ligne de commande --enable-gtk, ce qui donne : ./configure --with-OOo4Kids --enable-gtk --disable-gnome-vfs --with-system-libxml --with-lang="LES_LANGUES_QUE_VOUS_VOULEZ"

L'amorce (compilation de dmake)
Tapez simplement la commande suivante dans le répertoire où vous avez téléchargé les sources de OOo4Kids : ./bootstrap

Indiquer l'environnement de compilation
Utilisez la commande suivante sous linux Intel: source LinuxX86Env.Set.sh

Utilisez la commande suivante sous linux PPC: source LinuxPPCEnv.Set.sh

Compilation
Placez-vous dans le répertoire instsetoo_native : cd instsetoo_native

Voici quelques exemples de paramètres à ajouter en fonction de la puissance de votre machine :

build --all -P3 # et allez boire un verre... et revenez ~ 10 heures plus tard. build --all -P6 -- -P6 -- -P6 -- -P6 #(Pour ericb2, la compilation prend 50 minutes avec un ccache vierge et 28 minutes avec un ccache déjà rempli, les deux pour 8 locales) build --all -P4 -- -P4 #Perso je mets 2 heures pour la compilation d'une locale (en français) sans cache. 20-30 minutes avec ccache.
 * Processeur à 1GHz ou 1 Go de RAM :
 * si vous avez la chance d'avoir un i7 920 + 6GB of RAM + SSH hard disk ;-) préférez :
 * AMD Athlon II X2 245 (3200Mhz) et 2 Go de mémoire (ma machine) :

Maintenant c'est à vous d'imaginer, en fonction de la puissance de votre machine, les bonnes valeurs pour votre compilation. ;-)

Explication en deux mots des paramètres de build :

--all : signifie pour vous voulez compiler tout le programme ; --PX : chaque -PX, c'est le nombre (X) de parties à compiler en parallèle pour un processeur --   : permet de dire "fin d'option pour le premier processeur".

Si vous souhaitez mettre en pause votre compilation, appuyez sur : CTRL+Z Pour reprendre entrez : fg et validez pour poursuivre la compilation. Il est bien important de ne pas fermer votre terminal entre la pause et la reprise.

Installation sur Mandriva
Testé avec:
 * Mandriva GLinux 2009.1 (mipsel architecture)
 * Merci de continuer à lister les versions de Mandriva pour lesquelles les instructions ci-dessous fonctionnent

Pour installer: tar xvzf OOo4Kids*.tar.gz cd fr/RPMS cp desktop-integration/OOo4Kids1.0-mandriva-menus-1.0-10.noarch.rpm ./ urpmi *.rpm
 * Télécharger l'archive contenant les RPMs
 * Ouvrir un terminal et exécuter les commandes suivantes (depuis le repertoire où l'archive a été téléchargée)
 * Puis finalement, en tant que root, toujours dans le répertoire fr/RPMS

Pour désinstaller (en tant que root) urpme OOo4Kids1.0-core01 urpme OOo4Kids1.0-mandriva-menus (le paquet gérant l'intégration des menus ne dépend pas des paquets core)

Installation sur Debian ou Ubuntu (et ses dérivés)
'''Fonctionne sur Debian (Lenny) et Ubuntu (testé sous 10.10). Merci d'avance pour vos retours !!'''

Pour installer les .deb
Après une compilation

cd instsetoo_native/unxlngi6.pro/OOo4Kids/deb/install/fr/DEBS/ cp desktop-integration/OOo4Kids-debian-menus_1.2-121_all.deb. #1.2-121 : à la révision r1139. À modifier en fonction du nom exact qui change selon les versions. (ne pas oublier le point final !!) Pour être sûr d'entrer le bon nom, faites plutôt : cp d(valider avec la touche tabulation pour compléter le nom) et encore la touche tabulation pour que le terminal écrive le nom exact du fichier se trouvant dans le répertoire desktop-integration. N'oubliez pas le point final à la fin de la ligne de commande.
 * aller dans le répertoire contenant les sources en tapant :
 * copier OOo4Kids-debian-menus_1.2-121_all.deb présent dans le répertoire desktop-integration (ce répertoire est dans le répertoire courant) :
 * Rester dans le répertoire DEBS.

Si vous utilisez sudo, entrer la commande : sudo dpkg -i *.deb (qui va tout installer sans broncher)

Si vous utilisez le compte root, entrer (en étant root avec "su") la commande : dpkg -i *.deb (qui va tout installer sans broncher)

Note: sur certaines installations (inutile sous Ubuntu), il est possible que vous ayez à vous déconnecter de votre session graphique (pas rebooter, hein !) et vous reconnecter pour que les icones apparaissent dans le menu.

''' C'est tout ! Amusez-vous bien, et n'hésitez pas à nous faire savoir ce que vous en pensez, et surtout, à venir nous aider à améliorer OOo4Kids !!!'''

Pour tout désinstaller
Si vous utilisez le compte root, entrer la commande ci-dessous (en tant que root): apt-get --purge remove ooo4kids1.2-core01

Si vous utilisez sudo, taper: sudo apt-get --purge remove ooo4kids1.2-core01

... même chose pour les menus (avec le compte root) : apt-get --purge remove OOo4Kids-debian-menus

Ou (avec sudo) : sudo apt-get --purge remove ooo4kids1.2-core01 sudo apt-get --purge remove OOo4Kids-debian-menus

Install on Fedora /Red Hat
NON TESTÉ


 * Merci de continuer à lister les versions de RedHat pour lesquelles les instructions ci-dessous fonctionnent

Pour installer: tar xvzf OOo4Kids*.tar.gz cd fr/RPMS cp desktop-integration/OOo4Kids1.0-redhat-menus-1.0-10.noarch.rpm ./ urpmi *.rpm
 * Télécharger l'archive contenant les RPMs
 * Ouvrir un terminal et exécuter les commandes suivantes (depuis le repertoire où l'archive a été téléchargée)
 * Puis finalement, en tant que root, toujours dans le répertoire fr/RPMS

Pour désinstaller (en tant que root) urpme OOo4Kids1.0-core01 urpme OOo4Kids1.0-redhat-menus (le paquet gérant l'intégration des menus ne dépend pas des paquets core)