Build Instructions/de

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
(Übersetzung der englischen Seite)
 
 
(39 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
{{Quicklinks}}
+
{{Quicklinks|Build_Instructions}}
  
 +
Diese Seite behandelt den Bau des OpenSimulators aus dem Quellcode für verschiedene Plattformen.
  
−
== Diese Seite ist gerade in Bearbeitung - bitte einen Moment Geduld ==
+
Bitte helfen Sie uns dabei, diese Seite auf dem neuesten Stand zu halten, während das Projekt fortschreitet.
  
 +
Wenn Sie nur den OpenSimulator ausführen möchten, laden Sie stattdessen die binäre Version herunter und führen Sie diese aus.
  
−
This page covers building OpenSimulator from source code on multiple platforms.  Please help us keep this page up to date as the project progresses. If you just want to run OpenSimulator, [[Download]] and [[Configuration|run]] the binary build instead. In the most cases, you should be fine with binaries.
+
In den meisten Fällen sollten die Binärdateien ausreichend sein.
  
−
= Obtaining the Source Code =
+
= Bezug des Quellcodes =
  
−
Check out the [[Download]] page for instructions on obtaining an OpenSimulator source release.  If you want the current development code (i.e. the Git master branch) see [[Developer_Documentation#Source_Code_Repository_Access]].
+
Schauen Sie auf der [[Download]]-Seite nach Anweisungen zum Bezug einer OpenSimulator-Quellcodeversion.  
  
−
= Building =
+
Wenn Sie den aktuellen Entwicklungscode möchten (d.h. den Git-Master-Branch), siehe [[Developer_Documentation#Source_Code_Repository_Access]].
  
−
Although this page is long, building is generally quite simple.  See the BUILDING.txt file in the distribution itself for simplified instructions.
+
= Erstellung =
  
−
== MS Windows ==
+
Obwohl diese Seite lang ist, ist das Erstellen im Allgemeinen recht einfach. Sehen Sie die BUILDING.txt-Datei in der Distribution selbst für vereinfachte Anweisungen.
  
−
OpenSimulator 0.8 and later requires either
+
== Version 0.9.3.0 und höher ==
−
* [http://msdn.microsoft.com/en-us/netframework/cc378097 .NET Framework 4.0] on Windows or
+
Microsoft hat die Entwicklung von .Net Framework und Mono eingestellt und durch das neue dotnet ersetzt. Dies ist eine bedeutende Änderung, der wir ab Version 0.9.3.0 folgen.
−
* [http://www.go-mono.com/mono-downloads/download.html Mono] on Linux or Mac.  Mono 2.10.8 is the minimum version.
+
  
−
=== Supported Compilers ===
+
=== Bezug des Quellcodes ===
−
* Visual Studio 2010
+
−
* Visual Studio 2008 up until OpenSimulator 0.7.6 - current development code requires Visual Studio 2010 or a compiler that can compile .NET 4.0 code.
+
−
:Any editions of Visual Studio should work just fine, including free editions [http://www.microsoft.com/express/downloads/ Microsoft Visual C# Express Edition].
+
−
:Note that Visual Studio 2005 or earlier are no longer supported([http://www.mail-archive.com/opensim-dev@lists.berlios.de/msg02674.html opensim-dev proposal], [http://www.mail-archive.com/opensim-dev@lists.berlios.de/msg02673.html opensim-dev approved]).
+
  
−
=== Compiling in an IDE ===
+
Holen oder aktualisieren Sie den Quellcode von Git.
−
# Run "runprebuild.bat" or "runprebuild2010.bat" (if using Visual Studio 2010 with OpenSimulator 0.7.6 source code or earlier).
+
−
# Open the resulting "OpenSim.sln" in any Visual Studio IDE.
+
−
# Build (or Debug) -> Build Solution.
+
  
−
===Compiling at the Command Prompt ===
+
git clone git://opensimulator.org/git/opensim
−
# Run "runprebuild.bat".
+
−
# Run the resulting "compile.bat" file or run "nant". This will build the executable using MSBuild (the former) or nan t(the latter).
+
  
−
=== Additional Notes ===
+
=== Erstellung unter Windows ===
 +
Um unter Windows zu erstellen, sind folgende Schritte erforderlich:
  
−
* You can run OpenSimulator on 64-bit Windows (Vista, Windows 7 ...) today, but if you want to debug it in Visual Studio, you'll need to add OpenSim.32BitLaunch to the solution and set it as startup project. See [http://blog.tedd.no/2008/12/05/opensim-in-visual-studio-on-win64/ OpenSimulator in Visual Studio on Win64@Tedds blog] for details.
+
    [https://dotnet.microsoft.com/en-us/download/dotnet/8.0 dotnet 8.0 SDK]
  
−
*For those that use a Cygwin shell, you may need to fix DLLs permissions issue by typing "<tt>chmod 755 *.dll *.exe</tt>" in the <tt>bin</tt> directory.
+
optional auch
  
−
== Mac OS X ==
+
    Visual Studio .NET, Version 2022 oder höher
  
−
=== Mac OS X 10.5 and later, Intel ===
+
Erstellen Sie die Projektdateien, indem Sie Folgendes ausführen:
  
−
Only you have to do is to get :
+
  runprebuild.bat
−
* Mono SDK from [http://www.go-mono.com/mono-downloads/download.html Mono Download Page]
+
−
* MonoDevelop package from [http://monodevelop.com/Download MonoDevelop Download Page]  ** MonoDevelop redirects to Xamarin Studio for Mc OS X downloads
+
−
and then install them - now no need to install XCode nor MacPort (you can still install mono dev libraries and nant with MacPort though).
+
  
−
When you run nano to build OpenSimulator, it may show an error like "Unable to locate 'mono' module using pkg-config. Download the Mono
+
Laden Sie die generierte OpenSim.sln in Visual Studio und erstellen Sie die Lösung, oder führen Sie einfach aus:
−
development packages". I suspect XCode or MacPort causes something wrong (since it worked fine after I removed both), but I'm not sure. Anyway, insert a line into '''/usr/bin/nant''' script file to manage this problem :
+
compile.bat
−
<pre>
+
−
#!/bin/sh
+
−
export PKG_CONFIG_PATH=/Library/Frameworks/Mono.framework/Libraries/pkgconfig    # add this!
+
−
exec /Library/Frameworks/Mono.framework/Versions/2.10.2/bin/mono \
+
−
    /Library/Frameworks/Mono.framework/Versions/2.10.2/share/NAnt/bin/NAnt.exe "$@"
+
−
</pre>
+
  
−
You can even compile and debug OpenSimulator with MonoDevelop IDE after running "runprebuild.sh". Open the solution file(*.sln) with MonoDevelop IDE then select Build -> Build All from the menu.
+
Für die Ausführung benötigen Sie möglicherweise auch:
  
−
=== Building from the command line (Mono 3.x) ===
+
* die [https://docs.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170 Laufzeitdateien für vc++] installieren
 +
* die Installation eines älteren .NetFramework 3.5 autorisieren
  
−
* Get Mono MDK from [http://www.mono-project.com/download/ Mono Download Page]
+
Konfigurieren Sie diesbezüglich. Siehe [[Configuration]].
−
Use xbuild instead of nant:
+
−
<pre>
+
−
./runprebuild.sh
+
−
xbuild
+
−
</pre>
+
  
−
=== Mac OS X 10.4/10.5 on PowerPC ===
+
Führen Sie nun einfach OpenSim.exe aus dem bin-Ordner aus und richten Sie die Region ein.
−
OpenSimulator can run on PowerPC Macs (such as G4, G5). These instructions were tested on 10.5.8.  Note that two libraries must also be built from source. Caveat: the OpenSimulator app was only briefly tested in self-contained mode. There may well be issues with this build. Feel free to note any issues you find below (or in a new wiki page? discussion?).  
+
  
−
Unfortunately, the OpenSimulator version used here must be compiled on one version of Mono (2.6.7) and run on another (2.8.2). This means either upgrading Mono after the build, or having both versions installed and accessing the older version when you want to build. These instructions let you have both versions installed.
+
=== Erstellung unter Linux / Mac ===
  
−
* Install Xcode 3.1.4 Developer Tools from from http://developer.apple.com/. You must have a free Apple developer account to access the downloads. 3.1.4 was the last PowerPC Xcode.
+
Sie benötigen:
  
−
* (10.4 only) Install X11 from the Optional Install (or see if it's a Customize option when you install Xcode). 10.5 gets X11 by default (''from OS X or dev tools?'').
+
    [https://dotnet.microsoft.com/en-us/download/dotnet/8.0 dotnet 8.0 SDK]
−
* Install Mono 2.6.7 PowerPC Framework from here: http://www.go-mono.com/mono-downloads/download.html (binary OS X Framework, no need to build from source)
+
* libgdiplus
−
* Then install Mono 2.8.2 PowerPC framework. For these instructions to work, you must first install 2.6.7, THEN 2.8.2. (The old framework is not deleted, but "Current" symlinks are updated).
+
** Wenn Sie bereits Mono 6.x komplett installiert haben, haben Sie bereits libgdiplus, andernfalls müssen Sie es mit einem Paketmanager für Ihr Betriebssystem installieren, z. B. apt, brew, macports usw. Zum Beispiel unter Debian:
−
* Download OpenSimulator 0.7.0.2 source tarball: http://dist.opensimulator.org/opensim-0.7.0.2-source.tar.gz Expand to a suitable folder for development and running.
+
*** apt-get update && apt-get install -y apt-utils libgdiplus libc6-dev
−
** Feel free to try a newer version of OpenSimulator (the repository is on git now).
+
−
** If you used a newer OpenSimulator version, check BUILDING.txt for any changes to build instructions (we fall under "Linux")
+
−
* Edit or create .profile or .bash_profile in your OS X home folder, with the following lines:
+
−
# remember real PATH
+
−
export OSIM_HACK_ORIG_PATH=$PATH
+
−
+
−
# normal path for running OpenSimulator
+
−
export PATH=$PATH:/Library/Frameworks/Mono.framework/Versions/Current/bin:/usr/local/mysql/bin
+
−
+
−
# Just for 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"
+
−
+
−
* Open a new Terminal window, and cd to your uncompressed OpenSimulator source folder (shortcut: type "cd " then drag the folder to the Terminal window). The enter these commands:
+
−
oldpath
+
−
./runprebuild.sh
+
−
nant
+
  
−
* nant should take around 10 minutes to compile your OpenSimulator. If you get through that without errors, you're halfway there! (I did get 234 warnings).
+
Erstellen Sie die Projektdateien, indem Sie Folgendes ausführen:
−
* *Important* Before we forget, open a new Terminal window (necessary to avoid the effects of "oldpath").
+
−
* Now we need PowerPC versions of two libraries. Build each one and replace the compiled .dylib files in the opensim/bin folder.
+
−
** 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 (checked out with svn:)
+
−
svn co http://libopenmetaverse.googlecode.com/svn/libopenmetaverse/trunk/openjpeg-dotnet libopenmetaverse-read-only
+
−
cd libopenmetaverse-read-only
+
−
** To build, remove the Makefile file, which is for Linux, and rename Makefile.osx to just Makefile, then give the command: make )
+
−
** Remove the other versions of the two libraries (similar names, different extensions, like "libode-x86_64.so". Two libode's and three libopenjpeg's).
+
−
* Configure your sim: Copy OpenSim.ini.example to OpenSim.ini and customize it per its comments.
+
−
* Likewise copy and customize StandaloneCommon.ini in bin/config-include
+
−
* Note that the comments say that the current SQLite plugin doesn't work on OS X. Either solve that, or install MySQL, which requires no compiling and is relatively easy to set up:
+
−
** From http://downloads.mysql.com/archives.php?p=mysql-5.1&v=5.1.40, download MySQL 5.1.40 for 10.5 PowerPC (installer, not 64-bit)
+
−
** Run the installer. (which installs to /usr/local)
+
−
** Install MySQL.prefPane into System Preferences by double-clicking it.
+
−
** Open the pref pane and start MySQL.
+
−
** (Optional:) For unattended startup, install MySQLStartupItem (doesn't always work for me).
+
−
** (Recommended:) In Terminal, do the one-time setup of MySQL with this command: mysql_secure_installation
+
−
** In MySQL, create the opensim user per the comments in OpenSim.ini. Give it all the create privileges.
+
−
*** Since this is a Mac, you could use Sequel Pro (donationware) to do that in a nice GUI. Standard connection, host: 127.0.0.1 (if on the same Mac)
+
−
* You're ready to run OpenSimulator. In that new Terminal window, cd to your OpenSim-source/bin folder.
+
−
mono OpenSim.exe
+
−
* If all is well, you will be prompted "New region name []: "
+
−
* Turn to "Running OpenSimulator for the first time" on wiki page [[Configuration]]
+
−
* When fully up and running, the prompt is "Region (<region-name>) #"
+
  
−
== Linux ==
+
  ./runprebuild.sh
  
−
=== Ubuntu ===
+
führen Sie dann aus:
  
−
For Ubuntu users on older distributions (7.10, 8.04, 9.10 etc.) '''you need''' to upgrade your version of mono to at least 2.4.3 for OpenSimulator 0.7.6 and 2.10.8 for the next OpenSimulator release.  We recommend updating to at least Mono 2.10.8 in any case for performance reasons. For anyone who needs to upgrade their Mono, see [[Update Mono on Ubuntu]].
+
  dotnet build --configuration Release OpenSim.sln
  
−
Ubuntu Karmic (9.10) includes mono 2.4.2.3 packages.
+
oder einfach:
  
−
Ubuntu Lucid (10.04) includes mono 2.4.4 packages.
+
  ./compile.sh
  
−
Ubuntu Maverick (10.10) includes mono 2.6.7 packages.
+
Konfigurieren Sie diesbezüglich. Siehe [[Configuration]].
  
−
Ubuntu Natty (11.04) includes mono 2.6.7 packages.
+
Führen Sie ./opensim.sh aus dem bin-Ordner aus und richten Sie die Region ein
  
−
Ubuntu Oneirc (11.10) to Salamander (13.10) include the mono 2.10.8.1 packages.
+
== Ältere Versionen ==
 +
  Der Quellcode für alte .Net Framework 4.x und Mono befindet sich im Branch Mono-Net4X.  
 +
  Dies ist größtenteils derselbe Code wie bei der Veröffentlichung von 0.9.2.2.
  
−
Ubuntu Trusty (14.04) to Ubuntu Vivid (15.04) include the mono 3.2.8 packages.
+
== Anforderungen ==
  
−
==== Ubuntu 10.04 and later ====
+
OpenSimulator 0.9.0.x erfordert entweder
  
−
In this version, one only needs to install mono-complete - this will pull down all the other required packages as dependencies. Thus, to build:
+
* [http://msdn.microsoft.com/en-us/netframework/cc378097 .NET Framework 4.0] unter Windows
 +
* [https://www.mono-project.com/download/stable/ Mono] unter Linux oder Mac. Mono 2.10.8 ist die Mindestversion.
 +
    Sie benötigen möglicherweise auch das nant-Tool.
  
−
sudo apt-get install mono-complete
+
OpenSimulator >= 0.9.1 (einschließlich des aktuellen Master) erfordert
−
# [[Download]] opensim
+
−
cd opensim
+
−
./runprebuild.sh
+
−
xbuild
+
  
−
As of mono 2.6 series, xbuild works well enough to drive a complete build of OpenSimulator. Since xbuild is included within the '''mono-complete''' package on Ubuntu, you don't have to install any additional packages if you don't have any particular reason to prefer nant over xbuild. They are just two different build systems that invoke the same C# compiler based on two different build script formats.
+
* [http://msdn.microsoft.com/en-us/netframework/cc378097 .NET Framework 4.6] unter Windows
 +
* [https://www.mono-project.com/download/stable/ Mono] unter Linux oder Mac. Mono 5.12 ist die empfohlene Mindestversion.<br>'''Hinweis:''' Verwenden Sie nicht die Mono-Pakete Ihrer Linux-Distribution, da möglicherweise erforderliche Komponenten fehlen. Bitte [https://www.mono-project.com/download/stable/ installieren Sie sie aus dem offiziellen Mono-Repo Ihrer Distribution].
 +
    Es wird empfohlen, mit msbuild zu kompilieren.
  
−
If you do want to build using nant, then you will need to install the '''nant''' apt-get package and execute
+
Andere Plattformen haben möglicherweise eigene Mono-Distributionen, oder Sie müssen Mono darauf kompilieren.
  
−
sudo apt-get install nant
+
Andere von OpenSimulator verwendete Bibliotheken finden Sie in unserem opensim-libs-Git-Repository:
−
nant
+
  
−
instead of
+
git clone git://opensimulator.org/git/opensim-libs
  
−
xbuild
+
Verwendetes libOpenMetaVerse finden Sie unter https://bitbucket.org/opensimulator/
  
−
after ./runprebuild.sh
+
Möglicherweise müssen Sie sie für Ihre Plattform kompilieren, insbesondere die nicht verwalteten wie Bullet oder ODE-Native-Code-Bibliotheken
  
−
'''OPTIONAL (for developers):''' To run the regression test suite, you will also need to install nunit-console, like so
+
== MS Windows ==
  
−
sudo apt-get install nunit-console
+
=== Unterstützte Compiler ===
−
nant test
+
  
−
{{anchor|CentOS}}{{anchor|RedHat}}{{anchor|RHEL}}{{anchor|Fedora}}
+
* [https://visualstudio.microsoft.com/downloads/ Visual Studio Community 2017]
 +
* Oder jede Version, die die entsprechende .Net-Version unterstützt. Mindestens VS2010 für Versionen vor 0.91, VS2015 für 0.91 und später.
 +
* OpenSimulator >=0.9.2.0 kann für .Net Framework 4.8 kompilieren, indem runprebuild48.bat anstelle von runprebuild.bat unten verwendet wird und mit VS2017/19/22
  
−
=== Debian ===
+
=== Kompilierung in einer IDE ===
 +
* Führen Sie "runprebuild.bat" aus.
 +
* Öffnen Sie die resultierende "OpenSim.sln" in der Visual Studio IDE.
 +
* Wählen Sie Debug- oder Release-Konfiguration
 +
* Menü Build -> Build Solution.
  
−
Debian 4 (Etch) is no longer supported by debian.org. Update at least to 5 (Lenny) before running OpenSimulator. See [http://www.debian.org/releases/lenny/i386/release-notes/ch-upgrading.html Upgrades from previous release@debian.org] for detail.
+
=== Kompilierung an der Eingabeaufforderung ===
 +
* Führen Sie "runprebuild.bat" aus.
 +
* Führen Sie die resultierende Datei "compile.bat" aus.
  
−
For Debian 5 (Lenny) or later, just type:
+
== Linux und andere Mono-Plattformen ==
−
<pre>
+
−
sudo aptitude install nant
+
−
</pre>
+
−
before run runprebuild.sh and nant. You can even use apt-get instead of aptitude. They both will also install dependent packages.
+
  
−
Tested on Debian 5 "Lenny" ''oldstable'', Debian 6 "Squeeze" ''stable'' and Debian 7 "Wheezy" ''testing''.
+
=== Vorbereitung für die Kompilierung ===
 +
Um die verschiedenen Projektdateien zu erstellen, führen Sie im Ordner opensim aus:
  
−
===  Fedora ===
+
  ./runprebuild.sh
  
−
After getting run your OpenSimulator binary distributions, you'll need to get mono development library and install nant to build OpenSimulator from the source. See both sections below.
+
==== Kompilieren mit Nant ====
 +
Auf einigen Mono-Versionen, insbesondere auf alten, kann es erforderlich sein, nant zum ordnungsgemäßen Kompilieren von OpenSimulator zu verwenden. Führen Sie in diesem Fall einfach aus:
  
−
==== Getting Mono Libraries ====
+
  nant
  
−
If you have installed mono packages from the core repository for your distributions [[Dependencies#RedHat|when you run OpenSim.exe binary distribusion]], just type:
+
==== Kompilieren mit xbuild ====
−
<pre>
+
−
sudo yum install mono-devel
+
−
</pre>
+
  
−
If not, just type (given that [[Dependencies#Installing from Mono Repository|you have already set up yum repository for mono]]) :
+
Auf Mono-Versionen können Sie einfach xbuild verwenden. ''(msbuild wird ab 0.9.1.0.0 empfohlen)''
−
<pre>
+
−
sudo yum install mono-addon-devel
+
−
</pre>
+
  
−
Both command will install its dependencies as well.
+
  xbuild
  
−
==== Installing NAnt ====
+
xbuild wird auf Mono 5.x nicht mehr empfohlen, funktioniert jedoch derzeit noch (5.12)
  
−
Run "yum info nant" to check the version of nant package. If you find the package, then just type:
+
''>>>> xbuild-Tool ist veraltet und wird in zukünftigen Updates entfernt, verwenden Sie stattdessen msbuild <<<<''
−
<pre>
+
−
sudo yum install nant
+
−
</pre>
+
−
You can now run nant out-of-the-box.
+
  
 +
Auf neueren Mono-Versionen kann die Release-Konfiguration einige Leistungsvorteile bringen, aber Sie verlieren einige Debug-Fähigkeiten.
 +
zum Kompilieren der Release-Konfiguration:
 +
  xbuild /p:Configuration=Release
  
−
If you can't find nant package in yum repository, or you feel its version is too early for building OpenSimulator, obtain NAnt from [http://nant.sourceforge.net/ NAnt Project Site]. See User Manual there for detailed instruction. As of 0.90, you will need to create startup script like that (given you have expanded NAnt to /usr/local/nant) :
+
==== Kompilieren mit msbuild ====
−
<pre>
+
Für Opensim 0.9.1 können Sie immer noch xbuild verwenden, aber Mono empfiehlt die Verwendung von msbuild. Sie müssen möglicherweise das Paket msbuild zusätzlich zu mono-complete installieren. (Aktuell ist msbuild in mono-complete enthalten, auf Ubuntu, aus den offiziellen Mono-Repositories. https://www.mono-project.com/download/stable/#download-lin )
−
sudo vi /usr/bin/nant
+
−
</pre>
+
−
Then inside this file :
+
−
<pre>
+
−
#!/bin/sh
+
−
exec mono /usr/local/nant/bin/NAnt.exe "$@"
+
−
</pre>
+
−
After that, make it executable :
+
−
<pre>
+
−
sudo chmod +x /usr/bin/nant
+
−
</pre>
+
  
−
You can now run runprebuild.sh and nant to compile OpenSimulator.
+
Verwenden Sie xbuild in den anderen Fällen als letztes Mittel.
  
 +
Neuere Verbesserungen, insbesondere am JIT-Laufzeitmodus, rechtfertigen das Kompilieren in der Release-Konfiguration, aber Sie verlieren einige Debug-Fähigkeiten.
  
−
===  CentOS, Redhat ===
+
für die Kompilierung mit Debug-Konfiguration:
 +
  msbuild
  
−
==== Install EPEL Repo ====
+
für die Kompilierung mit Release-Konfiguration:
 +
  msbuild /p:Configuration=Release
  
−
<pre>
+
für die Kompilierung mit der Debug-Konfiguration und der detaillierten opensim.log-Datei, die dann mit einem Texteditor gelesen werden kann:
−
wget http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm
+
  msbuild /p:Configuration=Debug /fileLogger /flp:logfile=opensim.log /v:d
−
rpm -Uvh epel-release-6-8.noarch.rpm
+
−
</pre>
+
  
−
==== Pre-required Package for Mono and GID+ ====
+
Sie können die folgenden Werte für die Detailstufe der opensim.log-Datei angeben:
 +
  q [leise], m [minimal], n [normal], d [detailliert] und diag [diagnostisch].
  
−
<pre>
+
Um für .Net Framework 4.8 mit Mono >=6.12 zu kompilieren, können Sie runprebuild48.sh anstelle von runprebuild.sh oben ausführen. Dabei wird nicht viel gewonnen.
−
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
+
−
</pre>
+
  
−
==== Mono compilation ====
+
== Ahead-of-Time-Kompilierung (AOT)==
 +
Wie Sie alle wissen, enthalten die durch den Kompilierungsprozess oben erstellten Dateien *.exe und .dll keinen nativen Code für die Maschine.<br>
 +
Mit diesen Dateien wird der native Code, den die CPU benötigt, bei Bedarf zur Laufzeit erstellt, in einem Prozess, der als Just-in-Time (JIT) bekannt ist.<br>
 +
Es ist möglich, einen weiteren Kompilierungsschritt für diese Dateien durchzuführen, um nativen Code zu erstellen, der bereit ist, wenn das Programm startet. Dies ist der AOT-Prozess (Ahead of time).<br>
 +
Da JIT zur Laufzeit durchgeführt wird, hat es nur begrenzte Zeit für umfangreiche Codeoptimierungen. AOT kann andererseits alles tun.<br>
 +
AOT sollte auf diese Weise schneller geladen werden, etwas den Speicherbedarf der JIT-Arbeit sparen und die Latenz durch Codegenerierung verringern, wenn ein neuer Codeabschnitt benötigt wird.<br>
 +
Auf diese Weise hilft AOT, die enorme Leistungslücke zwischen C# und einer geeigneteren Sprache wie C++ zu verringern, auch wenn JIT einige Optimierungen abhängig vom aktuellen Codeausführungszustand durchführen kann, die AOT nicht kann. (Wenn Sie denken, dass C# genauso schnell ist wie kompetenter C++-Code, sollten Sie besser ändern, was Sie rauchen...)<br>
 +
Tatsächlich führen sowohl .NET als auch Mono AOT bei ihren Komponenten während der Installation durch.<br>
 +
JIT wird weiterhin aktiv sein und einige andere Codes zur Laufzeit kompilieren. OpenSim und verwendete .NET/Mono-Frameworkteile sind darauf angewiesen.<br>
  
−
ps: -j 2 equal number of processor (or core)
+
Für Linux enthält 0.9.2.0 jetzt Skripte makeaot.sh und cleanaot.sh, um AOT-Tests zu erleichtern.<br>
 +
Führen Sie makeaot.sh nach dem oben genannten Kompilierungsschritt aus, um die nativen Code-Dateien zu generieren. Die Option -O=all muss zu mono hinzugefügt werden, wenn opensim.exe ausgeführt wird, z.B.:<br>
 +
  mono --desktop -O=all OpenSim.exe
 +
Das Skript cleanaot.sh entfernt die von AOT verwendeten Binärdateien. Sie müssen es ausführen, wenn Sie den Code neu kompilieren (um sicher zu sein, auch wenn Sie makeaot ausführen).<br>
 +
<b>VERGESSEN SIE NICHT, makeaot.sh oder cleanaot.sh nach dem Neukompilieren auszuführen!</b><br>
 +
Die generierten Dateien sind spezifisch für diese Maschine. <b>Kopieren Sie die nativen Code-Dateien nicht auf andere Maschinen, es sei denn, sie sind absolut identisch</b><br>
 +
Die Original-.exe- und .dll-Dateien sind weiterhin erforderlich.<br>
  
−
<pre>
+
AOT ist auch unter Windows möglich, jedoch mit anderen Tools, die Dinge zum zentralen Repository auf der Maschine hinzufügen, schwerer zu isolieren und zu pflegen. siehe [https://docs.microsoft.com/en-us/dotnet/framework/tools/ngen-exe-native-image-generator ngen]<br>
−
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
+
−
</pre>
+
  
−
==== Install GID+ ====
+
Macs sind.. Macs.. Zukünftige Modelle können JIT vollständig verbieten, wie es bei Apple-Mobilprodukten der Fall ist. Mono AOT auf aktuellen Macs funktioniert möglicherweise wie auf Linux<br>
−
ps: -j 2 equal number of processor (or core)
+
  
−
<pre>
+
In der praktischen Anwendung erwarten Sie nicht viel mehr als etwas schnellere Ladezeiten.<br>
−
cd /usr/local/src
+
Da die Kompilierung jedoch unterschiedlich ist, können neue Probleme auftreten. Testen Sie also sorgfältig.<br>
−
wget http://download.mono-project.com/sources/libgdiplus/libgdiplus-2.10.9.tar.bz2
+
OpenSim-Leistungsprobleme sind größtenteils auf den eigenen Code zurückzuführen, schrecklich schlechte Kommunikationsprotokolle, Verwendung von schlechtem .NET/Mono-Framework-Code (in einigen Fällen Demo-Qualität), usw.<br>
−
tar -xvjf libgdiplus-2.10.9.tar.bz2
+
Und natürlich immer kaputte GC<br>
−
cd libgdiplus-2.10.9
+
Aber... nun ja, jede ns zählt..<br>
−
./configure
+
−
make -j2
+
−
make install
+
−
</pre>
+
  
−
=== openSUSE ===
+
= Konfiguration =
  
−
Just type:
+
Siehe [[Configuration]].
−
<pre>
+
−
sudo zypper install nant
+
−
</pre>
+
−
before run runprebuild.sh and nant. It will also install dependent packages.
+
−
 
+
−
== FreeBSD ==
+
−
 
+
−
FreeBSD is not currently a supported platform for OpenSimulator.  However, it is possible to get OpenSimulator running on FreeBSD.
+
−
 
+
−
On FreeBSD 6.2 and later
+
−
 
+
−
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
+
−
 
+
−
If you get "System.DllNotFoundException: libopenjpeg" errors, follow one of these fixes (depending of the lib appearing in the error message):
+
−
* [[Troubleshooting#System.DllNotFoundException:_lib32.2Flibopenjpeg-dotnet-2.1.3.0-dotnet-1-i686|libopenjpeg-mono]]
+
−
* [[Troubleshooting#System.DllNotFoundException:_..2Flibopenjpeg-libsl-2.1.2.0.so|libopenjpeg-libsl]]
+
−
 
+
−
For ODE Physics you must do the following:
+
−
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 =
+
−
 
+
−
See [[Configuration]].
+
  
 
[[Category:Users]]
 
[[Category:Users]]
 
[[Category:Users]]
 
[[Category:Users]]
 
[[Category:Getting Started]]
 
[[Category:Getting Started]]
 +
 +
[[Category:German Translations]]

Latest revision as of 02:00, 23 April 2024

Languages Languages: 

En.png English   De.png Deutsch   Fr.png Français   Jp.png 日本語

Diese Seite behandelt den Bau des OpenSimulators aus dem Quellcode für verschiedene Plattformen.

Bitte helfen Sie uns dabei, diese Seite auf dem neuesten Stand zu halten, während das Projekt fortschreitet.

Wenn Sie nur den OpenSimulator ausführen möchten, laden Sie stattdessen die binäre Version herunter und führen Sie diese aus.

In den meisten Fällen sollten die Binärdateien ausreichend sein.

Contents

[edit] Bezug des Quellcodes

Schauen Sie auf der Download-Seite nach Anweisungen zum Bezug einer OpenSimulator-Quellcodeversion.

Wenn Sie den aktuellen Entwicklungscode möchten (d.h. den Git-Master-Branch), siehe Developer_Documentation#Source_Code_Repository_Access.

[edit] Erstellung

Obwohl diese Seite lang ist, ist das Erstellen im Allgemeinen recht einfach. Sehen Sie die BUILDING.txt-Datei in der Distribution selbst für vereinfachte Anweisungen.

[edit] Version 0.9.3.0 und höher

Microsoft hat die Entwicklung von .Net Framework und Mono eingestellt und durch das neue dotnet ersetzt. Dies ist eine bedeutende Änderung, der wir ab Version 0.9.3.0 folgen.

[edit] Bezug des Quellcodes

Holen oder aktualisieren Sie den Quellcode von Git.

git clone git://opensimulator.org/git/opensim

[edit] Erstellung unter Windows

Um unter Windows zu erstellen, sind folgende Schritte erforderlich: 

   dotnet 8.0 SDK

optional auch 

   Visual Studio .NET, Version 2022 oder höher

Erstellen Sie die Projektdateien, indem Sie Folgendes ausführen: 

  runprebuild.bat

Laden Sie die generierte OpenSim.sln in Visual Studio und erstellen Sie die Lösung, oder führen Sie einfach aus: compile.bat

Für die Ausführung benötigen Sie möglicherweise auch:

Konfigurieren Sie diesbezüglich. Siehe Configuration.

Führen Sie nun einfach OpenSim.exe aus dem bin-Ordner aus und richten Sie die Region ein.

[edit] Erstellung unter Linux / Mac

Sie benötigen: 

   dotnet 8.0 SDK
  • libgdiplus
    • Wenn Sie bereits Mono 6.x komplett installiert haben, haben Sie bereits libgdiplus, andernfalls müssen Sie es mit einem Paketmanager für Ihr Betriebssystem installieren, z. B. apt, brew, macports usw. Zum Beispiel unter Debian:
      • apt-get update && apt-get install -y apt-utils libgdiplus libc6-dev

Erstellen Sie die Projektdateien, indem Sie Folgendes ausführen: 

  ./runprebuild.sh

führen Sie dann aus: 

  dotnet build --configuration Release OpenSim.sln

oder einfach: 

  ./compile.sh

Konfigurieren Sie diesbezüglich. Siehe Configuration.

Führen Sie ./opensim.sh aus dem bin-Ordner aus und richten Sie die Region ein

[edit] Ältere Versionen 

  Der Quellcode für alte .Net Framework 4.x und Mono befindet sich im Branch Mono-Net4X. 
  Dies ist größtenteils derselbe Code wie bei der Veröffentlichung von 0.9.2.2.

[edit] Anforderungen

OpenSimulator 0.9.0.x erfordert entweder 

   Sie benötigen möglicherweise auch das nant-Tool.

OpenSimulator >= 0.9.1 (einschließlich des aktuellen Master) erfordert 

   Es wird empfohlen, mit msbuild zu kompilieren.

Andere Plattformen haben möglicherweise eigene Mono-Distributionen, oder Sie müssen Mono darauf kompilieren.

Andere von OpenSimulator verwendete Bibliotheken finden Sie in unserem opensim-libs-Git-Repository:

git clone git://opensimulator.org/git/opensim-libs

Verwendetes libOpenMetaVerse finden Sie unter https://bitbucket.org/opensimulator/

Möglicherweise müssen Sie sie für Ihre Plattform kompilieren, insbesondere die nicht verwalteten wie Bullet oder ODE-Native-Code-Bibliotheken

[edit] MS Windows

[edit] Unterstützte Compiler

  • Visual Studio Community 2017
  • Oder jede Version, die die entsprechende .Net-Version unterstützt. Mindestens VS2010 für Versionen vor 0.91, VS2015 für 0.91 und später.
  • OpenSimulator >=0.9.2.0 kann für .Net Framework 4.8 kompilieren, indem runprebuild48.bat anstelle von runprebuild.bat unten verwendet wird und mit VS2017/19/22

[edit] Kompilierung in einer IDE

  • Führen Sie "runprebuild.bat" aus.
  • Öffnen Sie die resultierende "OpenSim.sln" in der Visual Studio IDE.
  • Wählen Sie Debug- oder Release-Konfiguration
  • Menü Build -> Build Solution.

[edit] Kompilierung an der Eingabeaufforderung

  • Führen Sie "runprebuild.bat" aus.
  • Führen Sie die resultierende Datei "compile.bat" aus.

[edit] Linux und andere Mono-Plattformen

[edit] Vorbereitung für die Kompilierung

Um die verschiedenen Projektdateien zu erstellen, führen Sie im Ordner opensim aus: 

  ./runprebuild.sh

[edit] Kompilieren mit Nant

Auf einigen Mono-Versionen, insbesondere auf alten, kann es erforderlich sein, nant zum ordnungsgemäßen Kompilieren von OpenSimulator zu verwenden. Führen Sie in diesem Fall einfach aus: 

  nant

[edit] Kompilieren mit xbuild

Auf Mono-Versionen können Sie einfach xbuild verwenden. (msbuild wird ab 0.9.1.0.0 empfohlen) 

  xbuild

xbuild wird auf Mono 5.x nicht mehr empfohlen, funktioniert jedoch derzeit noch (5.12)

>>>> xbuild-Tool ist veraltet und wird in zukünftigen Updates entfernt, verwenden Sie stattdessen msbuild <<<<

Auf neueren Mono-Versionen kann die Release-Konfiguration einige Leistungsvorteile bringen, aber Sie verlieren einige Debug-Fähigkeiten. zum Kompilieren der Release-Konfiguration: 

  xbuild /p:Configuration=Release

[edit] Kompilieren mit msbuild

Für Opensim 0.9.1 können Sie immer noch xbuild verwenden, aber Mono empfiehlt die Verwendung von msbuild. Sie müssen möglicherweise das Paket msbuild zusätzlich zu mono-complete installieren. (Aktuell ist msbuild in mono-complete enthalten, auf Ubuntu, aus den offiziellen Mono-Repositories. https://www.mono-project.com/download/stable/#download-lin )

Verwenden Sie xbuild in den anderen Fällen als letztes Mittel.

Neuere Verbesserungen, insbesondere am JIT-Laufzeitmodus, rechtfertigen das Kompilieren in der Release-Konfiguration, aber Sie verlieren einige Debug-Fähigkeiten.

für die Kompilierung mit Debug-Konfiguration: 

  msbuild

für die Kompilierung mit Release-Konfiguration: 

  msbuild /p:Configuration=Release

für die Kompilierung mit der Debug-Konfiguration und der detaillierten opensim.log-Datei, die dann mit einem Texteditor gelesen werden kann: 

  msbuild /p:Configuration=Debug /fileLogger /flp:logfile=opensim.log /v:d

Sie können die folgenden Werte für die Detailstufe der opensim.log-Datei angeben: 

  q [leise], m [minimal], n [normal], d [detailliert] und diag [diagnostisch].

Um für .Net Framework 4.8 mit Mono >=6.12 zu kompilieren, können Sie runprebuild48.sh anstelle von runprebuild.sh oben ausführen. Dabei wird nicht viel gewonnen.

[edit] Ahead-of-Time-Kompilierung (AOT)

Wie Sie alle wissen, enthalten die durch den Kompilierungsprozess oben erstellten Dateien *.exe und .dll keinen nativen Code für die Maschine.
Mit diesen Dateien wird der native Code, den die CPU benötigt, bei Bedarf zur Laufzeit erstellt, in einem Prozess, der als Just-in-Time (JIT) bekannt ist.
Es ist möglich, einen weiteren Kompilierungsschritt für diese Dateien durchzuführen, um nativen Code zu erstellen, der bereit ist, wenn das Programm startet. Dies ist der AOT-Prozess (Ahead of time).
Da JIT zur Laufzeit durchgeführt wird, hat es nur begrenzte Zeit für umfangreiche Codeoptimierungen. AOT kann andererseits alles tun.
AOT sollte auf diese Weise schneller geladen werden, etwas den Speicherbedarf der JIT-Arbeit sparen und die Latenz durch Codegenerierung verringern, wenn ein neuer Codeabschnitt benötigt wird.
Auf diese Weise hilft AOT, die enorme Leistungslücke zwischen C# und einer geeigneteren Sprache wie C++ zu verringern, auch wenn JIT einige Optimierungen abhängig vom aktuellen Codeausführungszustand durchführen kann, die AOT nicht kann. (Wenn Sie denken, dass C# genauso schnell ist wie kompetenter C++-Code, sollten Sie besser ändern, was Sie rauchen...)
Tatsächlich führen sowohl .NET als auch Mono AOT bei ihren Komponenten während der Installation durch.
JIT wird weiterhin aktiv sein und einige andere Codes zur Laufzeit kompilieren. OpenSim und verwendete .NET/Mono-Frameworkteile sind darauf angewiesen.

Für Linux enthält 0.9.2.0 jetzt Skripte makeaot.sh und cleanaot.sh, um AOT-Tests zu erleichtern.
Führen Sie makeaot.sh nach dem oben genannten Kompilierungsschritt aus, um die nativen Code-Dateien zu generieren. Die Option -O=all muss zu mono hinzugefügt werden, wenn opensim.exe ausgeführt wird, z.B.:

  mono --desktop -O=all OpenSim.exe

Das Skript cleanaot.sh entfernt die von AOT verwendeten Binärdateien. Sie müssen es ausführen, wenn Sie den Code neu kompilieren (um sicher zu sein, auch wenn Sie makeaot ausführen).
VERGESSEN SIE NICHT, makeaot.sh oder cleanaot.sh nach dem Neukompilieren auszuführen!
Die generierten Dateien sind spezifisch für diese Maschine. Kopieren Sie die nativen Code-Dateien nicht auf andere Maschinen, es sei denn, sie sind absolut identisch
Die Original-.exe- und .dll-Dateien sind weiterhin erforderlich.

AOT ist auch unter Windows möglich, jedoch mit anderen Tools, die Dinge zum zentralen Repository auf der Maschine hinzufügen, schwerer zu isolieren und zu pflegen. siehe ngen

Macs sind.. Macs.. Zukünftige Modelle können JIT vollständig verbieten, wie es bei Apple-Mobilprodukten der Fall ist. Mono AOT auf aktuellen Macs funktioniert möglicherweise wie auf Linux

In der praktischen Anwendung erwarten Sie nicht viel mehr als etwas schnellere Ladezeiten.
Da die Kompilierung jedoch unterschiedlich ist, können neue Probleme auftreten. Testen Sie also sorgfältig.
OpenSim-Leistungsprobleme sind größtenteils auf den eigenen Code zurückzuführen, schrecklich schlechte Kommunikationsprotokolle, Verwendung von schlechtem .NET/Mono-Framework-Code (in einigen Fällen Demo-Qualität), usw.
Und natürlich immer kaputte GC
Aber... nun ja, jede ns zählt..

[edit] Konfiguration

Siehe Configuration.

Retrieved from "http://opensimulator.org/index.php?title=Build_Instructions/de&oldid=54216"
Personal tools
General
About This Wiki