Build Instructions/de
From OpenSimulator
Diese Seite behandelt das Erstellen von OpenSimulator aus dem Quellcode auf mehreren Plattformen.
Bitte helfen Sie uns, diese Seite während des Projektfortschritts auf dem neuesten Stand zu halten.
Wenn Sie OpenSimulator nur ausführen möchten, Download und run stattdessen den Binär-Build.
In den meisten Fällen sollten Sie mit Binärdateien zurechtkommen.
Contents |
Erhalten des Quellcodes
Auf der Download eite finden Sie Anweisungen zum Erhalt einer OpenSimulator-Quellversion. Wenn Sie den aktuellen Entwicklungscode (d. h. den Git-Master-Branch) wollen, siehe Developer_Documentation#Source_Code_Repository_Access.
Building
Obwohl diese Seite lang ist, ist das Bauen im Allgemeinen recht einfach. Eine vereinfachte Anleitung finden Sie in der Datei BUILDING.txt in der Distribution selbst.
Version 0.9.3.0 und höher
Microsoft stoppte die Entwicklung von .Net Framework und Mono und ersetzte sie durch das neue dotnet.
Dies ist eine bedeutende bahnbrechende Änderung, der wir versuchen, auf 0.9.3.0 zu folgen.
Eine Besonderheit ist, der Startvorgang hat sich geändert, es wird nicht mehr mit mono OpenSim.exe gestartet, sondern mit dotnet OpenSim.dll .
Quellcode abrufen
Holen oder aktualisieren Sie die Quelle von Git
git clone git://opensimulator.org/git/opensim
Wechseln Sie in den dotnet6 Zweig
cd opensim git checkout dotnet6
Erstellen auf Windows
Um unter Windows zu bauen, ist Folgendes erforderlich:
- Visual Studio .NET, version 2022 oder später
oder
Erstellen Sie die Projektdateien, die ausgeführt werden:
runprebuild.bat
Laden Sie die generierte OpenSim.sln in Visual Studio und erstellen Sie die Lösung oder führen Sie sie einfach aus:
compile.bat
zum laufen braucht man evtl
- um die run time files for vc++ zu installieren
- um die Installation von älterem .NetFramework 3.5 zu autorisieren
Konfigurieren, siehe Configuration.
Führen Sie jetzt einfach OpenSim.exe aus dem bin-Ordner aus und richten Sie die Region ein.
Erstellen auf Linux / Mac
Was sie brauchen:
- dotnet 6.0 SDK and Runtime
- libgdiplus
- Wenn Sie mono 6.x complete haben, haben Sie bereits libgdiplus, ansonsten müssen Sie es zum Beispiel auf Debian installieren:
- apt-get update && apt-get install -y apt-utils libgdiplus libc6-dev
Erstellen Sie die Projektdateien, führen Sie Folgendes aus:
./runprebuild.sh
dann starten sie:
dotnet build --configuration Release OpenSim.sln
oder nur:
./compile.sh
Konfigurieren. Siehe Configuration.
Führen Sie ./opensim.sh aus dem bin Ordner aus und richten Sie die Region ein.
Ältere Versionen
Bedarf
OpenSimulator 0.9.0.x erfordert entweder
- .NET Framework 4.0 für Windows
- Mono unter Linux oder Mac. Mono 2.10.8 ist die Mindestversion.
Möglicherweise benötigen Sie auch ein Tool.
OpenSimulator 0.9.1 erfordert entweder
- .NET Framework 4.6 unter Windows
- Mono unter Linux oder Mac. Mono 5.12 ist die empfohlene Mindestversion.
Andere Plattformen können eigene Mono-Distributionen haben oder müssen Mono-Kompilate auf ihnen erstellen.
Andere von OpenSimulator verwendete Bibliotheken finden Sie in unserem opensim-libs git repo.
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
MS Windows
Unterstützte Compiler
- 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.
Kompilieren in einer IDE
- Führen Sie "runprebuild.bat" aus
- Öffnen Sie das resultierende "OpenSim.sln" in Visual Studio IDE.
- Wählen Sie die Debug- oder Release-Konfiguration
- Menu Build -> Build Solution.
Kompilieren mit der Eingabeaufforderung
- Führen Sie "runprebuild.bat" aus
- Führen Sie die resultierende Datei "compile.bat" aus.
Linux und andere Mono-Plattformen
Bereiten Sie die Kompilierung vor
Um mehrere Projektdateien zu erstellen, führen Sie sie im Ordner opensim aus:
./runprebuild.sh
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:
nant
NAnt tool macht bei neuen OpenSim Versionen Probleme, verwenden Sie stattdessen msbuild.
Kompiliere mit xbuild
On mono versions you can just use xbuild.
xbuild
xbuild tool ist veraltet und wird in zukünftigen Updates entfernt, verwenden Sie stattdessen msbuild
Kompilieren mit Msbuild
Für Opensim 0.9.1 können Sie weiterhin xbuild verwenden, Mono empfiehlt jedoch die Verwendung von msbuild. Möglicherweise müssen Sie das Paket msbuild zusätzlich zu mono-complete installieren. (Derzeit ist msbuild enthalten, wenn Sie Mono-Complete unter Ubuntu aus den offiziellen Mono-Repositorys installieren.
Verwenden Sie xbuild in den anderen Fällen als letzten Ausweg.
Jüngste Verbesserungen, insbesondere an der JIT-Laufzeit, rechtfertigen das Kompilieren in der Release-Konfiguration, aber Sie verlieren einige Debug-Funktionen.
um mit der Debug-Konfiguration zu kompilieren:
msbuild
mit Release Konfiguration kompilieren:
msbuild /p:Configuration=Release
Zum Kompilieren mit der Debug Konfiguration und der detaillierten Datei opensim.log, diese kann dann mit einem Texteditor diese kann zur Diagnose der Fehler gelesen werden:
msbuild /p:Configuration=Debug /fileLogger /flp:logfile=opensim.log /v:d
Sie können die folgenden Werte für den Detaillierungsgrad der Datei opensim.log angeben:
q [still], m [minimal], n [normal], d [detailliert] und diag [diagnostisch].
msbuild Übersicht: msbuild command line reference
Ahead of Time Zusammenstellung (AOT)
Wie Sie alle wissen, enthalten die durch den obigen Kompilierungsprozess erstellten Dateien * .exe und .dll keinen nativen Code für den Computer.
Mit diesen Dateien wird der von der CPU benötigte native Code zur Laufzeit nach Bedarf in einem als Just in Time (JIT) bezeichneten Prozess erstellt.
Es ist möglich, eine weitere Kompilierungsphase für diese Dateien durchzuführen, um nativen Code zu erstellen, der bereit ist, wenn Das Programm startet. Dies ist der Ahead of Time-Prozess (AOT).
Da JIT zur Laufzeit ausgeführt wird, ist die Zeit für umfangreiche Codeoptimierungen begrenzt. AOT kann dagegen alles tun.
AOT sollte auf diese Weise schneller zu laden sein, den für die JIT-Arbeit benötigten Speicher einsparen und die Latenz aufgrund der Codegenerierung verringern, wenn ein neuer Codeabschnitt benötigt wird.
Auf diese Weise hilft AOT dabei, die große Leistungslücke zwischen C# und einer geeigneteren Sprache wie C++ zu verringern, selbst wenn man bedenkt, dass JIT abhängig vom aktuellen Code-Ausführungsstatus eine Optimierung durchführen kann, die AOT nicht kann. (Wenn Sie der Meinung sind, dass c# so schnell ist wie kompetenter C++ Code, ändern Sie besser, was Sie rauchen ...)
Tatsächlich sind sowohl .net als auch mono do AOT auf ihren Komponenten während der Installation von
JIT weiterhin aktiv und kompilieren zur Laufzeit einen anderen Code . OpenSim und verwendete .net / Mono-Framework-Teile hängen davon ab.
Für Linux enthält 0.9.2.0 jetzt die Skripte makeaot.sh und cleanaot.sh, um das Testen von AOT zu erleichtern.
Führen Sie makeaot.sh nach der obigen Kompilierungsphase aus, um die nativen Codedateien zu generieren. Die Option -O = all muss bei der Ausführung von opensim.exe zu mono hinzugefügt werden, z.
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 makeaot ausgeführt wird).
VERGESSEN SIE NICHT, makeaot.sh oder cleanaot.sh nach dem Neukompilieren auszuführen!
Die generierten Dateien sind spezifisch für diesen Computer. Kopieren Sie die nativen Codedateien nicht auf einen anderen Computer, es sei denn, sie sind absolut identisch.
Die ursprüngliche EXE- und DLL-Datei wird weiterhin benötigt
AOT ist auch in Windows möglich, verwendet jedoch verschiedene Tools, die das zentrale Repository auf dem Computer erweitern und schwieriger zu isolieren und zu warten sind. siehe ngen
Macs sind .. Macs .. Zukünftige Modelle können JIT völlig verbieten, so wie es Apple Mobile-Produkte tun. Mono AOT auf aktuellen Macs funktioniert möglicherweise wie unter Linux
Erwarten Sie im praktischen Gebrauch nicht viel mehr als ein bisschen schnelleres Laden.
Da die Kompilierung unterschiedlich ist, können außerdem neue Probleme hinzugefügt werden. Testen Sie also sorgfältig
Opensim-Leistungsprobleme betreffen hauptsächlich den eigenen Code, schrecklich schlechte Kommunikationsprotokolle, die Verwendung von schlechtem .net / mono-Framework-Code (Demoqualität in denselben Fällen) usw.
Und natürlich dumme und ewig kaputte GC.
Aber ... gut jeder ns zählt ..
Konfiguration
Siehe Configuration.
