Komodo / KomodoEdit

Jun 19, 2021
admin

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

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 buildoder 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 nochsudo 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:
  1. /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.

  1. /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 buildoder 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.

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht.