Ten plik Readme wyjaśnia, jak zacząć budować, używać i rozwijać bazę źródłową Komodo Edit.

Podczas gdy główne źródło Komodo Edit znajduje się w tym repozytorium, możesz również sprawdzić repozytoria poszczególnych komponentów/addonów pod adresemhttps://github.com/Komodo w przypadku, gdy chcesz tylko współtworzyć konkretny komponent. Pozwoli ci to zaoszczędzić trochę czasu i kłopotów, ponieważ nie będziesz musiał budować całego projektu.

Spis treści

• Zrzut ekranu
• Pobieranie
• Opinie
• Budowanie Komodo
  • Budowanie na Windows
  • Budowanie na Mac
  • Budowanie na Linux
  • Building with Docker
  • Building Complications

Zrzut ekranu

Pobierz

Możesz pobrać Komodo Edit tutaj.

Informacje zwrotne

Jest kilka sposobów na skontaktowanie się z twórcami Komodo:

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

Forumy: http://forum.komodoide.com/

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

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

Listy mailingowe: komodo-discuss & komodo-beta & komodo-announce

Budowanie Komodo

Zauważ, że są to uproszczone kroki procesu budowania, dla bardziej dogłębnego przewodnika sprawdź (przestarzały) BUILD.txt.

Building on Windows

• Prerequisites
• Building Steps

Prerequisites

• Python >=2.7 (ale jeszcze nie Python 3.x). Możesz zainstalować ActivePython stąd.

• Visual C++ 11.0 (aka Visual Studio 2012) i wszystkie Platform SDKs do budowania Mozilli z vc11, jak opisano tutaj.

• Zainstaluj wersję 1.9.0 pakietu „MozillaBuild-$ver.exe” w domyślnym dir (tj. „C:™mozilla-build”).

  • Po zainstalowaniu usuń katalogi wget i hg
  • Ściągnij wersję 2.2.0 i zainstaluj ją w katalogu tymczasowym, następnie skopiuj katalog wget z 2.2 do katalogu 1.9 install directory

• Install the Perl <= 5.22

• Install Mercurial

See http://developer.mozilla.org/en/docs/Windows_Build_Prerequisites form more details on Windows build prerequisites. Jednakże, wykonanie powyższych kroków powinno wystarczyć do zbudowania Komodo.

Kroki budowania

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

• Używając wiersza poleceń, wprowadź swój katalog i uruchom:

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

  To skonfiguruje i zbuduje mozillę i może zająć od 30 minut do kilku godzin (w zależności od specyfikacji). Dla większości nowoczesnych maszyn powinno to trwać około godziny.

• Po pomyślnym zbudowaniu mozilli wróć do głównego katalogu repo i zbuduj komodo:

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

  To powinno zająć znacznie mniej czasu niż budowanie Mozilli.

• Po zakończeniu budowania możesz po prostu uruchomić Komodo wykonując bk run

Po dokonaniu jakichkolwiek modyfikacji w źródle będziesz musiał ponownie uruchomić bk build, lub po prostu bk build && bk run aby szybko wrócić do Komodo. Kolejne kompilacje powinny być znacznie szybsze, ponieważ wiele skompilowanych danych jest buforowanych.

Budowanie na Macu

• Wymagania wstępne Maca
• Kroki budowania

Wymagania wstępne Maca

• Python >=2.7 (ale jeszcze nie Python 3.x). Możesz zainstalować ActivePython stąd.

  Jeśli wolisz kompilacje Pythona z python.org również powinny wystarczyć.

• Xcode 6.4(SDK 10.9 & 10.10). Dla 8.0 patrz poniżej. Możesz uzyskać wersję 6.4 ze strony pobierania dla deweloperów.

• MacOSX10.10.sdk lub starszy

• IDE ONLY SDK 10.8 for Code Intel. Można znaleźć w Xcode 5.1.1

• Jeśli masz/potrzebujesz zainstalowane inne wersje Xcode, to możesz użyć xcode-select, aby zmienić aktywny Xcode:

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

• Narzędzia wiersza poleceń Xcode.

  Otwórz preferencje Xcode, a następnie w zakładce Downloads wybierz i zainstaluj Narzędzia wiersza poleceń.

• MacPorts. (Uwaga: Fink może również działać, ale większość testów i instrukcji dotyczących budowy jest wykonywana przy użyciu MacPorts.)

• autoconf v2.13. Po zainstalowaniu MacPorts musisz tylko uruchomićsudo port install autoconf213

• upewnić się, że używasz clang lub gcc 4.2 (lub wyższy)

Zobacz http://developer.mozilla.org/en/docs/Mac_OS_X_Build_Prerequisitesforwięcej szczegółów na temat wymagań wstępnych kompilacji Mac OS X. Jednak wykonanie powyższych kroków powinno wystarczyć do zbudowania Komodo.

Xcode 8 Wymagania wstępne

Oficjalnie nie wspieramy Xcode 8, jednak możliwe jest zbudowanie Komodounder Xcode 8 przy użyciu dodatkowych kroków.

