Revision as of 05:58, 3 April 2023

 

Home

 

Download

 

News

 

Support

 

Admin

 

Dev

 

Screen Shots

 

Grid List

 

Bugs

Languages:

English    Deutsch    Français    日本語

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.

Erhalten des Quellcodes

Auf der Download Seite 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

• dotnet 6.0 SDK and Desktop Runtime

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

1. Führen Sie "runprebuild.bat" aus
2. Öffnen Sie das resultierende "OpenSim.sln" in Visual Studio IDE.
3. Wählen Sie die Debug- oder Release-Konfiguration
4. Menu Build -> Build Solution.

Kompilieren mit der Eingabeaufforderung

1. Führen Sie "runprebuild.bat" aus
2. 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.