Wikilaran participation_au_projet:programmation

Compilation du client

anonymous@undisclosed.example.com (Anonymous) — Wed, 19 Aug 2015 12:05:21 +0000

Compilation du client

Compilation du client sous linux

Compilation dynamique

Pour compiler le client, il faut déjà récupérer les sources sur l’espace téléchargement (sources officielles) ou sur le serveur subversion (en cours de développement).

Il faut ensuite se positionner dans le répertoire NouveauClient/trunk/client_sources, et taper la commande make -f Makefile.linux ce qui va créer le fichier le.x86.linux.bin. Si on veut diminuer la taille de l’exécutable, il suffit de taper la commande strip le.x86.linux.bin

Compilation statique

La première solution, est d’avoir les différentes bibliothèques statiques directement sur la distribution, mais comme c’est un cas assez rare, on va plutôt suivre un autre méthode.

Le principe va être de récupérer les sources des différentes bibliothèques directement sur leur site officiel et de les compiler. Pour simplifier cette partie, voici un script qui va faire le travail tout seul (récupérer les archives et les compiler). Attention ce script n’est pas sécurisé et n’est pas tellement propre, donc faire attention en l’utilisant.

REP_SOURCES="/opt/landes/NouveauClient/trunk/client_sources/"
REP_LIBS="$REP_SOURCES/libs"
OPENAL="openal-soft-1.11.753"
CAL3D="cal3d_0.10.0+0.11.0+rc2"
SDL="SDL-1.2.14"
SDL_IMAGE="SDL_image-1.2.10"
SDL_NET="SDL_net-1.2.7"
VORBIS="libvorbis-1.3.1"
OGG="libogg-1.2.0"
XML="libxml2-2.7.8"
PNG="libpng-1.4.5"
ALSA="alsa-lib-1.0.21a"
ZLIB="zlib-1.2.5"

if [ ! -e "$REP_LIBS" ]; then
    mkdir $REP_LIBS
fi

cd $REP_LIBS

#########################
# Compilation de OpenAL #
#########################
if [ ! -f $OPENAL.tar.bz2 ]; then
    wget http://kcat.strangesoft.net/openal-releases/$OPENAL.tar.bz2
fi

if [ ! -e $OPENAL ]; then
    tar xjf $OPENAL.tar.bz2
fi

if [ ! -f libopenal.a ]; then
    cd $OPENAL
    sed -i 's/SHARED/STATIC/' CMakeLists.txt
    cmake .
    make
    cp libopenal.a ../
    cd $REP_LIBS
fi

########################
# Compilation de Cal3D #
########################
if [ ! -f $CAL3D.orig.tar.gz ]; then
    wget http://download.gna.org/cal3d/cal3d/gnulinux/debian/dapper/src/$CAL3D.orig.tar.gz
fi

if [ ! -e cal3d-0.10.0+0.11.0+rc2 ]; then
    tar xzf $CAL3D.orig.tar.gz
fi

if [ ! -f libcal3d.a ]; then
    cd cal3d-0.10.0+0.11.0+rc2
    ./configure --enable-static --disable-shared
    echo "#include <string.h>" >> config.h
    make
    cp src/cal3d/.libs/libcal3d.a ../
    cd $REP_LIBS
fi

######################
# Compilation de SDL #
######################
if [ ! -f $SDL.tar.gz ]; then
    wget http://www.libsdl.org/release/$SDL.tar.gz
fi

if [ ! -e $SDL ]; then
    tar xzf $SDL.tar.gz
fi

if [ ! -f libSDL.a ]; then
    cd $SDL
    ./configure --disable-shared --disable-video-directfb
    make
    cp build/.libs/libSDL.a ../
    cd $REP_LIBS
fi

############################
# Compilation de SDL_image #
############################
if [ ! -f $SDL_IMAGE.tar.gz ]; then
    wget http://www.libsdl.org/projects/SDL_image/release/$SDL_IMAGE.tar.gz
fi

if [ ! -e $SDL_IMAGE ]; then
    tar xzf $SDL_IMAGE.tar.gz
fi

if [ ! -f libSDL_image.a ]; then
    cd $SDL_IMAGE
    ./configure --disable-shared
    make
    cp .libs/libSDL_image.a ../
    cd $REP_LIBS
fi

