Tämä readme selittää, miten pääset alkuun Komodo Editin lähdekoodipohjan rakentamisessa, käyttämisessä ja kehittämisessä.

Vaikka Komodo Editin pääasiallinen lähdekoodi sijaitsee tämän arkiston alla, voit myös halutessasi tutustua yksittäisten komponenttien/addonien yksittäisiin arkistoihin osoitteessahttps://github.com/Komodo siltä varalta, että haluat osallistua vain tiettyyn komponenttiin. Näin säästät aikaa ja vaivaa, koska sinun ei tarvitse rakentaa koko projektia.

Sisällysluettelo

• Kuvaruutukaappaus
• Lataus
• Palaute
• Komodon rakentaminen
  • Rakentaminen Windowsilla
  • Rakentaminen Macilla
  • rakentaminen. Linux
  • Rakentaminen Dockerilla
  • Rakentaminen Komodolla

Kuvakaappaus

Lataus

Komodo Editin voit ladata täältä.

Palaute

Komodon kehittäjiin voi ottaa yhteyttä usealla eri tavalla:

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

Foorumit: http://forum.komodoide.com/

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

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

Postituslistat: komodo-discuss & komodo-beta & komodo-announce

Komodon rakentaminen

Huomaa, että nämä ovat yksinkertaistettuja rakentamisprosessin vaiheita, syvällisemmän oppaan saat tarkistamalla (vanhentuneen) BUILD.txt.

Rakentaminen Windowsissa

• Edellytykset
• Rakentamisen vaiheet

Edellytykset

• Python >=2.7 (mutta ei vielä Python 3.x). Voit asentaa ActivePythonin täältä.

• Visual C++ 11.0 (aka Visual Studio 2012) ja kaikki alustan SDK:t Mozillan rakentamiseen vc11:llä, kuten täällä on kuvattu.

• Asenna ”MozillaBuild-$ver.exe”-paketin versio 1.9.0 oletusluetteloon (eli ”C:\mozilla-build”).

  • Asennuksen jälkeen poista wget- ja hg-hakemistot
  • Lataa versio 2.2.0 ja asenna se temp-hakemistoon, kopioi sitten wget-hakemisto 2.2:sta 1.9 asennushakemistoon

• Asenna Perl <= 5.22

• Asenna Mercurial

Katso http://developer.mozilla.org/en/docs/Windows_Build_Prerequisites lisätietoja Windows-rakentamisen edellytyksistä. Edellä esitettyjen vaiheiden noudattamisen on kuitenkin tarkoitus riittää Komodon rakentamiseen.

Rakentamisen vaiheet

• Tarkista Komodo Muokkaa: git clone https://github.com/Komodo/KomodoEdit.git

• Komentorivin kautta kirjoita checkout-hakemistoosi ja suorita:

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

  Tämä konfiguroi ja rakentaa mozillan, ja se voi viedä aikaa 30 minuutista useisiin tunteihin (spekseistäsi riippuen). Useimmilla nykyaikaisilla koneilla sen pitäisi kestää noin tunnin.

• Kun mozillan rakentaminen on onnistunut, palaa takaisin repon päähakemistoon ja rakenna komodo:

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

  Tämän pitäisi kestää huomattavasti vähemmän aikaa kuin mozillan rakentaminen.

• Kun rakentaminen on valmis, voit yksinkertaisesti ajaa Komodon suorittamalla bk run

Jos teet muutoksia lähdekoodiin, sinun on jälleen suoritettava bk build,tai yksinkertaisesti bk build && bk run päästäksesi nopeasti takaisin Komodoon. Myöhempien rakennusten pitäisi olla paljon nopeampia, koska suuri osa käännetyistä tiedoista on välimuistissa.

Rakentaminen Macilla

• Mac-edellytykset
• Rakentamisen vaiheet

Mac-edellytykset

• Python >=2.7 (mutta ei vielä Python 3.x). Voit asentaa ActivePythonin täältä.

  Jos haluat Python buildit python.orgista pitäisi myös riittää.

• Xcode 6.4(SDK 10.9 & 10.10). 8.0:n osalta katso alla. Voit hankkia version 6.4 kehittäjien lataussivustolta.

• MacOSX10.10.sdk tai vanhempi

• IDE ONLY SDK 10.8 for Code Intel. Löytyy Xcode 5.1.1

• Jos sinulla on/tarvitaan muita Xcode-versioita asennettuna, voit käyttää xcode-select vaihtaa aktiivisen Xcoden:

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

• Xcoden komentorivityökalut.

  Avaa Xcoden asetukset, valitse ja asenna sitten Lataukset-välilehdeltäCommand Line Tools.

• MacPorts. (Huomautus: Fink voi toimia myös, mutta suurin osa buildin testauksesta ja ohjeista tehdään MacPortsilla.)

• autoconf v2.13. Kun olet asentanut MacPortsin, sinun tarvitsee vain ajaasudo port install autoconf213

• varmistaa, että käytät clangia tai gcc:tä 4.2 (tai uudempaa)

Katso http://developer.mozilla.org/en/docs/Mac_OS_X_Build_Prerequisitesfor lisätietoja Mac OS X:n build-edellytyksistä. Yllä olevien vaiheiden noudattamisen on kuitenkin tarkoitus riittää Komodon rakentamiseen.

Xcode 8 -edellytykset

Virallisesti emme tue Xcode 8:aa, mutta Komodounderin rakentaminen Xcode 8:sta on kuitenkin mahdollista uusien ylimääräisten vaiheiden avulla.

