Acest readme explică cum să începi să construiești, să folosești și să dezvolți cu baza de surse Komodo Edit.

În timp ce sursa principală a Komodo Edit este găzduită în acest depozit, este posibil să dorești, de asemenea, să verifici depozitele individuale de componente/adon-uri de sub https://github.com/Komodo în cazul în care dorești să contribui doar la o anumită componentă. Acest lucru vă va economisi ceva timp și vă va scuti de bătăi de cap, deoarece nu va trebui să construiți întregul proiect.

Table of Contents

• Captură de ecran
• Download
• Feedback
• Construirea Komodo
  • Construcția pe Windows
  • Construcția pe Mac
  • Construcția pe Linux
  • Construcția cu Docker
  • Complicații de construcție

Captură de ecran

Descărcare

Puteți descărca Komodo Edit aici.

Feedback

Există mai multe modalități de a intra în contact cu dezvoltatorii Komodo:

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

Forumuri: http://forum.komodoide.com/

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

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

Liste de corespondență: komodo-discuss & komodo-beta & komodo-announce

Construirea Komodo

Rețineți că aceștia sunt pași simplificați ai procesului de construire, pentru un ghid mai aprofundat verificați BUILD (învechit).txt.

Construirea pe Windows

• Precondiții
• Etapele de construire

Precondiții

• Python >=2.7 (dar nu și Python 3.x încă). Puteți instala ActivePython de aici.

• Visual C++ 11.0 (aka Visual Studio 2012) și toate SDK-urile de platformă pentru construirea Mozilla cu vc11, așa cum este descris aici.

• Instalați versiunea 1.9.0 a pachetului „MozillaBuild-$ver.exe” în directorul implicit (adică „C:\mozilla-build”).

  • După instalare, eliminați directoarele wget și hg
  • Descărcați versiunea 2.2.0 și instalați-o într-un director temporar, apoi copiați directorul wget din 2.2 în directorul 1.9 directorul de instalare

• Instalați Perl <= 5.22

• Instalați Mercurial

Vezi http://developer.mozilla.org/en/docs/Windows_Build_Prerequisitespentru mai multe detalii despre prerechizitele pentru construcția Windows. Cu toate acestea, urmarea pașilor de mai sus este menită să fie suficientă pentru a obține construirea Komodo.

Pași de construire

• Cercetați Komodo Edit: git clone https://github.com/Komodo/KomodoEdit.git

• Utilizând linia de comandă, intrați în directorul de verificare și rulați:

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

  Acest lucru va configura și va construi mozilla și poate dura între 30 de minuteși câteva ore pentru a se finaliza (în funcție de specificațiile dumneavoastră). Pentru majoritatea mașinilor moderne ar trebui să dureze aproximativ o oră.

• După ce mozilla este construit cu succes, întoarceți-vă la directorul principal al repo și construiți komodo:

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

  Acest lucru ar trebui să dureze semnificativ mai puțin timp decât construirea Mozilla.

• După ce compilarea s-a finalizat, puteți pur și simplu să rulați Komodo executând bk run

După ce faceți orice modificare la sursă va trebui din nou să rulați bk build,sau pur și simplu bk build && bk run pentru a reveni rapid în Komodo. Compilările ulterioare ar trebui să fie mult mai rapide, deoarece o mare parte din datele compilate sunt stocate în memoria cache.

Compilare pe Mac

• Precondiții Mac
• Etapele de compilare

Precondiții Mac

• Python >=2.7 (dar nu și Python 3.x încă). Puteți instala ActivePython de aici.

  Dacă preferați compilările Python de pe python.org ar trebui să fie de asemenea suficiente.

• Xcode 6.4(SDK 10.9 & 10.10). Pentru 8.0 vedeți mai jos. Puteți obține versiunea 6.4 de pe site-ul de descărcări al dezvoltatorului.

• MacOSX10.10.sdk sau mai vechi

• IDE DOAR SDK 10.8 pentru Code Intel. Poate fi găsit în Xcode 5.1.1

• Dacă aveți/aveți nevoie de alte versiuni de Xcode instalate, atunci puteți folosi xcode-select pentru a schimba Xcode-ul activ:

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

• Xcode Command Line Tools.

  Deschideți preferințele Xcode, apoi, în fila Descărcări, selectați și instalațiCommand Line Tools.

• MacPorts. (Notă: Fink poate funcționa și el, dar cea mai mare parte a testelor și instrucțiunilor de construire se face cu MacPorts.)

• autoconf v2.13. După ce ați instalat MacPorts, trebuie doar să rulațisudo port install autoconf213

• asigurați-vă că folosiți clang sau gcc 4.2 (sau mai mare)

Vezi http://developer.mozilla.org/en/docs/Mac_OS_X_Build_Prerequisitesformai multe detalii despre prerechizitele de compilare Mac OS X. Cu toate acestea, urmarea pașilor de mai sus este menită să fie suficientă pentru a obține construirea Komodo.

Precondiții Xcode 8

Oficial, nu susținem Xcode 8, totuși este posibil să construiți Komodounder Xcode 8 folosind un nou pas suplimentar.

