Build Instructions/fr

From OpenSimulator

Jump to: navigation, search


Contents


Cette page couvre la compilation d'OpenSimulator à partir du code source pour plusieurs plateformes. S'il vous plaît, aidez-nous à garder cette page à jour pour au fur et à mesure que le projet progresse. Si vous voulez simplement lancer une instance d'OpenSimulator, téléchargez et lancez la version binaire à la place. Dans la plupart des cas, cette version fonctionne très bien.

Obtenir le code source

Allez à la page de téléchargement pour trouver des instructions et la dernière version du code source. Si vous voulez le code de développement courant,( comme par exemple la branche maître Git) allez à la page Developer_Documentation#Source_Code_Repository_Access.

Compiler

Autant cette page est longue, autant la compilation d'OpenSimulator est rapide. Reportez-vous au fichier BUILDING.txt inclus dans la distribution elle-même pour trouver des instructions simplifiées.

Microsoft Windows

Les versions OpenSimulator 0,8 et postérieure nécessitent soit :

Compilateurs supportés

  • Visual Studio 2010
  • Visual Studio 2008 peut être utilisé jusqu'à OpenSimulator 0.7.6 - le code développé actuellement requiert Visual Studio 2010 ou un compilateur qui peut compiler le code .NET 4.0.

Toutes les éditions de Visual Studio devraient fonctionner parfaitement, y compris l'édition libre Microsoft Visual C# Express.

Notez que les versions Visual Studio 2005 et antérieures ne sont plus supportées (opensim-dev proposal, opensim-dev approved).

Compiler dans un IDE

  1. Lancez "runprebuild.bat" ou "runprebuild2010.bat" (si vous utilisez Visual Studio 2010 avec le code source de OpenSimulator 0.7.6 ou de versions antérieures).
  2. Ouvrez le fichier "OpenSim.sln" résultant dans un IDE Visual Studio.
  3. Compilez (ou déboguez) -> Build Solution.

Compiler en ligne de commande

  1. Lancez "runprebuild.bat".
  2. Lancez le fichier "compile.bat" résultant ou lancez "nant". L'exécutable OpenSim.exe va être construit avec MSBuild (l'ancien) ou nant (le dernier).

Notes complémentaires

  • Vous pouvez lancer OpenSimulator sur Windows 64-bit (Vista, Windows 7 ...), mais si vous voulez le déboguer dans Visual Studio, vous devrez ajouter OpenSim.32BitLaunch à la solution et le définir comme début de projet. Voir OpenSimulator in Visual Studio on Win64@Tedds blog pour plus de details.
  • Pour ceux qui utilisent Cygwin shell, il faudra peut-être corriger les permissions des DLLs en tapant "chmod 755 *.dll *.exe" dans le répertoire bin.

Mac OS X

Mac OS X 10.5 et postérieur, Intel

La seule chose que vous ayez à faire est de télécharger :

et ensuite les installe. Il n'est pas nécessaire d'installer XCode et MacPort (bien que vous puissiez installer les bibliothèques mono dev et nant avec MacPort).

Quand vous lancez nano pour compiler OpenSimulator, l'erreur suivante peut s'afficher : "Unable to locate 'mono' module using pkg-config. Download the Mono development packages" (Impossible de localiser le module 'mono' avec pkg-config. Téléchargez les paquets de développement de Mono). Le rédacteur de l'article anglais suspecte XCode ou MacPort d'être à l'origine de cette erreur (depuis qu'il les a supprimés cela fonctionne mieux), mais il n'en est pas sur.

De toute façon, pour gérer le problème, inserrez une ligne dans le fichier du script /usr/bin/nant  :

#!/bin/sh
export PKG_CONFIG_PATH=/Library/Frameworks/Mono.framework/Libraries/pkgconfig    # ajoutez ceci!
exec /Library/Frameworks/Mono.framework/Versions/2.10.2/bin/mono \
    /Library/Frameworks/Mono.framework/Versions/2.10.2/share/NAnt/bin/NAnt.exe "$@"

Vous pouvez compiler et déboguer OpenSimulator avec l'IDE MonoDevelop après avoir lancé "runprebuild.sh". Ouvrez le fichier de la solution (*.sln) avec l'IDE MonoDevelop et sélectionnez Build -> Build All à partir du menu.

Compilation en ligne de commande (Mono 3.x)

Utilisez xbuild à la place de nant:

 ./runprebuild.sh
xbuild

Mac OS X 10.4/10.5 sur PowerPC

OpenSimulator peut être lancé sur PowerPC Macs (comme G4, G5). Les instructions qui suivent on été testées sur 10.5.8. Notez que les deux bibliothèques doivent aussi être compilées depuis la source.

