Build Instructions/de
From OpenSimulator
(→Erstellung unter Windows) |
|||
| (10 intermediate revisions by one user not shown) | |||
| Line 1: | Line 1: | ||
{{Quicklinks|Build_Instructions}} | {{Quicklinks|Build_Instructions}} | ||
| − | Diese Seite behandelt den Bau | + | 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. | ||
= Bezug des Quellcodes = | = 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]]. | + | 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]]. | ||
= Erstellung = | = Erstellung = | ||
| Line 50: | Line 58: | ||
[https://dotnet.microsoft.com/en-us/download/dotnet/8.0 dotnet 8.0 SDK] | [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: | Erstellen Sie die Projektdateien, indem Sie Folgendes ausführen: | ||
| − | ./runprebuild.sh | + | ./runprebuild.sh |
führen Sie dann aus: | führen Sie dann aus: | ||
| − | dotnet build --configuration Release OpenSim.sln | + | dotnet build --configuration Release OpenSim.sln |
oder einfach: | oder einfach: | ||
| − | ./compile.sh | + | ./compile.sh |
Konfigurieren Sie diesbezüglich. Siehe [[Configuration]]. | Konfigurieren Sie diesbezüglich. Siehe [[Configuration]]. | ||
| Line 71: | Line 79: | ||
== Ältere Versionen == | == Ä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. | + | 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 == | == Anforderungen == | ||
| Line 77: | Line 86: | ||
OpenSimulator 0.9.0.x erfordert entweder | 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. | Sie benötigen möglicherweise auch das nant-Tool. | ||
OpenSimulator >= 0.9.1 (einschließlich des aktuellen Master) erfordert | 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. | Es wird empfohlen, mit msbuild zu kompilieren. | ||
| Line 101: | Line 110: | ||
=== Unterstützte Compiler === | === Unterstützte Compiler === | ||
| − | + | * [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 | |
=== Kompilierung in einer IDE === | === Kompilierung in einer IDE === | ||
| − | Führen Sie "runprebuild.bat" aus. | + | * Führen Sie "runprebuild.bat" aus. |
| − | Öffnen Sie die resultierende "OpenSim.sln" in der Visual Studio IDE. | + | * Öffnen Sie die resultierende "OpenSim.sln" in der Visual Studio IDE. |
| − | Wählen Sie Debug- oder Release-Konfiguration | + | * Wählen Sie Debug- oder Release-Konfiguration |
| − | Menü Build -> Build Solution. | + | * Menü Build -> Build Solution. |
=== Kompilierung an 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 == | ||
| Line 120: | Line 129: | ||
Um die verschiedenen Projektdateien zu erstellen, führen 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 ==== | ||
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: | 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 |
==== Kompilieren mit xbuild ==== | ==== Kompilieren mit xbuild ==== | ||
| Line 131: | Line 140: | ||
Auf Mono-Versionen können Sie einfach xbuild verwenden. ''(msbuild wird ab 0.9.1.0.0 empfohlen)'' | Auf Mono-Versionen können Sie einfach xbuild verwenden. ''(msbuild wird ab 0.9.1.0.0 empfohlen)'' | ||
| − | xbuild | + | xbuild |
xbuild wird auf Mono 5.x nicht mehr empfohlen, funktioniert jedoch derzeit noch (5.12) | xbuild wird auf Mono 5.x nicht mehr empfohlen, funktioniert jedoch derzeit noch (5.12) | ||
| Line 139: | Line 148: | ||
Auf neueren Mono-Versionen kann die Release-Konfiguration einige Leistungsvorteile bringen, aber Sie verlieren einige Debug-Fähigkeiten. | Auf neueren Mono-Versionen kann die Release-Konfiguration einige Leistungsvorteile bringen, aber Sie verlieren einige Debug-Fähigkeiten. | ||
zum Kompilieren der Release-Konfiguration: | zum Kompilieren der Release-Konfiguration: | ||
| − | xbuild /p:Configuration=Release | + | xbuild /p:Configuration=Release |
==== Kompilieren mit msbuild ==== | ==== Kompilieren mit msbuild ==== | ||
| Line 149: | Line 158: | ||
für die Kompilierung mit Debug-Konfiguration: | für die Kompilierung mit Debug-Konfiguration: | ||
| − | msbuild | + | msbuild |
für die Kompilierung mit Release-Konfiguration: | für die Kompilierung mit Release-Konfiguration: | ||
| − | msbuild /p:Configuration=Release | + | 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: | 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 | + | 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: | 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]. | + | 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. | 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. | ||
| Line 174: | Line 183: | ||
Für Linux enthält 0.9.2.0 jetzt Skripte makeaot.sh und cleanaot.sh, um AOT-Tests zu erleichtern.<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> | 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 | + | 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> | 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> | <b>VERGESSEN SIE NICHT, makeaot.sh oder cleanaot.sh nach dem Neukompilieren auszuführen!</b><br> | ||
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:
- die 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.
[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
- 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:
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
- .NET Framework 4.0 unter Windows
- 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
- .NET Framework 4.6 unter Windows
- Mono unter Linux oder Mac. Mono 5.12 ist die empfohlene Mindestversion.
Hinweis: Verwenden Sie nicht die Mono-Pakete Ihrer Linux-Distribution, da möglicherweise erforderliche Komponenten fehlen. Bitte 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
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.
