Ez a readme elmagyarázza, hogyan kezdjünk el építeni, használni és fejleszteni a Komodo Edit forrásbázisával.

Míg a fő Komodo Edit forrás ebben a repositoryban található, érdemes megnézni az egyes komponensek/addonok repositoryit is ahttps://github.com/Komodo alatt, ha csak egy adott komponenshez akarsz hozzájárulni. Ezzel időt és gondot spórolhatsz meg, mivel nem kell a teljes projektet összeállítanod.

Tartalomjegyzék

• Képernyőkép
• Letöltés
• Feedback
• Komodo építése
  • Building on Windows
  • Building on Mac
  • building on Linux
  • Építés Dockerrel
  • Komplikációk építése

Képernyőkép

Letöltés

A Komodo Edit itt tölthető le.

Visszajelzés

A Komodo fejlesztőivel többféleképpen is felveheti a kapcsolatot:

Github: https://github.com/Komodo/KomodoEdit

Fórumok: http://forum.komodoide.com/

Bug Tracker: https://github.com/Komodo/KomodoEdit/issues

IRC: irc://irc.mozilla.org/#komodo

Mailing Lists: komodo-discuss & komodo-beta & komodo-announce

Building Komodo

Note that these are simplified steps of the building process, for a more in-depthguide check (outdated) BUILD.txt.

Építés Windowson

• Előfeltételek
• Építés lépései

Előfeltételek

• Python >=2.7 (de még nem Python 3.x). Az ActivePython innen telepíthető.

• Visual C++ 11.0 (aka Visual Studio 2012) és az összes Platform SDK a Mozilla vc11-gyel történő építéséhez az itt leírtak szerint.

• Telepítse a “MozillaBuild-$ver.exe” csomag 1.9.0 verzióját az alapértelmezett könyvtárba(azaz “C:\mozilla-build”).

  • A telepítés után távolítsa el a wget és hg könyvtárakat
  • Töltse le a 2.2.0-ás verziót és telepítse egy ideiglenes könyvtárba, majd másolja a wget könyvtárat a 2.2-ből az 1. könyvtárba.9 telepítési könyvtárba

• Telepítse a Perl <= 5.22

• Telepítse a Mercurial

See http://developer.mozilla.org/en/docs/Windows_Build_Prerequisites további részletek a Windows build előfeltételeiről. A fenti lépések követése azonban elegendő a Komodo építéséhez.

Építési lépések

• Checkout Komodo Edit: git clone https://github.com/Komodo/KomodoEdit.git

• A parancssor segítségével lépjen be a checkout könyvtárába, és futtassa:

   cd mozilla setenv-moz-msvc11.bat python build.py configure -k 11.10 python build.py distclean all

  Ez a mozilla konfigurálását és építését végzi, és 30 perctől több óráig tarthat (a specifikációtól függően). A legtöbb modern gépen ez körülbelül egy óra lehet.

• A mozilla sikeres építése után menj vissza a fő repo könyvtárba és építsd a komodót:

   cd .. set PATH=util\black;%PATH% bk configure -V 11.10.0-devel # --without-binary-dbgp-clients bk build

  Ez lényegesen kevesebb időt vesz igénybe, mint a Mozilla építése.

• Amikor a build befejeződött, egyszerűen futtathatod a Komodót a bk run

A forráson végzett bármilyen módosítás után ismét a bk build,vagy egyszerűen a bk build && bk run futtatásával gyorsan visszatérhetsz a Komodóba. A későbbi buildek sokkal gyorsabbak lesznek, mivel a lefordított adatok nagy része gyorsítótárba kerül.

Építés Macen

• Mac előfeltételek
• Építési lépések

Mac előfeltételek

• Python >=2.7 (de még nem Python 3.x). Az ActivePython-t innen telepítheted.

  Ha a python.org-ról származó Python buildek is elegendőek lehetnek.

• Xcode 6.4(SDK 10.9 & 10.10). A 8.0-hoz lásd alább. A 6.4-es verziót a fejlesztői letöltési oldalról szerezheted be.

• MacOSX10.10.sdk vagy régebbi

• IDE ONLY SDK 10.8 a Code Intelhez. Megtalálható az Xcode 5.1.1

• Ha az Xcode más verziója van/van telepítve, akkor a xcode-select segítségével megváltoztathatja az aktív Xcode-ot:

  $ xcode-select -s /Path/To/Xcode\ 6.4.app/

• Xcode parancssori eszközök.

  Nyissa meg az Xcode beállításait, majd a Letöltések lapon válassza ki és telepítse aCommand Line Tools.

• MacPorts. (Megjegyzés: a Fink is működhet, de a legtöbb építési tesztelés és utasítás a MacPorts-szal történik.)

• autoconf v2.13. Ha már telepítetted a MacPorts-ot, akkor csak futtatnod kellsudo port install autoconf213

• biztosítanod kell, hogy a clang vagy a gcc 4.2-t (vagy magasabb verziót) használd)

Lásd http://developer.mozilla.org/en/docs/Mac_OS_X_Build_Prerequisitesfor további részleteket a Mac OS X build előfeltételeiről. Azonban a fenti lépések követése elegendőnek ígérkezik a Komodo építéséhez.

Xcode 8 előfeltételek

Hivatalosan nem támogatjuk az Xcode 8-at, azonban lehetséges a Komodounder Xcode 8 építése egy új extra lépés segítségével.

