Komodo / KomodoEdit
Dieses Readme erklärt, wie man mit dem Bau, der Verwendung und der Entwicklung der Komodo Edit Quellcodebasis beginnt.
Während der Hauptquellcode von Komodo Edit in diesem Repository gehostet wird, können Sie auch die einzelnen Komponenten/Addon Repositories unter https://github.com/Komodo besuchen, falls Sie nur zu einer bestimmten Komponente beitragen wollen. Das spart Ihnen Zeit und Ärger, da Sie nicht das gesamte Projekt erstellen müssen.
Inhaltsverzeichnis
- Screenshot
- Download
- Feedback
- Komodo bauen
- Erstellung unter Windows
- Erstellung unter Mac
- Erstellung unter Linux
- Bauen mit Docker
- Bauen von Komplikationen
Screenshot
Download
Hier können Sie Komodo Edit herunterladen.
Feedback
Es gibt mehrere Möglichkeiten, mit den Komodo-Entwicklern in Kontakt zu treten:
Github: https://github.com/Komodo/KomodoEdit
Foren: http://forum.komodoide.com/
Bug Tracker: https://github.com/Komodo/KomodoEdit/issues
IRC: irc://irc.mozilla.org/#komodo
Mailing-Listen: komodo-discuss & komodo-beta & komodo-announce
Komodo bauen
Bitte beachten Sie, dass dies vereinfachte Schritte des Bauprozesses sind, eine ausführlichere Anleitung finden Sie unter (veraltet) BUILD.txt.
Bauen unter Windows
- Voraussetzungen
- Bauschritte
Voraussetzungen
-
Python >=2.7 (aber noch nicht Python 3.x). Sie können ActivePython von hier aus installieren.
-
Visual C++ 11.0 (auch bekannt als Visual Studio 2012) und alle Platform SDKs für die Erstellung von Mozilla mit vc11 wie hier beschrieben.
-
Installieren Sie die Version 1.9.0 des Pakets „MozillaBuild-$ver.exe“ in das Standardverzeichnis (d.h. „C:\mozilla-build“).
- Nach der Installation entfernen Sie die Verzeichnisse wget und hg
- Laden Sie die Version 2.2.0 herunter und installieren Sie sie in ein Temp-Verzeichnis, dann kopieren Sie das wget-Verzeichnis von 2.2 in das 1.9-Installationsverzeichnis
-
Installieren Sie Perl <= 5.22
-
Installieren Sie Mercurial
Siehe http://developer.mozilla.org/en/docs/Windows_Build_Prerequisites für weitere Details zu den Voraussetzungen für Windows. Das Befolgen der oben genannten Schritte sollte jedoch ausreichen, um Komodo zu erstellen.
Bauschritte
-
Komodo Edit auschecken:
git clone https://github.com/Komodo/KomodoEdit.git
-
Geben Sie über die Kommandozeile Ihr Auscheckverzeichnis ein und führen Sie aus:
cd mozilla setenv-moz-msvc11.bat python build.py configure -k 11.10 python build.py distclean all
Dies wird Mozilla konfigurieren und bauen und kann zwischen 30 Minuten und mehreren Stunden dauern (abhängig von Ihren Spezifikationen). Für die meisten modernen Rechner sollte es etwa eine Stunde dauern.
-
Nachdem Mozilla erfolgreich gebaut wurde, gehen Sie zurück zum Hauptverzeichnis des Repo und bauen Sie Komodo:
cd .. set PATH=util\black;%PATH% bk configure -V 11.10.0-devel # --without-binary-dbgp-clients bk build
Dies sollte deutlich weniger Zeit in Anspruch nehmen als das Bauen von Mozilla.
-
Nachdem der Build abgeschlossen ist, können Sie Komodo einfach starten, indem Sie
bk run
Wenn Sie Änderungen am Quellcode vornehmen, müssen Sie erneut bk build
oder einfach bk build && bk run
ausführen, um schnell wieder in Komodo zu gelangen. Nachfolgende Builds sollten viel schneller sein, da viele der kompilierten Daten zwischengespeichert werden.
Bauen auf Mac
- Mac Voraussetzungen
- Bauschritte
Mac Voraussetzungen
-
Python >=2.7 (aber noch nicht Python 3.x). Sie können ActivePython von hier aus installieren.
Wenn Sie die Python-Builds von python.org bevorzugen, sollten sie ebenfalls ausreichen.
-
Xcode 6.4(SDK 10.9 & 10.10). Für 8.0 siehe unten. Sie können die Version 6.4 von der Entwicklerseite herunterladen.
-
MacOSX10.10.sdk oder älter
-
IDE NUR SDK 10.8 für Code Intel. Kann in Xcode 5.1.1 gefunden werden
-
Wenn Sie andere Versionen von Xcode installiert haben/brauchen, können Sie
xcode-select
verwenden, um das aktive Xcode zu ändern:$ xcode-select -s /Path/To/Xcode\ 6.4.app/
-
Xcode Command Line Tools.
Öffnen Sie die Xcode-Einstellungen und wählen Sie dann auf der Registerkarte „Downloads“ die Command Line Tools aus und installieren Sie sie.
-
MacPorts. (Hinweis: Fink kann auch funktionieren, aber die meisten Build-Tests und Anweisungen werden mit MacPorts durchgeführt.)
-
autoconf v2.13. Sobald Sie MacPorts installiert haben, müssen Sie nur noch
sudo port install autoconf213
-
sicherstellen, dass Sie clang oder gcc 4.2 (oder höher)
Siehe http://developer.mozilla.org/en/docs/Mac_OS_X_Build_Prerequisitesformehr Details über Mac OS X build prerequisites. Es sollte jedoch ausreichen, die oben genannten Schritte zu befolgen, um Komodo zu bauen.
Xcode 8 Voraussetzungen
Offiziell unterstützen wir Xcode 8 nicht, es ist jedoch möglich, Komodo unter Xcode 8 zu bauen, indem ein neuer zusätzlicher Schritt durchgeführt wird.
- Kopieren Sie die 10.8 und 10.9 SDK’s von einer älteren XCode Installation, sie sollten sich befinden in:Xcode.app/Contents/Developer/Platforms/macOSX.platform/
- Setzen Sie MinimumSDKVersion auf 10.9 in Xcode.app/Contents/Developer/Platforms/macOSX.platform/Info.plist
- Stellen Sie sicher, dass Sie ccache 3 verwenden.1 (spätere Versionen werden nicht funktionieren)
- Konfigurieren Sie Mozilla mit
--options=disable-webrtc
Erstellungsschritte
-
Komodo Edit auschecken:
git clone https://github.com/Komodo/KomodoEdit.git
-
Gehen Sie mit dem Terminal in Ihr Checkout-Verzeichnis und führen Sie aus:
1) cd komodo/mozilla 2) python build.py configure -k 10.10 3) python build.py all or python build.py distclean all (to delete and re-download Mozilla again)
Dies wird Mozilla konfigurieren und bauen und kann zwischen 30 Minuten und mehreren Stunden dauern (abhängig von Ihren Spezifikationen). Für die meisten modernen Maschinen sollte es etwa eine Stunde dauern.
** Bauen mit GCC 5.0 und höher **
Wenn Sie GCC 5.0 verwenden, kann das Bauen fehlschlagen. Wenn dies der Fall ist, müssen an zwei Dateien Änderungen vorgenommen werden. Wenn Sie jedoch einen sauberen Build zum ersten Mal ausführen, müssen Sie diesen Teil des Builds zuerst fehlschlagen lassen. Das liegt daran, dass die Dateien im Mozilla-Teil des Builds enthalten sind, der zuerst heruntergeladen werden muss.
Diese Dateien müssen geändert werden:
- /KomodoEdit/mozilla/build/moz3500-ko9.10/mozilla/configure.in
@@ -7509,8 +7509,6 @@ eval $(CXX="$CXX" HOST_CXX="$HOST_CXX" $PYTHON -m mozbuild.configure.libstdcxx) AC_SUBST(MOZ_LIBSTDCXX_TARGET_VERSION) AC_SUBST(MOZ_LIBSTDCXX_HOST_VERSION)+ CXXFLAGS="$CXXFLAGS -D_GLIBCXX_USE_CXX11_ABI=0"+ HOST_CXXFLAGS="$HOST_CXXFLAGS -D_GLIBCXX_USE_CXX11_ABI=0"fi
Siehe Fehler #1153109 in Mozillas Fehlerdatenbank für weitere Informationen.
- /KomodoEdit/mozilla/build/moz3500-ko9.10/mozilla/dom/ipc/Blob.cpp
@@ -3874,7 +3874,7 @@// Make sure we can't overflow.if (NS_WARN_IF(UINT64_MAX - aLength < aStart)) { ASSERT_UNLESS_FUZZING();- return nullptr;+ return false;}ErrorResult errorResult;@@ -3883,7 +3883,7 @@if (NS_WARN_IF(aStart + aLength > blobLength)) { ASSERT_UNLESS_FUZZING();- return nullptr;+ return false;}
Siehe Portierung auf GCC 5 für weitere Informationen.
-
Nachdem Mozilla erfolgreich gebaut wurde, gehen Sie zurück in das Hauptverzeichnis des Repo und bauen Sie Komodo:
cd .. export PATH=`pwd`/util/black:$PATH # Komodo's "bk" build tool git submodule update --init git submodule update --remote bk configure -V 10.10.0-devel bk build
Dies sollte deutlich weniger Zeit in Anspruch nehmen als das Bauen von Mozilla.
-
Nachdem der Build abgeschlossen ist, können Sie Komodo einfach starten, indem Sie
bk run
Wenn Sie Änderungen am Quellcode vornehmen, müssen Sie erneut bk build
oder einfach bk build && bk run
ausführen, um schnell wieder in Komodo zu gelangen. Nachfolgende Builds sollten viel schneller sein, da viele der kompilierten Daten zwischengespeichert werden.
Bauen unter Linux
Linux-Anweisungen
Bauen mit Docker
Der einfachste Weg, um anzufangen, ist, unser Docker-Image zu verwenden, das Ihnen im Grunde einen auf Ubuntu 12.04 basierenden Build von Komodo zur Verfügung stellen wird.
Nach dem Klonen des Repositorys navigieren Sie einfach zu {repo}/util/docker
und checken Sie aus ./docklet --help
Um das Docker-Image zu verwenden, müssen Sie natürlich Docker installiert haben und die X11-Weiterleitung in Ihrem SSH-Client aktiviert haben (sollte bei den meisten Linux-Distributionen standardmäßig funktionieren).
Docker-Image vorbereiten
- Erstellen Sie das Docker-Image:
./util/docker/docklet image
- Starten Sie Ihren Container:
./util/docker/docklet start
- SSH in Ihren Container, um mit der Arbeit zu beginnen:
./util/docker/docklet ssh
Ihre Projektdateien werden unter /komodo/dev
HINWEIS – wenn Sie von einer früheren Version aktualisieren, in der sich Ihre Projektdateien unter /root/komodo
befanden, müssen Sie die Berechtigungen für Ihre Komodo-Projekt- und -Profilordner ändern. D.h.:
chown -R <my-username>:<my-group> <my-project-location>chown -R <my-username>:<my-group> ~/.komodoide
Sie müssen auch Ihren Build neu erstellen (Mozilla und Komodo löschen).
Build-Schritte
Wenn Sie Ihr Image vorbereitet haben, können Sie die Build-Schritte für Linux wie oben beschrieben durchführen. Sie werden diese aus dem Docker-Container heraus ausführen, also ssh intoit mit dem obigen Befehl und führen Sie dann die Befehle von /komodo/dev
Running
Nachdem Ihr Build abgeschlossen ist, verlassen Sie den Container (exit
) und können dann Komodo ausführen mit
./util/docker/docklet run
Um Komodo (nach Änderungen) neu zu erstellen und erneut zu starten, können Sie
./util/docker/docklet build run
Wenn Ihre Änderungen nicht übernommen werden, müssen Sie Ihren Build bereinigen, Um dies zu tun, verwenden Sie
./util/docker/docklet clean
oder Sie machen alles auf einmal (bereinigen, erstellen und ausführen)
./util/docker/docklet clean build run
Komplikationen bei der Erstellung
Wenn während der ersten Erstellung Fehler auftreten und es nicht offensichtlich ist, wie Sie das Problem selbst beheben können, lesen Sie bitte den Abschnitt „Feedback“, um mit uns in Kontakt zu treten.
Wenn Komplikationen beim Bauen auftreten, nachdem du dein Repo mit den neuesten Änderungen aktualisiert hast, musst du eventuell deinen lokalen Cache löschen, da er mit den neuen Änderungen in Konflikt stehen könnte. Um dies zu tun, führe bk distclean
aus, bevor du deine Build-Schritte ausführst.
Pro-Tipps
Baue ein einzelnes Stück
Manchmal ist bk build
zu viel und bk build quick
ist nicht genug. Wenn bk build quick
Ihre Änderungen nicht zu übernehmen scheint, versuchen Sie, bk build
auf das betreffende Stück zu richten.
Beispiel
bk build build/release/modules/places #this will build the places module only
Hinweis: Verlassen Sie sich nicht auf diese Methode, da bk build quick
schneller ist und in einigen Fällen einige Schritte ausführt, die das obige Beispiel nicht durchführt. Verwenden Sie diese Methode als letzten Ausweg, bevor Sie bk distclean && bk build
versuchen.