• Copiați SDK-urile 10.8 și 10.9 dintr-o instalare XCode mai veche, acestea ar trebui să fie în:Xcode.app/Contents/Developer/Platforms/macOSX.platform/
• Setați MinimumSDKVersion la 10.9 în Xcode.app/Contents/Developer/Platforms/macOSX.platform/Info.plist
• Asigură-te că folosești ccache 3.1 (versiunile ulterioare se vor întrerupe)
• Configurați Mozilla cu --options=disable-webrtc

Etape de construcție

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

• Utilizând terminalul, intrați în directorul de checkout și rulați:

   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)

  Acest lucru va configura și va construi mozilla și poate dura între 30 de minuteși câteva ore pentru a se finaliza (în funcție de specificațiile dvs.). Pentru majoritatea mașinilor moderne ar trebui să dureze aproximativ o oră.

**Compilare cu GCC 5.0 și versiuni superioare **

Dacă folosiți GCC 5.0, este posibil ca compilarea să eșueze. Dacă da, sunt modificări care trebuie făcute în două fișiere. Cu toate acestea, dacă executați pentru prima dată o compilare curată, trebuie să permiteți ca această parte a compilării să eșueze mai întâi. Acest lucru se datorează faptului că fișierele se află în partea Mozilla a compilării, care trebuie să fie descărcată mai întâi.

Aceste fișiere trebuie să fie modificate:

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

Vezi bug #1153109 în baza de date de bug-uri a Mozilla pentru mai multe informații.

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

Vezi Portarea la GCC 5 pentru mai multe informații.

• După ce mozilla este construit cu succes, reveniți la directorul principal al repo-ului și construiți 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

  Acest lucru ar trebui să dureze semnificativ mai puțin timp decât construirea Mozilla.

• După ce compilarea a fost finalizată, puteți pur și simplu să rulați Komodo executând bk run

După ce faceți orice modificare la sursă va trebui din nou să rulați bk build,sau pur și simplu bk build && bk run pentru a reveni rapid în Komodo. Construcțiile ulterioare ar trebui să fie mult mai rapide, deoarece o mare parte din datele compilate sunt stocate în memoria cache.

Construirea pe Linux

Instrucțiuni pentru Linux

Construirea cu Docker

Cel mai simplu mod de a începe este să folosiți imaginea noastră Docker, aceasta vă va furniza practic o construcție a lui Komodo bazată pe Ubuntu 12.04.

După clonarea depozitului, pur și simplu navigați în {repo}/util/docker și faceți checkout ./docklet --help

Pentru a folosi imaginea Docker trebuie, desigur, să aveți Docker instalat, precum și să aveți X11 forwarding activat în clientul SSH (ar trebui să funcționeze în mod implicit pe majoritatea distribuțiilor Linux).

Pregătiți imaginea Docker

• Construiți imaginea Docker: ./util/docker/docklet image
• Porniți containerul: ./util/docker/docklet start
• SSH în containerul dvs. pentru a începe să lucrați: ./util/docker/docklet ssh

Arhivele de proiect vor fi montate la /komodo/dev

NOTA – dacă actualizați de la o versiune anterioară în care fișierele de proiect se aflau la /root/komodo va trebui să reparați permisiunile pe dosarele Komodo project șiprofile. Ie:

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

De asemenea, va trebui să refaceți compilarea (distclean mozilla și komodo).

Pași de compilare

După ce imaginea dvs. este pregătită puteți urma pașii de compilare pentru linux așa cum sunt descriși mai sus. Veți rula acestea din containerul docker, așa că intrați prin ssh înit folosind comanda de mai sus și apoi rulați comenzile din /komodo/dev

Running

După ce construcția este completă, ieșiți din container (exit) și puteți apoi rula Komodo cu

./util/docker/docklet run

Pentru a reconstrui Komodo (după ce ați făcut modificări) și a-l rula din nou puteți folosi

./util/docker/docklet build run

Dacă modificările dvs. nu sunt reflectate, este posibil să aveți nevoie să vă curățați construcția, pentru a face acest lucru folosiți

./util/docker/docklet clean

Sau pentru a face totul dintr-o dată (curățați, construiți și rulați)

./util/docker/docklet clean build run

Complicații de construire

Dacă apar erori în timpul primei construcții și nu este evident cum să rezolvați problema pe cont propriu, vă rugăm să consultați secțiunea Feedback pentru a ne contacta.

Rețineți că dacă apar complicații de construire după ce v-ați actualizat repo-ul cu cele mai recentemodificări s-ar putea să aveți nevoie să vă ștergeți memoria cache locală deoarece ar putea intra în conflict cu noile modificări, pentru a face acest lucru rulați bk distclean înainte de a rula pașii de construire.

Sfaturi pro

Construiți o singură bucată

Câteodată bk build este prea mult și bk build quick nu este suficient. Dacă bk build quick nu pare să vă preia modificările, încercați să îndreptați bk build către piesa în cauză.

Exemplu

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

NOTA: Nu vă bazați pe această metodă, deoarece bk build quick este mai rapidă și, în unele cazuri, face anumiți pași pe care exemplul de mai sus nu îi va efectua. Folosiți-o ca un ultim efort înainte de a încerca bk distclean && bk build.

.