FR/Documentation/Installation du SDK

Template:Documentation/Banner Que ce soit pour Linux ou Windows chacun des points suivants sont très importants si vous voulez réussir à construire des composants en C++ :

• Vous devez avoir OpenOffice.org 1.1.0 ou plus installé (le SDK ne marchera pas sans)
• Vous devez installer le SDK dans un répertoire autre que celui de l'application OOo .

Installation sous LINUX

Le texte ci-dessous décrit l'installation de SDK 1.1.0 pour OpenOffice.org1.1.0

Le SDK (Software Development Kit), kit de développement marche en supplément d'une version d' Openoffice.org déjà existante en utilisant les mêmes librairies. Le SDK requiert donc une installation d' Openoffice.org . Même si vous ne penser pas utiliser du Java il est très recommandé d'installer le JDK (1.4.1_01 ou plus pour OOo 1.1 SDK) On aura aussi besoin d'un compilateur C++ (Le 3.0.1 ou plus). GNU peut faire l'affaire (3.79.1 ou plus), c'est aussi essentiel. Quand vous êtes prêt, lancez :

tar xzvf Ooo_1.1.0_LinuxIntel_sdk.tar.gz

et aller dans le nouveau répertoire crée (dans cet exemple OpenOffice.org1.1_SDK), et lancer la configuration du script, lequel vous demandera les chemins des répertoires appropriés. Nous en donnons ici quelques-uns parmi d'autres : Où est installé votre OpenOffice.org ? (Pour moi /usr/lib/openoffice : noté <OOo> dans tout le texte qui suit) Où est installé votre Java SDK? (Pour moi /usr/java/j2sdk1.4.2_04)

Maintenant vous êtes prêt à utiliser le SDK. Chaque utilisation nécessitera le lancement du script “setsdkenv_unix” pour positionner les variables d'environnement.

A partir de maintenant, nous noterons toujours le répertoire d'installation du SDK comme : <OpenOffice.org1.1_SDK>. S'il vous plaît, ne le confondez pas avec <OOo> qui dénote le répertoire de openoffice.org /program/ .

Vous pouvez trouver un complément sur ce chapitre à : <OpenOffice.org1.1_SDK>/docs/install.html

Installation sous Windows

Vous avez besoin d'un compilateur autre que “Visual Studio family” de Microsoft. La première chose après avoir installé le SDK c'est de lancer le fichier batch de configuration, "WindowsNT.bat" et de préparer tous les dossiers nécessaires, pour une utilisation correcte. Si tout à été fait, alors vous avez déjà fini de tout installer. Il y a par contre encore une chose importante à savoir : chaque fois que vous voulez désirez compiler votre propre code ou un exemple du SDK vous devez lancer le fichier batch “setsdkenv_Windows.bat” depuis une fenêtre de commande. Sa bannière de titre devrait être maintenant: "Shell prepared for SDK". Bon codage.....

Outils de développement pour le SDK

Il y a plusieurs outils de développement fournis avec le SDK: idlc, cppumaker, javamaker, rdbmaker, pkgchk, regcomp, regmerge, regview, xml2cmp, uno, et autodoc. Vous pouvez trouver une petite documentation sur ces outils à : <OpenOffice.org1.1_SDK>/docs/tools.html

Un exemple CPP

Si vous voulez vérifier les exemples CPP , vous devez d'abord lancer :

./setsdkenv_unix

dans votre shell et ensuite:

<Ooo>/program/soffice "-accept=socket host=localhost,port=8100;urp;StarOffice.ServiceManager"

Maintenant Openoffice.org est configuré pour accepter les connexions UNO à travers le réseau. Nous somme maintenant prêt à compiler notre premier exemple et à vérifier s'il fonctionne correctement. Pour cela nous allons dans le répertoire:

cd <OpenOffice.org1.1_SDK>/examples/cpp/DocumentLoader
make

cette dernière commande va compiler l'exemple et ensuite:

make DocumentLoader.run

va lancer cet exemple. Cet exemple va seulement ouvrir un fichier OOowriter's (test.sxw) fournit avec le SDK .

Il faut garder à l'esprit que le moyen le plus simple de construire les exemples du SDK est d'utiliser les makefile fournis. Lorsqu'on est débutant avec le SDK, on sous-estime des étapes importantes dans la construction et l'exécution des fichiers binaires, par exemple l'étape d'enregistrement discutée au chapitre 6. Je peux estimer avoir compris quelquechose quand je suis capable de le construire à partir de rien (juste des connaissances) mais dans le cas du SDK cela pourrait prendre beaucoup de temps. Ainsi je peux vous donner un conseil, si vous voulez commencer un projet essayez de partir d'un exemple qui fonctionne du SDK.