Build Instructions/de

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
(Kompilieren an der Eingabeaufforderung)
 
(26 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Quicklinks}}
+
{{Quicklinks|Build_Instructions}}
  
Diese Seite behandelt den Aufbau von OpenSimulator aus Quellcode auf mehreren Plattformen. Bitte helfen Sie uns, diese Seite im Laufe des Projekts auf dem neuesten Stand zu halten. Wenn Sie nur OpenSimulator ausführen möchten, laden Sie stattdessen den binären Build [[Download]] und [[Configuration|run]] . In den meisten Fällen sollten Sie Binärdateien verwenden.
+
Diese Seite behandelt den Bau des OpenSimulators aus dem Quellcode für verschiedene Plattformen.  
  
= Beziehen des Quellcodes =
+
Bitte helfen Sie uns dabei, diese Seite auf dem neuesten Stand zu halten, während das Projekt fortschreitet.
  
Auf der [[Download]] Seite finden Sie Anweisungen zum Abrufen einer OpenSimulator-Quellversion. Wenn Sie den aktuellen Entwicklungscode (dh den Git-Master-Zweig) möchten, finden Sie ihn unter [[Developer_Documentation#Source_Code_Repository_Access]].
+
Wenn Sie nur den OpenSimulator ausführen möchten, laden Sie stattdessen die binäre Version herunter und führen Sie diese aus.  
  
= Erstellen =
+
In den meisten Fällen sollten die Binärdateien ausreichend sein.
  
 +
= Bezug des Quellcodes =
  
Obwohl diese Seite lang ist, ist das Bauen im Allgemeinen ziemlich einfach. Weitere Informationen finden Sie in der Datei BUILDING.txt in der Distribution.
+
Schauen Sie auf der [[Download]]-Seite nach Anweisungen zum Bezug einer OpenSimulator-Quellcodeversion.  
  
== Bedarf ==
+
Wenn Sie den aktuellen Entwicklungscode möchten (d.h. den Git-Master-Branch), siehe [[Developer_Documentation#Source_Code_Repository_Access]].
  
OpenSimulator 0.9.0.x erfordert entweder
+
= Erstellung =
* [http://msdn.microsoft.com/en-us/netframework/cc378097 .NET Framework 4.0] für Windows
+
* [https://www.mono-project.com/download/stable/ Mono]    unter Linux oder Mac. Mono 2.10.8 ist die Mindestversion.
+
  
Möglicherweise benötigen Sie auch ein Tool.  
+
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.
  
 +
== 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.
  
OpenSimulator 0.9.1 erfordert entweder
+
=== Bezug des Quellcodes ===
* [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.
+
  
 +
Holen oder aktualisieren Sie den Quellcode von Git.
  
Andere Plattformen können eigene Mono-Distributionen haben oder müssen Mono-Kompilate auf ihnen erstellen.
+
git clone git://opensimulator.org/git/opensim
  
 +
=== Erstellung unter Windows ===
 +
Um unter Windows zu erstellen, sind folgende Schritte erforderlich:
  
Andere von OpenSimulator verwendete Bibliotheken finden Sie in unserem opensim-libs git repo.
+
    [https://dotnet.microsoft.com/en-us/download/dotnet/8.0 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:
 +
 
 +
* 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
 +
 
 +
Konfigurieren Sie diesbezüglich. Siehe [[Configuration]].
 +
 
 +
Führen Sie nun einfach OpenSim.exe aus dem bin-Ordner aus und richten Sie die Region ein.
 +
 
 +
=== Erstellung unter Linux / Mac ===
 +
 
 +
Sie benötigen:
 +
 
 +
    [https://dotnet.microsoft.com/en-us/download/dotnet/8.0 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
 +
 
 +
== Ä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.
 +
 
 +
== Anforderungen ==
 +
 
 +
OpenSimulator 0.9.0.x erfordert entweder
 +
 
 +
* [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.
 +
 
 +
OpenSimulator >= 0.9.1 (einschließlich des aktuellen Master) erfordert
 +
 
 +
* [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.
 +
 
 +
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
 
git clone git://opensimulator.org/git/opensim-libs
  
Möglicherweise müssen Sie sie für Ihre Plattform kompilieren, insbesondere die nicht verwalteten Bibliotheken wie Bullet oder ODE native Code-Bibliotheken
+
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
  
 
== MS Windows ==
 
== MS Windows ==
  
 
=== Unterstützte Compiler ===
 
=== Unterstützte Compiler ===
 +
 
* [https://visualstudio.microsoft.com/downloads/ Visual Studio Community 2017]
 
* [https://visualstudio.microsoft.com/downloads/ Visual Studio Community 2017]
* Oder jede Version, die die .Net-Version unterstützt. VS2010 kann beispielsweise für OpenSimulator-Versionen vor 0.9.1 verwendet werden.
+
* 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
  
=== Kompilieren in einer IDE ===
+
=== Kompilierung in einer IDE ===
# Führen Sie "runprebuild.bat" aus
+
* Führen Sie "runprebuild.bat" aus.
# Öffnen Sie das resultierende "OpenSim.sln" in Visual Studio IDE.
+
* Öffnen Sie die resultierende "OpenSim.sln" in der Visual Studio IDE.
# Wählen Sie die Debug- oder Release-Konfiguration
+
* Wählen Sie Debug- oder Release-Konfiguration
# Menu Build -> Build Solution.
+
* Menü Build -> Build Solution.
  
=== Kompilieren mit der Eingabeaufforderung ===
+
=== Kompilierung an der Eingabeaufforderung ===
# Führen Sie "runprebuild.bat" aus
+
* Führen Sie "runprebuild.bat" aus.
# Führen Sie die resultierende Datei "compile.bat" aus.
+
* Führen Sie die resultierende Datei "compile.bat" aus.
  
 
== Linux und andere Mono-Plattformen ==
 
== Linux und andere Mono-Plattformen ==
  
=== Bereiten Sie die Kompilierung vor ===
+
=== Vorbereitung für die Kompilierung ===
Um mehrere Projektdateien zu erstellen, führen Sie sie im Ordner opensim aus:
+
Um die verschiedenen Projektdateien zu erstellen, führen Sie im Ordner opensim aus:
  
  ./runprebuild.sh
+
  ./runprebuild.sh
  
==== Kompilieren mit NAnt ====
+
==== Kompilieren mit Nant ====
Bei einigen Mono-Versionen, insbesondere bei alten Versionen, ist möglicherweise die Verwendung von nant erforderlich, um den OpenSimulator korrekt zu kompilieren. In diesem Fall führen Sie einfach Folgendes aus:
+
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
+
  nant
  
NAnt tool macht bei neuen OpenSim Versionen Probleme, verwenden Sie stattdessen msbuild.
+
==== Kompilieren mit xbuild ====
  
==== Kompiliere mit xbuild ====
+
Auf Mono-Versionen können Sie einfach xbuild verwenden. ''(msbuild wird ab 0.9.1.0.0 empfohlen)''
  
On mono versions you can just use xbuild.
+
  xbuild
  
  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
+
''>>>> xbuild-Tool ist veraltet und wird in zukünftigen Updates entfernt, verwenden Sie stattdessen msbuild <<<<''
  
==== Kompilieren Sie mit Msbuild ====
+
Auf neueren Mono-Versionen kann die Release-Konfiguration einige Leistungsvorteile bringen, aber Sie verlieren einige Debug-Fähigkeiten.
Für Opensim 0.9.1 können Sie weiterhin xbuild verwenden, aber Mono empfiehlt die Verwendung von msbuild. Möglicherweise müssen Sie dazu das Paket msbuild zusätzlich zur Monovervollständigung installieren.
+
zum Kompilieren der Release-Konfiguration:
 +
  xbuild /p:Configuration=Release
  
Verwenden Sie xbuild in den anderen Fällen.
+
==== 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 )
  
Jüngste Verbesserungen, insbesondere auf der JIT-Laufzeit, rechtfertigen das Kompilieren in der Release-Konfiguration, aber Sie verlieren einige Debug-Funktionen.
+
Verwenden Sie xbuild in den anderen Fällen als letztes Mittel.
  
um mit der Debug-Konfiguration zu kompilieren:  
+
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
 
   msbuild
  
mit Release-Konfiguration kompilieren:
+
für die Kompilierung mit Release-Konfiguration:
 
   msbuild /p:Configuration=Release
 
   msbuild /p:Configuration=Release
  
Kompilierung und Speicherung des Buildprotokolls in die Datei msbuild.log:
+
für die Kompilierung mit der Debug-Konfiguration und der detaillierten opensim.log-Datei, die dann mit einem Texteditor gelesen werden kann:
   msbuild /fileLogger
+
   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.
 +
 
 +
== 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>
 +
 
 +
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>
  
Kompilierung und Speicherung mit Detaillierungsgrad in die Datei opensim.log:
+
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>
  msbuild /fileLogger /flp:logfile=opensim.log /v:d
+
  
Für den Detaillierungsgrad können Sie die folgenden Werte angeben:
+
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>
  q[quiet], m[minimal], n[normal], d[detailed] und diag[diagnostic].
+
Dabei kann das abgekürzt werden Beispiele: /v:d oder /v:detailed
+
  
msbuild Übersicht: [https://docs.microsoft.com/de-de/visualstudio/msbuild/msbuild-command-line-reference?view=vs-2017  msbuild command line reference]
+
In der praktischen Anwendung erwarten Sie nicht viel mehr als etwas schnellere Ladezeiten.<br>
 +
Da die Kompilierung jedoch unterschiedlich ist, können neue Probleme auftreten. Testen Sie also sorgfältig.<br>
 +
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>
 +
Und natürlich immer kaputte GC<br>
 +
Aber... nun ja, jede ns zählt..<br>
  
 
= Konfiguration =
 
= Konfiguration =

Latest revision as of 01:00, 23 April 2024

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.

Personal tools
General
About This Wiki