##########################
# Compilation de SDL_net #
##########################
if [ ! -f $SDL_NET.tar.gz ]; then
    wget http://www.libsdl.org/projects/SDL_net/release/$SDL_NET.tar.gz
fi

if [ ! -e $SDL_NET ]; then
    tar xzf $SDL_NET.tar.gz
fi

if [ ! -f libSDL_net.a ]; then
    cd $SDL_NET
    ./configure --disable-shared
    make
    cp .libs/libSDL_net.a ../
    cd $REP_LIBS
fi

#########################
# Compilation de Vorbis #
#########################
if [ ! -f $VORBIS.tar.gz ]; then
    wget http://downloads.xiph.org/releases/vorbis/$VORBIS.tar.gz
fi

if [ ! -e $VORBIS ]; then
    tar xzf $VORBIS.tar.gz
fi

if [ ! -f libvorbis.a ]; then
    cd $VORBIS
    ./configure --disable-shared --enable-static
    make
    cp lib/.libs/libvorbis.a ../
    cp lib/.libs/libvorbisfile.a ../
    cd $REP_LIBS
fi

######################
# Compilation de Ogg #
######################
if [ ! -f $OGG.tar.gz ]; then
    wget http://downloads.xiph.org/releases/ogg/$OGG.tar.gz
fi

if [ ! -e $OGG ]; then
    tar xzf $OGG.tar.gz
fi

if [ ! -f libogg.a ]; then
    cd $OGG
    ./configure --disable-shared --enable-static
    make
    cp src/.libs/libogg.a ../
    cd $REP_LIBS
fi

######################
# Compilation de XML #
######################
if [ ! -f $XML.tar.gz ]; then
    wget ftp://xmlsoft.org/libxml2/$XML.tar.gz
fi

if [ ! -e $XML ]; then
    tar xzf $XML.tar.gz
fi

if [ ! -f libxml2.a ]; then
    cd $XML
    ./configure --disable-shared --enable-static
    make
    cp .libs/libxml2.a ../
    cd $REP_LIBS
fi

######################
# Compilation de PNG #
######################
if [ ! -f $PNG.tar.bz2 ]; then
    wget ftp://ftp.simplesystems.org/pub/libpng/png/src/history/$PNG.tar.bz2
fi

if [ ! -e $PNG ]; then
    tar xjf $PNG.tar.bz2
fi

if [ ! -f libpng.a ]; then
    cd $PNG
    ./configure --disable-shared --enable-static
    make
    cp .libs/libpng14.a ../libpng.a
    cd $REP_LIBS
fi

#######################
# Compilation de ALSA #
#######################
if [ ! -f $ALSA.tar.bz2 ]; then
    wget ftp://ftp.task.gda.pl/pub/linux/misc/alsa/lib/$ALSA.tar.bz2
fi

if [ ! -e $ALSA ]; then
    tar xjf $ALSA.tar.bz2
fi

if [ ! -f libasound.a ]; then
    cd $ALSA
    ./configure --disable-shared --enable-static
    make
    cp src/.libs/libasound.a ../
    cd $REP_LIBS
fi


#######################
# Compilation de ZLIB #
#######################
if [ ! -f $ZLIB.tar.bz2 ]; then
    wget http://zlib.net/$ZLIB.tar.bz2
fi

if [ ! -e $ZLIB ]; then
    tar xjf $ZLIB.tar.bz2
fi

if [ ! -f libz.a ]; then
    cd $ZLIB
    ./configure
    make
    cp libz.a ../
    cd $REP_LIBS
fi

Lorsque toutes les bibliothèques sont récupérer, il faut taper la commande make static -f Makefile.linux, ce qui va compiler les sources et créer le fichier le.x86.static.linux.bin. Pour diminuer la taille de l’exécutable, il faut taper la commande strip le.x86.static.linux.bin.

Compilation avec Ubuntu

Sur une configuration vierge de toute installation, il faut commencer par créer un répertoire de travail et se placer dedans

Installation de subversion :

sudo apt-get install subversion

Récupération de la dernière version du dépôt :

svn co svn://jeu.landes-eternelles.com:/NouveauClient (login : anonyme pass : anonyme)

Installation des bibliothèques manquantes :