• Másolja át a 10.8 és 10.9 SDK-kat egy régebbi XCode telepítésből, ezeknek a következő helyen kell lenniük:Xcode.app/Contents/Developer/Platforms/macOSX.platform/
• Set MinimumSDKVersion to 10.9 in Xcode.app/Contents/Developer/Platforms/macOSX.platform/Info.plist
• Győződjön meg róla, hogy a ccache 3-t használja.1 (a későbbi verziók tönkremennek)
• Konfiguráld a Mozillát a --options=disable-webrtc

Építési lépések

• Csekkolj a Komodo Edit: git clone https://github.com/Komodo/KomodoEdit.git

• A terminál segítségével lépj be a checkout könyvtáradba és futtasd:

   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)

  Ez a mozilla konfigurálását és építését fogja elvégezni és 30 perctől akár több óráig is eltarthat (a specifikációtól függően). A legtöbb modern gépen ez körülbelül egy óra lehet.

** Építés GCC 5.0 és magasabb verzióval **

Ha GCC 5.0-t használsz, a build sikertelen lehet. Ha ez megtörténik,akkor két fájlban kell változtatásokat végrehajtani. Ha azonban először futtatsz egy tiszta buildet, akkor először hagynod kell, hogy a buildnek ez a része sikertelen legyen. Ennek az az oka, hogy a fájlok a build Mozilla részében vannak, amelyet először le kell tölteni.

Ezeket a fájlokat kell módosítani:

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

Bővebb információért lásd a Mozilla hiba adatbázisában a #1153109-es hibát.

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;}

Bővebb információért lásd a GCC 5-re való portolást.

• A sikeres mozilla-építés után menj vissza a fő repo könyvtárba, és építsd be a komodót:

   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

  Ez lényegesen kevesebb időt vesz igénybe, mint a Mozilla építése.

• Amikor a build befejeződött, egyszerűen futtathatja a Komodót a bk run

A forráson végzett bármilyen módosítás után ismét a bk build,vagy egyszerűen a bk build && bk run futtatásával gyorsan visszatérhet a Komodóba. A későbbi buildek sokkal gyorsabbak lesznek, mivel a lefordított adatok nagy része gyorsítótárba kerül.

Építés Linuxon

Linux utasítások

Építés Dockerrel

A legegyszerűbb módja a kezdésnek a Docker image használata, ez alapvetően egy Ubuntu 12.04 alapú buildet biztosít a Komodo számára.

A repository klónozása után egyszerűen navigálj a {repo}/util/docker és checkout ./docklet --help

A docker image használatához természetesen telepítve kell lennie a Dockernek, valamint az SSH kliensedben engedélyezve kell lennie az X11 továbbításnak (a legtöbb linux disztróban alapértelmezetten működnie kell).

Prepare Docker Image

• Build the docker image: ./util/docker/docklet image
• Indítsd el a konténert: ./util/docker/docklet start
• SSH-val lépj be a konténeredbe a munka megkezdéséhez: ./util/docker/docklet ssh

A projektfájljaidat a /komodo/dev

NOTE – ha egy korábbi verzióról frissítesz, ahol a projektfájljaid /root/komodo voltak, akkor meg kell javítanod a Komodo project ésprofile mappák jogosultságait. Ie:

chown -R <my-username>:<my-group> <my-project-location>chown -R <my-username>:<my-group> ~/.komodoide

A buildet is újra kell csinálnod (distclean mozilla és komodo).

Építési lépések

Mihelyt a képed elkészült, követheted a fent leírt linuxos építési lépéseket. Ezeket a docker konténerből fogod futtatni, ezért a fenti paranccsal ssh-oljon be azoit-ba, majd futtassa a parancsokat a /komodo/dev

Running

Mihelyt az építés befejeződött, kilép a konténerből (exit) és futtathatja a Komodót. with

./util/docker/docklet run

A Komodo újraépítéséhez (a módosítások elvégzése után) és újbóli futtatásához használhatja a

./util/docker/docklet build run

Ha a módosításai nem jelennek meg, akkor szükség lehet a build tisztítására, ehhez használd a

./util/docker/docklet clean

Vagy csináld egyszerre (clean, build és run)

./util/docker/docklet clean build run

Building Complications

Ha bármilyen hiba jelentkezik az első build-ed során, és nem nyilvánvaló, hogy hogyan oldhatod meg a problémát saját magad, kérjük, olvasd el a Feedback részben, hogyan léphetsz kapcsolatba velünk.

Megjegyezzük, hogy ha az építési komplikációk azután merülnek fel, hogy frissítette a repóját a legújabb változtatásokkal, akkor szükség lehet a helyi gyorsítótár törlésére, mivel az ütközhet az új változtatásokkal, ehhez futtassa a bk distclean-t, mielőtt lefuttatja az építési lépéseket.

Pro-Tippek

Egyetlen darabot építsen

Néha a bk build túl sok, és a bk build quick nem elég. Ha úgy tűnik, hogy a bk build quick nem veszi fel a változtatásokat, próbáld meg a bk build-t a kérdéses darabra irányítani.

Példa

bk build build/release/modules/places #this will build the places module only

MEGJEGYZÉS: Ne hagyatkozz erre a módszerre, mivel a bk build quick gyorsabb, és bizonyos esetekben elvégzi azokat a lépéseket, amelyeket a fenti példa nem. Használja utolsó utáni próbálkozásként, mielőtt megpróbálkozik a bk distclean && bk build.