Denna Readme förklarar hur du kommer igång med att bygga, använda och utveckla med Komodo Edits källkodsbas.

Samtidigt som Komodo Edits huvudkälla finns i detta arkiv kan du också vilja kolla in de individuella komponent/addon-arkiv som finns påhttps://github.com/Komodo om du bara vill bidra till en specifik komponent. Detta sparar tid och besvär eftersom du inte behöver bygga upp hela projektet.

Innehållsförteckning

• Screenshot
• Download
• Feedback
• Bygga Komodo
  • Bygga på Windows
  • Bygga på Mac
  • Bygga på Linux
  • Bygga med Docker
  • Bygga komplikationer

Skärmdump

Ladda ner

Du kan ladda ner Komodo Edit här.

Feedback

Det finns flera sätt att komma i kontakt med Komodos utvecklare:

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

Forum: http://forum.komodoide.com/

Bug Tracker: 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

Bygga Komodo

Notera att det här är förenklade steg i byggprocessen, för en mer djupgående guide, kolla (föråldrad) BUILD.txt.

Building on Windows

• Prequisites
• Building Steps

Prerequisites

• Python >=2.7 (men inte Python 3.x ännu). Du kan installera ActivePython härifrån.

• Visual C++ 11.0 (även kallad Visual Studio 2012) och alla SDK:er för plattformen för att bygga Mozilla med vc11 enligt beskrivningen här.

• Installera version 1.9.0 av paketet ”MozillaBuild-$ver.exe” i standardförteckningen (dvs. ”C:\mozilla-build”).

  • När det är installerat tar du bort katalogerna wget och hg
  • Hämta version 2.2.0 och installera den i en temporär katalog, kopiera sedan wget-katalogen från 2.2 till 1.9 installationskatalogen

• Installera Perl <= 5.22

• Installera Mercurial

Se http://developer.mozilla.org/en/docs/Windows_Build_Prerequisites mer information om förutsättningarna för att bygga Windows. Det är dock tänkt att det räcker att följa ovanstående steg för att få Komodo att byggas.

Byggsteg

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

• Med hjälp av kommandoraden går du in i din checkout-katalog och kör:

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

  Detta kommer att konfigurera och bygga mozilla och kan ta allt från 30 minuter till flera timmar att slutföra (beroende på dina specifikationer). För de flesta moderna maskiner bör det ta ungefär en timme.

• När mozilla har byggts framgångsrikt går du tillbaka till huvudrepo-katalogen och bygger komodo:

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

  Detta bör ta betydligt mindre tid än att bygga Mozilla.

• När byggnaden är klar kan du helt enkelt köra Komodo genom att köra bk run

När du gör några ändringar i källkoden måste du återigen köra bk build,eller helt enkelt bk build && bk run för att snabbt komma tillbaka till Komodo. Efterföljande byggnationer bör vara mycket snabbare eftersom mycket av de kompilerade uppgifterna lagras i cacheminnet.

Byggnation på Mac

• Mac Förutsättningar
• Byggnadssteg

Mac Förutsättningar

• Python >=2.7 (men inte Python 3.x ännu). Du kan installera ActivePython härifrån.

  Om du föredrar Python-byggsatser från python.org bör det också räcka.

• Xcode 6.4(SDK 10.9 & 10.10). För 8.0 se nedan. Du kan hämta version 6.4 från utvecklarens nedladdningssida.

• MacOSX10.10.sdk eller äldre

• IDE ONLY SDK 10.8 för Code Intel. Finns i Xcode 5.1.1

• Om du har/behöver andra versioner av Xcode installerade kan du använda xcode-select för att ändra den aktiva Xcode:

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

• Xcode Command Line Tools.

  Öppna Xcode-preferenserna och välj och installeraCommand Line Tools under fliken Downloads.

• MacPorts. (Observera: Fink kan också fungera, men de flesta tester och instruktioner för byggandet görs med MacPorts.)

• autoconf v2.13. När du har MacPorts installerat behöver du bara körasudo port install autoconf213

• säkerställa att du använder clang eller gcc 4.2 (eller högre)

Se http://developer.mozilla.org/en/docs/Mac_OS_X_Build_Prerequisitesfor mer detaljer om förutsättningarna för att bygga Mac OS X. Att följa ovanstående steg är dock tänkt att vara tillräckligt för att få Komodo att byggas.

Xcode 8 Förutsättningar

Officiellt har vi inte stöd för Xcode 8, men det är möjligt att bygga Komodounder Xcode 8 med hjälp av ett nytt extra steg.