sudo apt-get install libxml2-dev libsdl1.2-dev libopenal-dev libogg-dev libsdl-net1.2-dev libvorbis-dev libsdl-image1.2-dev libcal3d12-dev libxslt1-dev g++ cmake

On entre dans le répertoire pour la compilation :

cd NouveauClient/trunk/client_sources

Compilation :

make -f Makefile.linux

Activation d'un flag

Pour activer ou désactiver un flag, il faut ouvrir le fichier make.defaults, et décommenter ou commenter les options que l’on veut activer ou désactiver. Ensuite il suffit de recompiler le client pour que la modification soit prise en compte.

Compilation du client sous Windows

Le fichier projet le plus à jour étant celui sous Code::Blocks, nous vous recommandons d’utiliser ce logiciel. Téléchargez celui avec mingw, version 10.05 (les plus récentes ne sont pas compatibles).

Pour compiler le client, il faut déjà récupérer les sources sur l’espace téléchargement (sources officielles) ou sur le serveur subversion (en cours de développement). Il vous faut aussi récupérer les librairies Windows, la version officielle du pack est disponible ici : http://landes-eternelles.com/client/Librairie.zip

Dézipez ces deux dossiers et mettez-les dans un même répertoire. Vous vous retrouverez donc avec un dossier contenant deux autres dossiers : client_sources et Librairie.

Il vous suffit ensuite d’aller dans votre fichier source, d’ouvrir le fichier client.cdb et de lancer la compilation (construire l’exécutable). Ceci aura pour effet de vous créer un fichier client.exe dans le répertoire client (Se trouvant au même niveau que client_sources et librairies).

Placez client.exe dans votre répertoire de jeu, double cliquez dessus, et le jeu se lancera à partir du client que vous venez de créer.

Problème fréquent : “redefinition of typedef ‘Byte’” ⇒ déplacer le fichier xz\Type.h dans les includes de code blocks (généralement C:\Program Files (x86)\CodeBlocks\MinGW\include)

Activation d'un flag

Dans CodeBlocks, sous Windows :

Menu Project / Build Options / Onglet Compiler Settings / Onglet #define / ⇒ rajouter les variables qui vont bien

Compilation sous mac avec xcode

Pour compiler sur mac vous devez déjà connaitre l’environnement mac et xcode. Vous pouvez contacter Trinita pour plus d’informations.

1. vous pouvez récupérer le pack de librairie ici : http://landes-eternelles.com/client/framework_macosx.zip

2. vous devez installer xcode ( voir le site apple.fr )

3. vous devez récupérer les sources ( soit le zip sur dans la partie téléchargement ) soit sur le svn. Vous pouvez utiliser SvnX comme interface graphique.

Structure

anonymous@undisclosed.example.com (Anonymous) — Sat, 13 Aug 2011 12:59:59 +0000

Structure

Le premier niveau de l’encyclopédie est forcement un fichier d’inclusion de plusieurs fichiers défini par le tag <Category>.

Exemple : <Encyclopedia> <Category>FICHIER</Category> </Encyclopedia>

FICHIER étant le nom du fichier FICHIER.xml à lire dans le répertoire de l’encyclopédie.

Ensuite chaque fichiers est constitue de page qui représente un page de l’encycopédie référencé par un nom.

Balises

Chaque page peut être composé des balises suivantes :

<size>[Big|Medium]</size> La taille de la police

COULEUR On définie la couleur soit par les composante Rouge /Vert/Bleu (un chiffre de 0 à 255) ou par un nom COULEUR = [silver, grey, maroon, green, navy, olive, purple, teal, white, black, red, lime, blue, magenta, yellow, cyan]

<Text x=“X’ y=“Y” font=“FONT” >TEXTE</Text> X et Y définissent la position absolue X,Y dans la fenetre FONT = le numéro de la police (il s’agit d’un nombre actuellement seul la font 0 existe). TEXT : le texte a afficher

<nl></nl> Passage à la ligne suivante (en repart du bord de la fenetre)

<nlkx></nlkx> Passage à la ligne suivante (en repart de la position de début du dernier texte) (en gros de la position X de la balise TEXT/LINK précédente)

