EnvironmentSetup/Mac OS X/fr

Prérequis

Cette page contient les instructions de base dont vous aurez besoin pour compiler la version Aqua d'OOo4Kids

Prérequis obligatoires

• Mac OS X version 10.4 (aka Tiger) ou ultérieur (si 10.5 aka Leopard est utilisé, merci de lire User:Dyrcona/LeopardBuild#flex)
• XCode version 2.4.1 ou supérieur. Si vous voulez utiliser une version que celle qqui est livrée avec votre DVD d'installation, vous aurez à vous enregistrer sur le site de l'Apple Developer Connection (gratuit), afin de pouvoir la télécharger

Notes à propos de Java:

La version Aqua d'OOo4Kids n'utilise pas Java

Outils recommandés

• ccache

Si vous projetez de compiler OOo4Kids plusieurs fois, il et judicieux d'installer ccache pour accélérer les prochaines compilations. La première compilation, vous ne verrez pas de changement, mais à partir de la seconde, la durée devrait être au moins divisée par 2.

Vous pouvez l'installer en utilisant Fink. L'application s'appelle simplement "ccache". Pour les utilisateurs de MacPortsl'archive est aussi appelée "ccache".

Si vous n'utilisez ni Fink ni Darwin ports, vous pouvez télécharger ccache directement. Vous le trouverez à l'adresse suivante : http://ccache.samba.org/

Il y a deux façons d'activer ccache - L'une consiste à utiliser une variable d'environnement, l'autre consiste à utiliser un lien symbolique.

Si on utilise les variables d'environnement :

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

Avec des liens symboliques :

# create a directory for the links 
mkdir ~/bin
# create the symlinks pointing to ccache with the name of the compiler
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++
# no all you need to enable ccache is to prepend ~/bin to your PATH
$ export PATH=~/bin:$PATH

Pour les deux méthodes, vous pouvez ajouter le "export ..." dans votre ~/.profile - et de cette façon, vous n'avez pas à l'activer manuellemennt lors de la compilation.

Enfin, vous pouvez désactiver temporairement ccache (en faisant: export CCACHE_DISABLE=1) si vous ne soutaitez pas -de façon temporaire- l'utiliser.

Parce que la compilation d'OOo4Kids demande d'énormes ressources, vous devriez augmenter la taille du cache à 1 Go, voir davantage, avec l'instruction :

ccache -M 1G

• subversion version 1.5.4 or plus récent

Since OOo's source code is managed using Subversion currently, you also need the svn client to checkout sources (otherwise you would be bount to source-tarballs that aren't generated that frequently). You can either compile yourself or use the subversion universal binaries from the subversion project Version 1.5.4 or later is required because of important fixes related to the merge-feature.

Télécharger les sources et préparer la compilation...

Télécharger les source avec Subversion :

subversion est supposé être installé, car livré avec Xcode (voir + haut).

svn checkout -r920 svn://svn.adullact.net/svnroot/ooo4kids1/trunk OOo4Kids

Configure

 ./configure 
   --with-lang="ar de es fi fr it nb nl pt sl zh-CN zh-TW" \
   --enable-cups \
   --disable-crashdump \
   --disable-fontconfig \
   --with-epm=internal \
   --disable-gtk \
   --disable-gnome-vfs \
   --with-system-curl \
   --with-stlport=no \
   --disable-build-mozilla \
   --disable-binfilter \
   --disable-odk \
   --disable-vba \
   --disable-mozilla \
   --with-java=no \
   --with-vendor="Eric Bachard" \
   --with-OOoLight \
   --with-use-shell=bash \
   --enable-presenter-extra-ui \
   --enable-presenter-console

Toutes les options utilisées ci-dessus sont obligatoires. Si vous modifiez quelque chose, à moins que vous sachiez parfaitement ce que vous faîtes, vous risquez de casser la compilation.

D'avance merci pour toute amélioration de configure, et pour les patches éventuels que vous pourriez nous faire parvenir, afin d'améliorer configure.

Sur Mac Intel

./bootstrap
source MacOSXX86Env.Set.sh
cd instsetoo_native
export TMP=/tmp

+

build --all -P2 -- -P2

sur PowerPC

./bootstrap
source MacOSXPPCEnv.Set.sh
cd instsetoo_native
export TMP=/tmp

+

build --all -P2 -- -P2

Installer, configurer et exécuter OOo4Kids

Localiser le Bundle dans l'arborescence

Une fois la compilation terminée, le produit final s'appelle ( ici la version en-US version ): OOOo4Kids_0.4_090628_MacOSXIntel_install.dmg ( pour la version 0.4 par exemple)

Elle se trouve dans le répertoire instsetoo_native/unxmacxi.pro/OOo4Kids.app/dmg/install/en-US ( changer en-US par votre locale )

Par exemple, ci-dessous, le chemine pour la (obsolète) versio en-US:

Installer

• double cliquer sur l'image disque (icone *.dmg);
• glisser l'icon d'OOo4Kids dans le dossier de votre choix.

titre du lien

Lancer l'application

• double click the application icon in that folder

Copies d'écrans

Now you can start to work with this [FIXME : add screenshots]

Contribuer en trouvant, mettant en évidence des problèmes, en déboguant ou en corrigeant des bugs

Isoler un problème

Corriger un problème

• permettre de reproduire le problème
• le réduire à un problème unique, aussi simple que possible
• si un problème est spécifique à un document, merci de l'attacher à l'issue. Un document centré sur un test qui montre le problème est encore plus utile.
• Une copie d'écran est une bonne idée, si elle apporte de l'information et aide à comprendre le problème.

Utiliser les variables d'environnement et switches de l'application (mode debug)

Application switches are often valuable for isolating a problem. Most of OOo4Kids's options can be found its Tools->Options menu.

Some switches are so special that there is no user interface to change them. They are only useful for debugging and isolating a problem, but they are very valuable a that. So a developer might suggest to isolate a problem by setting an environment variable before running the application. E.g. for isolating problems with the menubar a developer might suggest to set the environment variable AQUA_NATIVE_MENUS to false. This is done by typing these commands into a terminal:

• cd <INSTALL_DIR>/OOo4Kids.app/Contents/MacOS
• export AQUA_NATIVE_MENUS=false
• ./soffice.bin

Fournir la pile d'appels résultant d'un crash

Please note that bugs involving crashes should provide a description of how to reproduce the problem and a callstack. There are several ways to provide the callstack: