Build Instructions/fr
From OpenSimulator
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 :
- .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
- 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).
- Ouvrez le fichier "OpenSim.sln" résultant dans un IDE Visual Studio.
- Compilez (ou déboguez) -> Build Solution.
Compiler en ligne de commande
- Lancez "runprebuild.bat".
- 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