Avertissement: l'application d'OpenSimulator n'a été que brièvement testée en mode autonome. Des problèmes peuvent survenir pour cette version. N' hésitez pas à noter toutes les questions que vous vous posez ici (ou dans une nouvelle page wiki? discussion?).

Malheureusement, la version d'OpenSimulator utilisée ici doit être compilée avec une version de Mono (2.6.7) et lancée avec une autre version (2.8.2). Cela signifie qu'il faut mettre à niveau Mono après l'avoir compilé, ou avoir deux versions installées en pouvant accéder à l'ancienne version pour la compilation. Les instructions qui suivent proposent d'avoir les deux versions installées.

  • Installez Xcode 3.1.4 Developer Tools depuis http://developer.apple.com/. Vous devez avoir un compte développeur Apple libre pour accéder au téléchargement. 3.1.4 est le dernier PowerPC Xcode.
  • (10.4 only) Installez X11 depuis les installations Optionelles (ou voir si c'est une option personnalisée quand vous installez Xcode). 10.5 installe X11 par défaut (depuis OS X ou dev tools?).
  • Installez Mono 2.6.7 PowerPC Framework depuis : http://www.go-mono.com/mono-downloads/download.html (OS X Framework binaire, ce n'est pas nécessaire de le compiler).
  • Ensuite, installez Mono 2.8.2 PowerPC framework. Pour que cela fonctionne vous devez installer 2.6.7, PUIS 2.8.2. (l'ancien framework n'est pas supprimé, mais les liens symboliques "Courants" sont mis à jour).
  • Téléchargez l'archive du code source OpenSimulator 0.7.0.2 : http://dist.opensimulator.org/opensim-0.7.0.2-source.tar.gz.
    • Vous pouvez utiliser une version plus récente d'OpenSimulator (le référentiel est sur git maintenant).
    • Si vous utilisez une nouvelle version d'OpenSimulator, vérifiez dans BUILDING.txt qu'il n'y a pas eu de changement dans les instructions de compilation (voir sous "Linux").
  • Editez ou créez .profile ou .bash_profile dans votre dossier home OS X, avec les lignes suivantes :
# rapel de real PATH
export OSIM_HACK_ORIG_PATH=$PATH

# chemin normal pour lancer OpenSimulator
export PATH=$PATH:/Library/Frameworks/Mono.framework/Versions/Current/bin:/usr/local/mysql/bin

# Seulement pour nant:
export PKG_CONFIG_PATH=/Library/Frameworks/Mono.framework/Versions/2.6.7/lib/pkgconfig
alias oldpath="export PATH=$OSIM_HACK_ORIG_PATH:/Library/Frameworks/Mono.framework/Versions/2.6.7/bin"

  • Ouvrez un nouveau terminal, et cd vers votre dossier décompressé d'OpenSimulator source (raccourci: tapez "cd " ensuite glissez le dossier dans le terminal). Ensuite entrez ces commandes:
oldpath
./runprebuild.sh
nant
  • nant doit mettre environ 10 minutes pour compiler votre OpenSimulator. Si vous y parvenez sans erreur, vous aurez fait la moitié du travail ! (L'auteur avait 234 warnings).
  • Important : Avant d'oublier, ouvrez un nouveau terminal (nécessaire pour éviter les effets de "oldpath").
  • Maintenant, nous avons besoin des versions PowerPC de deux bibliothèques. Compilez chacune d'elle et remplacez les fichiers compilés .dylib dans le dossier opensim/bin.
svn co http://libopenmetaverse.googlecode.com/svn/libopenmetaverse/trunk/openjpeg-dotnet libopenmetaverse-read-only
cd libopenmetaverse-read-only
    • Pour compiler, supprimez le fichier Makefile, qui concerne Linux, et renommez Makefile.osx simplement Makefile, ensuite lancez la commande : make )
    • Supprimez les autres versions des deux bibliothèques (mêmes noms et extensions différentes, par exemple "libode-x86_64.so". Deux libode et trois libopenjpeg).
  • Configurez votre sim: copiez OpenSim.ini.example vers OpenSim.ini et personnalisez-le.
  • De la même façon copiez et personnalisez StandaloneCommon.ini dans bin/config-include.
  • Notez que les commentaires disent que le plugin SQLite courant ne fonctionne pas pour OS X. Aussi vous pouvez corriger cela, ou installez MySQL, qui ne demande pas de compilation et qui est relativement simple à configurer :
    • Depuis http://downloads.mysql.com/archives.php?p=mysql-5.1&v=5.1.40, télécharger MySQL 5.1.40 pour 10.5 PowerPC (installateur, pas 64-bit)
    • Lancer l'installateur. (Qui installe vers /usr/local)
    • Installez MySQL.prefPane dans System Preferences en double cliquant dessus.
    • Ouvrez le panneau des préférences et lancez le serveur MySQL.
    • (Optionel: ) Pour un démarrage sans surveillance, installez MySQLStartupItem ( pour l'auteur ça ne fonctionne pas toujours).
    • (Recommandé : ) Dans un terminal, utiliser l'installation en une fois de MySQL avec cette commande : mysql_secure_installation
    • Dans MySQL, créez l'utilisateur opensim . Donnez-lui tous les privilèges de création.
      • Puisque nous sommes sous Mac, vous pouvez utiliser Sequel Pro (donationware) pour faire cela dans une jolie interface graphique. Pour une connexion standard, host: 127.0.0.1 (si vous êtes sur le même Mac).
  • Vous êtes prêt pour lancer OpenSimulator. Dans un nouveau terminal, cd vers votre dossier OpenSim-source/bin.
mono OpenSim.exe
  • Si tout se passe bien, vous serez invité à entrer le nom de votre région :"New region name []: "
  • Reportez-vous à "lancer OpenSimulator pour la première fois" sur la page Configuration/fr du wiki.
  • Lorsque votre simulateur sera opérationnel vous aurez l'invite "Region (<nom-de-la-region>) #"

Linux

Ubuntu

Pour les utilisateur des anciennes distributions d'Ubuntu (7.10, 8.04, 9.10 etc.) vous aurez besoin de mettre à niveau votre version de mono à au moins 2.4.3 pour OpenSimulator 0.7.6 et 2.10.8 les versions plus récentes d'OpenSimulator. Nous vous recommandons d'installer au moins Mono 2.10.8 dans tous les cas pour des raisons de performance. Pour ceux qui veulent mettre à niveau leur Mono, voir Update Mono on Ubuntu.

Ubuntu Karmic (9.10) comprend les paquets mono 2.4.2.3.

Ubuntu Lucid (10.04) comprend les paquets mono 2.4.4.

Ubuntu Maverick (10.10)comprend les paquets mono 2.6.7.

Ubuntu Natty (11.04) comprend les paquets mono 2.6.7.

Ubuntu Oneirc (11.10) à Salamander (13.10) comprennent les paquets mono 2.10.8.1.

Ubuntu Trusty (14.04) à Ubuntu Vivid (15.04) comprennent les paquets mono 3.2.8.

Ubuntu 10.04 et plus récents

Dans ces versions, il suffit d'installer mono-complète - toutes les dépêndances nécessaires seront installées. Ainsi, pour compiler tapez les commandes suivantes dans un terminal :

sudo apt-get install mono-complete
# télécharger opensim
cd opensim
./runprebuild.sh
xbuild

À partir des versions mono 2.6, xbuild a fonctionné relativement bien pour réaliser une compilation complète d'OpenSimulator. Depuis, xbuild est inclus dans le package Ubuntu mono-complete, vous n'avez pas besoin d'installer de paquets supplémentaire si vous n'avez pas de raison particulière d'utiliser nant à la place de xbuild. Il y a simplement deux systèmes de compilation différents qui invoque le même compilateur C# sur la base de deux formats de scripts de build différents.

Si vous voulez compiler OpenSimulator avec nant, alors vous devez installer le paquet apt-get nant et l'exécuter :

sudo apt-get install nant
nant

à la place de

xbuild

ensuite ./runprebuild.sh

Optionnel(pour les développeurs)

Pour exécuter la suite de tests de régression, vous devez aussi installer nunit-console, comme ceci :

sudo apt-get install nunit-console
nant test

Debian

Debian 4 (Etch) n'est plus supporté par debian.org. Mettez votre système à jour au moins à la version 5 (Lenny) avant de lancer OpenSimulator. Pour plus d'informations , voir Upgrades from previous release@debian.org ou pour une mise à niveau depuis Debian 6 ver Debian 7 la documentation en français Mises à niveau depuis Debian 6.0

Pour Debian 5 (Lenny) ou pour une version plus récente, tapez simplement :

sudo aptitude install nant

Avant de lancer runprebuild.sh et nant. Vous pouvez utiliser apt-get à la place d'aptitude. Les deux vont installer les dépendances.

Testé sur Debian 5 "Lenny" oldstable, Debian 6 "Squeeze" stable et Debian 7 "Wheezy" testing.

Fedora

Après avoir testé la distribution binaire d'OpenSimulator, vous devrez installer les bibliothèques de développement de mono et nant pour pouvoir compiler la source d'OpenSimulator. Pour cela voir les sections ci-dessous.

Trouver les bibliothèques de Mono

Si vous avez installé les paquets mono depuis le référentiel central de votre distribution quand vous utilisez la distribution binaire d'OpenSimulator, tapez simplement :

sudo yum install mono-devel

Sinon, taper (prérequis avoir mis à jour le géstionnaire yum pour mono) :

sudo yum install mono-addon-devel

Les deux commandes vont installer les dépendances nécessaires.

Installer NAnt

Lancez "yum info nant" pour trouver la version du paquet nant. Si vous avez trouvé le paquet tapez simplement :

sudo yum install nant

Maintenant, vous pouvez exécuter NAnt.

Si vous ne trouvez pas le paquet nant dans le gestionnaire yum, ou si vous pensez que la version du paquet est trop récente pour compiler OpenSimulator, installez NAnt depuis le site du projet NAnt. Consultez le manuel des utilisateurs pour avoir des instructions détaillées. Ainsi, pour la version 0.90, vous devrez créer un script de démarrage comme ceci (attendu que vous avez installé NAnt dans /usr/local/nant) :

sudo vi /usr/bin/nant

Ensuite dans ce fichier :

#!/bin/sh
exec mono /usr/local/nant/bin/NAnt.exe "$@"

Après cela, rendez le fichier exécutable :

sudo chmod +x /usr/bin/nant

CentOS, Redhat

Installer EPEL Repo

wget http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm
rpm -Uvh epel-release-6-8.noarch.rpm

Paquages nécessaires pour pour Mono et GID+

yum install bison gettext glib2 freetype fontconfig libpng libpng-devel libX11 \
libX11-devel glib2-devel libgdi* libexif glibc-devel urw-fonts \
unzip gcc gcc-c++ automake autoconf \ 
libtool make bzip2 wget  pixman-devel \ 
fontconfig-devel freetype-devel libexif-devel \
libjpeg-devel libtiff-devel  giflib-devel

Compiler Mono

ps: -j 2 nombre de processeurs (ou core)

cd /usr/local/src
wget http://download.mono-project.com/sources/mono/mono-3.0.4.tar.bz2
tar -jxvf mono-3.0.4.tar.bz2
cd mono-3.0.4
./configure --libdir=/usr/lib64
make -j 2 
make install

Installer GID+

ps: -j 2 equal number of processor (or core)

cd /usr/local/src
wget http://download.mono-project.com/sources/libgdiplus/libgdiplus-2.10.9.tar.bz2
tar -xvjf libgdiplus-2.10.9.tar.bz2
cd libgdiplus-2.10.9
./configure
make -j2 
make install

openSUSE

Taper simplement:

sudo zypper install nant

avant de lancer runprebuild.sh et nant. Cela installera aussi les dépendances nécessaires.

FreeBSD

FreeBSD, actuellement, n'est pas une plateforme supportée par OpenSimulator. Toutefois, il est possible de faire fonctionner OpenSimulator sur FreeBSD.

Pour FreeBSD 6.2 et versions plus récentes :

su
cd /usr/ports/devel/subversion/ && make install clean (you may also need to rebuild apr-svn if this step fails)
cd /usr/ports/lang/mono/ && make install clean
cd /usr/ports/devel/nant/ && make install clean
cd /usr/ports/databases/sqlite3/ && make install clean
cd /usr/ports/x11-toolkits/libgdiplus/ && make install clean
cd /opensim/installation/directory/
Download opensim
cd opensim
./runprebuild.sh
nant

Si vous optenez l'erreur "System.DllNotFoundException: libopenjpeg", suivez une de ces solutions (en relation avec la bibliothèque mentionnée dans le message d'erreur):

Pour le moteur ODE Physics vous devez suivre les indications ci-dessous :

cd /usr/ports/graphics/libGL/ && make install clean
cd /usr/ports/graphics/libGLU/ && make install clean
cd /opensim/installation/directory/
git clone git://opensimulator.org/git/opensim-libs
cd opensim-libs/trunk/unmanaged/OpenDynamicsEngine-r1755
sh autogen.sh
./configure --enable-shared --enable-release --disable-demos --without-x --enable-old-trimesh
make
cp ./ode/src/.libs/libode.so /opensim/installation/directory/opensim/bin/libode.so (32 bit)
cp ./ode/src/.libs/libode.so /opensim/installation/directory/opensim/bin/libode-x86_64.so (64 bit)

Configuration

Voir Configuration.

Personal tools
About This Wiki