• Kopioi 10.8:n ja 10.9:n SDK:t vanhemmasta XCode-asennuksesta, niiden pitäisi olla osoitteessa:Xcode.app/Contents/Developer/Platforms/macOSX.platform/
• Aseta MinimumSDKVersion arvoksi 10.9 osoitteessa Xcode.app/Contents/Developer/Platforms/macOSX.platform/Info.plist
• Varmista, että käytät ccache 3.1 (uudemmat versiot rikkoutuvat)
• Konfiguroi Mozilla --options=disable-webrtc

Rakennusvaiheet

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

• Käyttämällä terminaalia, mene checkout-hakemistoosi ja suorita:

   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)

  Tämä konfiguroi ja rakentaa mozillan ja voi kestää 30 minuutista useisiin tunteihin (riippuen spekseistäsi). Useimmilla nykyaikaisilla koneilla sen pitäisi kestää noin tunnin.

** Rakentaminen GCC 5.0:lla ja uudemmilla **

Jos käytät GCC 5.0:aa, rakentaminen saattaa epäonnistua. Jos se epäonnistuu,kahteen tiedostoon on tehtävä muutoksia. Jos kuitenkin suoritatpuhtaan buildin ensimmäistä kertaa, sinun on annettava tämän osan buildista epäonnistua ensin. Tämä johtuu siitä, että tiedostot ovat rakentamisen Mozilla-osassa, joka on ladattava ensin.

Nämä tiedostot on muutettava:

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

Katso lisätietoja virheestä #1153109 Mozillan virhetietokannasta.

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

Katso lisätietoja porttauksesta GCC 5:een.

• Kun mozilla on rakennettu onnistuneesti, palaa takaisin repon päähakemistoon ja rakenna 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

  Tämän pitäisi kestää huomattavasti vähemmän aikaa kuin Mozillan rakentaminen.

• Kun build on valmis, voit yksinkertaisesti ajaa Komodon suorittamalla bk run

Jos teet muutoksia lähdekoodiin, sinun on jälleen suoritettava bk build,tai yksinkertaisesti bk build && bk run päästääksesi nopeasti takaisin Komodoon. Myöhempien buildien pitäisi olla paljon nopeampia, koska suuri osa käännetyistä tiedoista on välimuistissa.

Rakentaminen Linuxissa

Linux-ohjeet

Rakentaminen Dockerilla

Helpoisin tapa päästä alkuun on käyttää Docker-kuvaamme, tämä periaatteessa tarjoaa sinulle Ubuntu 12.04 -pohjaisen buildin Komodosta.

Kloonattuasi arkiston yksinkertaisesti navigoi osoitteeseen {repo}/util/docker ja tee checkout ./docklet --help

Käyttääksesi docker-kuvaa sinun täytyy tietysti olla Docker asennettuna sekä X11-tiedonsiirto käytössä SSH-asiakkaassasi (pitäisi toimia oletuksena useimmissa linux-distroissa).

Valmistele Docker-kuva

• Buildaa docker-kuva: ./util/docker/docklet image
• Käynnistä kontti: ./util/docker/docklet start
• SSH:lla konttiisi aloittaaksesi työskentelyn: ./util/docker/docklet ssh

Projektitiedostosi asennetaan osoitteeseen /komodo/dev

HUOMIO – jos päivität aiemmasta versiosta, jossa projektitiedostosi olivat /root/komodo, sinun on korjattava Komodo-projekti- japrofiilikansioiden käyttöoikeudet. Eli:

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

Sinun täytyy myös tehdä rakentamisesi uudelleen (distclean mozilla ja komodo).

Rakentamisen vaiheet

Kun kuvasi on valmis, voit seurata edellä kuvattuja rakentamisen vaiheita linuxille. Suoritat nämä docker-säiliöstä, joten ssh intoit yllä olevalla komennolla ja suorita sitten komennot kohdasta /komodo/dev

Suorittaminen

Kun rakentaminen on valmis, poistut kontista (exit) ja voit sitten suorittaa Komodon. with

./util/docker/docklet run

Voidaksesi rakentaa Komodon uudelleen (muutosten tekemisen jälkeen) ja ajaa sen uudelleen voit käyttää

./util/docker/docklet build run

Jos muutoksesi eivät näy, saatat joutua puhdistamaan buildisi, tehdäksesi tämän käytä

./util/docker/docklet clean

Vai tehdäksesi kaiken kerralla (puhdista, rakenna ja suorita)

./util/docker/docklet clean build run

Rakentamisen komplikaatiot

Jos ensimmäisellä rakentamiskerralla ilmenee virheitä, eikä ole ilmeistä, miten korjata ongelma itse, katso Palaute-osiosta, miten voit ottaa meihin yhteyttä.

Huomaa, että jos rakennuskomplikaatioita ilmenee sen jälkeen, kun olet päivittänyt reposi uusimmilla muutoksilla, saatat joutua tyhjentämään paikallisen välimuistisi, koska se saattaa olla ristiriidassa uusien muutosten kanssa, tehdäksesi tämän suorita bk distclean ennen rakennusvaiheiden suorittamista.

Pro-vinkit

Rakenna yksittäinen kappale

Joskus bk build on liikaa ja bk build quick ei ole tarpeeksi. Jos bk build quick ei näytä poimivan muutoksiasi, kokeile osoittaa bk build kyseiseen kappaleeseen.

Esimerkki

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

Huomautus: Älä luota tähän menetelmään, sillä bk build quick on nopeampi ja tekee joissakin tapauksissa joitain vaiheita, joita yllä oleva esimerkki ei tee. Käytä sitä viimeisenä keinona ennen kuin kokeilet bk distclean && bk build.