<Image u=“U” v=“V” uend=“UE” vend=“VE” xlen=“XL” ylen=“YL” name=“FICHIER” x=“X” y=“Y” mouseover=“0/1” xposupdate=“0/1” yposupdate=“0/1” ></Image> U, V et UE,VE sont des chiffres de 0.0 à 1.0 qui définissent la position de l’image en UVmapping. XL et YL la taille de l’image en pixel X et Y les position ablosue de l’image xposupdate et yposupdate indique si on doit modifier les position x et y qui serot utiliser pour le prochain tag (en gros pour mettre le texte a gauche ou en dessous). mouseover (je suis pas sur mais je crois que l’image est afficher seulement si on est au dessus, on reprend la position de l’image précédente)

<simage isize =“IS” tsize =“TS” size =“S” tid =“ID” xlen=“XL” ylen=“YL” name=“FICHIER” x=“X” y=“Y” mouseover=“0/1” xposupdate=“0/1” yposupdate=“0/1”></simage> Pour afficher une image dans une image style echiquier. IS taille de l’image TS taille d’un carreau S le zoom en pourcent 100 = taille d’un carreau Pour le reste voir <image>

<pos x=“X” y=“Y”> Déplace la position courante en X et Y

Images

Pour la manipulation des images, d’après ce que j’ai compris :

le simage permet de manipuler des bitmaps de style damier. Chaque items est a une position que l’on calcul en fonction de la taille de l’image et de la taille de chaque items.

La seconde est pour manipuler des images qui est composée de sous images qui ne sont pas forcement à des positions calculable. Alors on utilise la notation OpenGl des texture a l’aide de 2 “vecteurs” U et V. Cela s’appelle l’UV mapping. Regarde ce lien : http://www.linuxgraphic.org/section3d/o … idac3.html

Chaque coté de l’image représente une echelle de 0 à 1 et tu indique la position en floattant. par exemple : u=“0.0” v=“0.5” uend=“0.25” vend=“1.0”

Cela définit un rectangle le coin en haut a gauche est à (v * largeur image , u * hauteur de l’image) et le coin en bas a droit est a fin à (vend * largeur image , u * hauteur de l’image).

Le format d’image employer est du bitmap (Image.BMP) en 256 couleurs 8 bits sans aucune compression.

J’ai remarqué que cela marchait bien en 32*32, 256*256, 512*512, 256*128.

Lien Internet

Lien internet dans l’Al Manakh :

Commande de refraîchissement

Lorsque vous modifiez les fichiers XML de l’Al Manakh, il existe une commande pour appliquer la modification dans le client que vous avez d’ouvert, sans devoir le relancer. Une commande de rafraîchissement instantané de l’Al Manakh, donc.

La commande est &am_cmd.

Subversion

anonymous@undisclosed.example.com (Anonymous) — Sat, 13 Aug 2011 12:59:59 +0000

Subversion

Principes

SVN est un outil de gestion de versions de fichiers. Plus clairement dit, il permet de stocker de manière organisée un ensemble de fichiers, de mettre à jour ces fichiers et de récupérer les différentes versions de ces fichiers. Il gère les accès de manière sécurisée, donnant à chaque utilisateur défini des droits précis.

Dans le cadre du projet Landes Eternelles, son plus grand avantage est d’offrir la possibilité aux responsables de l’équipe de faire partager des fichiers et de travailler dessus à plusieurs, qu’il s’agisse de fichiers de code source, de fichiers graphiques,…

Subdivision

Le SVN client regroupe tout ce qui est nécessaire pour le client, tant les fichiers source que les fichiers de données. Il est en fait divisé en plusieurs parties : le code source du client lui-même, le code source de l’éditeur de cartes, les données du client.

Client SVN pour Windows

Pour pouvoir utiliser le SVN, le plus aisé, en particulier pour ceux qui utilisent Windows, est d’employer un client SVN, c’est à dire un petit programme que vous installez sur votre machine, qui vous permettra de gérer le SVN.

L’outil que je recommande pour Windows, que j’utilise et que je vais expliquer, est Tortoise.

Vous pouvez le télécharger à cette adresse (le premier lien suffit). Installez-le ensuite en suivant les instructions, qui n’ont rien de très particulier. Redémarrez ensuite la bête. Vous remarquerez que c’est bien installez, si en cliquant droit sur un fichier au hasard, vous avez, dans le menu qui apparaît, “Tortoise SVN” indiqué.

Checkout