• Kopiujemy SDK 10.8 i 10.9 ze starszej instalacji XCode, powinny się one znajdować w:Xcode.app/Contents/Developer/Platforms/macOSX.platform/
• Ustawiamy MinimumSDKVersion na 10.9 w Xcode.app/Contents/Developer/Platforms/macOSX.platform/Info.plist
• Upewnij się, że używasz ccache 3.1 (późniejsze wersje się zepsują)
• Skonfiguruj Mozillę za pomocą --options=disable-webrtc

Kroki budowania

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

• Używając terminala, wejdź do swojego katalogu i uruchom:

   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)

  To skonfiguruje i zbuduje mozillę i może zająć od 30 minut do kilku godzin (w zależności od specyfikacji). Dla większości nowoczesnych maszyn powinno to być około godziny.

** Budowanie z GCC 5.0 i wyższym **

Jeśli używasz GCC 5.0, budowanie może się nie powieść. Jeśli tak się stanie, są zmiany, które należy wprowadzić do dwóch plików. Jednakże, jeśli uruchamiasz czystą kompilację po raz pierwszy, musisz pozwolić, aby ta część kompilacji zakończyła się najpierw niepowodzeniem. Dzieje się tak, ponieważ pliki znajdują się w części kompilacji Mozilli, która musi być pobrana jako pierwsza.

Te pliki muszą być zmienione:

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

Zobacz błąd #1153109 w bazie błędów Mozilli, aby uzyskać więcej informacji.

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

Zobacz Porting do GCC 5, aby uzyskać więcej informacji.

• Po pomyślnym zbudowaniu mozilli, wróć do głównego katalogu repo i zbuduj 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

  To powinno zająć znacznie mniej czasu niż budowanie Mozilli.

• Po zakończeniu budowania możesz po prostu uruchomić Komodo wykonując bk run

Po dokonaniu jakichkolwiek modyfikacji w źródle będziesz musiał ponownie uruchomić bk build, lub po prostu bk build && bk run, aby szybko wrócić do Komodo. Kolejne kompilacje powinny być o wiele szybsze, ponieważ wiele skompilowanych danych jest buforowanych.

Budowanie na Linuksie

Instrukcje dla Linuksa

Budowanie za pomocą Dockera

Najłatwiejszym sposobem na rozpoczęcie jest użycie naszego obrazu Dockera, który dostarczy Ci kompilację Komodo opartą na Ubuntu 12.04.

Po sklonowaniu repozytorium po prostu przejdź do {repo}/util/docker i sprawdź ./docklet --help

Aby użyć obrazu dockera musisz oczywiście mieć zainstalowanego Dockera, jak również mieć włączone przekierowanie X11 w kliencie SSH (powinno działać domyślnie na większości dystrybucji).

Przygotuj obraz dockera

• Zbuduj obraz dockera: ./util/docker/docklet image
• Uruchom swój kontener: ./util/docker/docklet start
• SSH do swojego kontenera, aby rozpocząć pracę: ./util/docker/docklet ssh

Twoje pliki projektu będą zamontowane pod adresem /komodo/dev

UWAGA – jeśli aktualizujesz z poprzedniej wersji, gdzie twoje pliki projektu były /root/komodo będziesz musiał naprawić uprawnienia do folderów projektu Komodo iprofile. Ie:

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

Będziesz także musiał ponownie wykonać swój build (distclean mozilla i komodo).

Kroki budowania

Gdy twój obraz jest przygotowany możesz wykonać kroki budowania dla linuxa opisane powyżej. Będziesz je uruchamiał z kontenera docker, więc ssh intoit używając powyższej komendy, a następnie uruchom komendy z /komodo/dev

Running

Po zakończeniu budowania wychodzisz z kontenera (exit) i możesz uruchomić Komodo with

./util/docker/docklet run

Aby przebudować Komodo (po wprowadzeniu zmian) i uruchomić je ponownie możesz użyć

./util/docker/docklet build run

Jeśli twoje zmiany nie są odzwierciedlane możesz potrzebować wyczyścić swój build, w tym celu użyj

./util/docker/docklet clean

Albo zrób to wszystko na raz (wyczyść, zbuduj i uruchom)

./util/docker/docklet clean build run

Komplikacje w budowaniu

Jeśli wystąpią jakiekolwiek błędy podczas pierwszego budowania i nie jest oczywiste, jak rozwiązać ten problem samodzielnie, prosimy o zapoznanie się z sekcją Opinie, jak się z nami skontaktować.

Zauważ, że jeśli komplikacje z budową pojawią się po aktualizacji twojego repo z najnowszymi zmianami, możesz potrzebować wyczyścić lokalną pamięć podręczną, ponieważ może ona być w konflikcie z nowymi zmianami, aby to zrobić uruchom bk distclean przed uruchomieniem kroków budowania.

Pro-Tips

Buduj pojedynczy element

Czasami bk build to za dużo, a bk build quick nie wystarczy. Jeśli bk build quick nie wydaje się odbierać twoich zmian, spróbuj skierować bk build na dany kawałek.

Przykład

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

UWAGA: Nie polegaj na tej metodzie, ponieważ bk build quick jest szybszy i w niektórych przypadkach wykonuje pewne kroki, których powyższy przykład nie wykona. Użyj jej jako ostatniej deski ratunku przed wypróbowaniem bk distclean && bk build.

.