• Kopiera över SDK:erna 10.8 och 10.9 från en äldre XCode-installation, de bör finnas i:Xcode.app/Contents/Developer/Platforms/macOSX.platform/
• Sätt MinimumSDKVersion till 10.9 i Xcode.app/Contents/Developer/Platforms/macOSX.platform/Info.plist
• Säkerställ att du använder ccache 3.1 (senare versioner går sönder)
• Konfigurera Mozilla med --options=disable-webrtc

Byggsteg

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

• Använd terminalen, gå in i din utcheckningskatalog och kör:

   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)

  Detta kommer att konfigurera och bygga Mozilla och kan ta allt från 30 minuter till flera timmar att slutföra (beroende på dina specifikationer). För de flesta moderna maskiner bör det ta ungefär en timme.

**Bygg med GCC 5.0 och högre **

Om du använder GCC 5.0 kan byggningen misslyckas. Om det gör det finns det ändringar som måste göras i två filer. Om du kör ett rent bygge för första gången måste du dock tillåta att den här delen av bygget misslyckas först. Detta beror på att filerna finns i Mozilla-delen av byggnaden som måste hämtas först.

Dessa filer måste ändras:

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

Se fel #1153109 i Mozillas feldatabas för mer information.

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

Se Anpassning till GCC 5 för mer information.

• När mozilla har byggts framgångsrikt går du tillbaka till huvudrepo-katalogen och bygger 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

  Detta bör ta betydligt mindre tid än att bygga Mozilla.

• När byggnaden är klar kan du helt enkelt köra Komodo genom att köra bk run

När du gör några ändringar i källkoden måste du återigen köra bk build,eller helt enkelt bk build && bk run för att snabbt komma tillbaka till Komodo. Efterföljande byggnationer bör vara mycket snabbare eftersom mycket av den kompilerade datan är cachad.

Bygga på Linux

Instruktioner för Linux

Bygga med Docker

Det enklaste sättet att komma igång är att använda vår Docker-avbildning, detta kommer i princip att förse dig med en Ubuntu 12.04-baserad byggnation av Komodo.

När du har klonat repositoriet kan du helt enkelt navigera in i {repo}/util/docker och checka ut ./docklet --help

För att använda Docker-avbildningen måste du förstås ha Docker installerat samt ha X11-forwarding aktiverat i din SSH-klient (det borde fungera som standard på de flesta Linux-distributioner).

Förbered Docker-avbildningen

• Bygg upp Docker-avbildningen: ./util/docker/docklet image
• Starta din container: ./util/docker/docklet start
• SSH till din container för att börja arbeta: ./util/docker/docklet ssh

Dina projektfiler kommer att monteras på /komodo/dev

OBS – om du uppdaterar från en tidigare version där dina projektfiler låg på /root/komodo måste du fixa behörigheter på dina Komodo projekt- och profilmappar. Ie:

Du kommer också att behöva göra om ditt bygge (distclean mozilla och komodo).

Byggsteg

När din avbildning är förberedd kan du följa byggstegen för linux som beskrivs ovan. Du kommer att köra dessa från dockercontainern, så ssh in i it med kommandot ovan och kör sedan kommandona från /komodo/dev

Running

När byggandet är klart går du ut ur containern (exit) och kan sedan köra Komodo with

./util/docker/docklet run

För att bygga om Komodo (efter att ha gjort ändringar) och köra det igen kan du använda

./util/docker/docklet build run

Om dina ändringar inte återspeglas kan du behöva rensa ditt bygge, för att göra detta använd

./util/docker/docklet clean

Och för att göra allt på en gång (rensa, bygga och köra)

./util/docker/docklet clean build run

Komplikationer i samband med byggandet

Om några fel inträffar under den första byggtiden och det inte är uppenbart hur du ska åtgärda problemet på egen hand, vänligen se avsnittet Feedback för att få information om hur du kan komma i kontakt med oss.

Observera att om byggkomplikationer uppstår efter att du har uppdaterat din repo med de senaste ändringarna kan du behöva rensa din lokala cache eftersom den kan vara i konflikt med de nya ändringarna, för att göra detta kör bk distclean innan du kör dina byggsteg.

Pro-Tips

Bygg ett enda stycke

Ibland är bk build för mycket och bk build quick inte tillräckligt. Om bk build quick inte verkar plocka upp dina ändringar kan du försöka rikta bk build mot stycket i fråga.

Exempel

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

OBSERVERA: Lita inte på den här metoden eftersom bk build quick är snabbare och i vissa fall utför vissa steg som exemplet ovan inte utför. Använd den som ett sista försök innan du försöker bk distclean && bk build.

.