La première chose à faire, c’est un “checkout”. Cette opération permet d’obtenir l’un des trois SVN en local sur votre machine : obtenir en fait la dernière version de tous les fichiers d’un des trois SVN.

Pour ce faire, cliquez droit n’importe où, sur votre bureau par exemple, et dans le menu déroulant, choisissez “SVN Checkout”.

Une fenêtre s’ouvre et vous demande d’indiquer deux choses :

Le SVN que vous voulez obtenir et son adresse (“URL of repository”)
- Pour le SVN client, indiquez svn://jeu.landes-eternelles.com:/NouveauClient

L’endroit où vous voulez que ça se trouve (“Checkout directory”)

Je vous conseille de créer un dossier particulier pour ça, car l’opération va créer, à l’endroit que vous choisissez, plusieurs dossiers.

Après avoir précisé ces deux choses, cliquez sur “Ok”. On va alors vous demander d’introduire votre login (anonyme) et mot de passe (anonyme), ce que vous faites docilement. L’opération se déroule alors tranquillement.

Update

La fonctionnalité du SVN que vous utiliserez le plus souvent (et que vous devez utiliser le plus souvent) est l’update. Cette opération permet d’actualiser la version du SVN que vous avez sur votre machine, avec la dernière version qui est sur le serveur.

Par exemple, si vous venez de faire un checkout et que deux jours après, l’un des membres de l’équipe change un fichier, la seule façon que vous avez de récupérer ce fichier changer, est d’effectuer un update. Ce que vous avez sur votre machine est synchronisé avec la dernière version. Cette opération correspond en fait à un download de fichiers à partir du serveur.

Pour ce faire, cliquez droit sur un fichier ou un dossier (je vous recommande de cliquer droit sur le dossier Trunk comme ça vous mettez tout à jour), et choisissez dans le menu “SVN update”. On vous demande alors votre login et mot de passe, vous l’indiquez et l’opération se fera toute seule, listant les fichiers qui ont changé ou vous disant que rien n’a été modifié.

A chaque fois que vous comptez modifier un fichier du SVN, je vous recommande de faire un update, pour être sûr que vous travaillez sur la dernière version.

Commit

Avec l’accès anonyme, il n’est pas possible de faire un commit, l’accès n’est qu’en lecture

Autres fonctionnalités

Le SVN permet toute une autre série de fonctionnalités, qu’il n’est pas utile de mettre par écrit. Je les ajouterai si jamais elles ont du succès et de l’utilité. Le SVN permet de récupérer des fichiers d’une ancienne version, de voire l’histoire des versions avec vos messages de commit,…

Signalez vos questions ou suggestions d’ajout à la suite de ce post it, je le modifierai en conséquence si nécessaire.

Clients SVN sous Linux

Alternatives

En ligne de commande, c’est donc subversion : aussi simple à utiliser que cvs.

Pour KDE : C’est eSVN Il existe 2 autres projets KDE : kdesvn et ksvn, ce dernier étant conçu comme tortoise (intégration). J’ai noté que ces 2 programmes ne font pas partie des paquets gentoo, et ksvn de la debian stable …

Pour Gnome : Rapidsvn, c’est le seul que j’ai trouvé. Il n’y a pas de module d’intégration pour nautilus, pour faire comme tortoise. A noter que les commentaires sur ce programme (sur le net) ne sont pas engageants.

Tutoriel

Voici un tutoriel rapide pour la ligne de commande pour la partie “Client”. Pour débuter voici 2 petites liens qui expliquent pas mal les choses :

Checkout

Pour faire le checkout obligatoire pour le début :

svn co svn://jeu.landes-eternelles.com:/NouveauClient

Cela va créer un répertoire NouveauClient avec une copie du SVN sur votre PC. Le login est “anonyme” et le mot de passe est “anonyme”.

Update

Si vous désirez mettre à jour votre copie locale, il faut taper :

svn update

Les fichiers modifiés vont être copiés sur votre PC et vous aurez donc la dernière version.

Remarques diverses

Sauts de lignes incohérents

Si vous avez des messages lorsque vous publiez vos modifications sur le serveur du type “sauts de lignes incohérents”, cela est en rapport avec la gestion du saut de ligne qui sont différents sous windows et linux.

Il faut donc que votre logiciel soit capable de gérer les 2 types de saut de ligne, car c’est le saut de ligne type “linux” qui est utilisé.