Revision as of 11:17, 26 December 2014

 

Home

 

Download

 

News

 

Support

 

Admin

 

Dev

 

Screen Shots

 

Grid List

 

Bugs

Languages:

English

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 :

• .NET Framework 4.0 pour Windows ou
• Mono pour Linux ou Mac. Mono 2.10.8 est la version minimum.

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 :

• Mono SDK depuis Page de téléchargement de Mono
• Le paquet MonoDevelop depuis la page de téléchargement de MonoDevelop
  • MonoDevelop est redirigé vers Xamarin Studio pour les téléchargement de Mc OS X (ndlr: je ne sais pas si j'ai bien traduit cette phrase)

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)

• Téléchargez Mono MDK depuis la page de téléchargement de Mono.

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.
  • libode.dylib http://cdnetworks-us-1.dl.sourceforge.net/project/opende/ODE/0.11.1/ode-0.11.1.zip
  • libopenjpeg-dotnet-2.1.3.0-dotnet-1.dylib (vérifier avec svn :)

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 mes commentaires disent que le plugin SQLite courant ne fonctionne pas pour OS X. Aussi vous pouvez corriger cela, ou installez MySQL, qui 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, download MySQL 5.1.40 for 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/frdu wiki.
• Lorsque votre simulateur sera opérationnel vous aurez l'invite "Region (<nom-de-la-region>) #"

Linux

Ubuntu

Debian

Fedora

CentOS, Redhat

openSUSE

FreeBSD

Configuration