Toto readme vysvětluje, jak začít vytvářet, používat a vyvíjet se zdrojovým kódem Komodo Edit.

Zatímco hlavní zdrojový kód Komodo Edit je umístěn v tomto repozitáři, můžete se také podívat na jednotlivé komponenty/addon repozitáře podhttps://github.com/Komodo v případě, že chcete přispět pouze do konkrétní komponenty. Ušetříte si tak čas a starosti, protože nebudete muset vytvářet celý projekt.

Obsah

• Snímek obrazovky
• Stáhnout
• Zpětná vazba
• Sestavení Komodo
  • Sestavení na Windows
  • Sestavení na Macu
  • Stavení na Linux
  • Stavba s Dockerem
  • Stavba komplikací

Snímek obrazovky

Stáhnout

Komodo Edit si můžete stáhnout zde.

Zpětná vazba

Existuje několik způsobů, jak se spojit s vývojáři Komodo:

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

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

Sledovač chyb: https://github.com/Komodo/KomodoEdit/issues

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

Mailové konference: komodo-discuss & komodo-beta & komodoannounce

Sestavování Komodo

Poznamenejme, že toto jsou zjednodušené kroky procesu sestavování, pro podrobnější návod se podívejte na (zastaralý) BUILD.txt.

Sestavování v systému Windows

• Předpoklady
• Kroky sestavování

Předpoklady

• Python >=2.7 (ale ještě ne Python 3.x). ActivePython můžete nainstalovat odtud.

• Visual C++ 11.0 (alias Visual Studio 2012) a všechny Platform SDK pro sestavení Mozilly pomocí vc11, jak je popsáno zde.

• Instalujte verzi 1.9.0 balíčku „MozillaBuild-$ver.exe“ do výchozího adresáře(tj. „C:\mozilla-build“).

  • Po instalaci odstraňte adresáře wget a hg
  • Stáhněte verzi 2.2.0 a nainstalujte ji do dočasného adresáře, poté zkopírujte adresář wget z verze 2.2 do adresáře 1.9 instalační adresář

• Instalace Perlu <= 5.22

• Instalace Mercurialu

Další podrobnosti o předpokladech pro sestavení systému Windows najdete v http://developer.mozilla.org/en/docs/Windows_Build_Prerequisites. Dodržení výše uvedených kroků by však mělo stačit k tomu, aby se Komodo sestavilo.

Kroky sestavení

• Zkonfigurujte Komodo Upravit: git clone https://github.com/Komodo/KomodoEdit.git

• Pomocí příkazového řádku zadejte adresář checkout a spusťte:

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

  Tento proces nakonfiguruje a sestaví Mozillu a může trvat od 30 minutdo několika hodin (v závislosti na vašich specifikacích). U většiny moderních strojů by to mělo trvat asi hodinu.

• Po úspěšném sestavení mozilly se vraťte do hlavního adresáře repozitáře a sestavte komodo:

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

  To by mělo trvat podstatně kratší dobu než sestavení mozilly.

• Po dokončení sestavení můžete jednoduše spustit Komodo příkazem bk run

Po provedení jakýchkoli úprav ve zdrojovém kódu budete muset opět spustit příkaz bk build,nebo jednoduše bk build && bk run, abyste se rychle dostali zpět do Komoda. Následné sestavení by mělo být mnohem rychlejší, protože většina zkompilovaných dat je uložena v mezipaměti.

Sestavení na Macu

• Předpoklady pro Mac
• Kroky sestavení

Předpoklady pro Mac

• Python >=2.7 (ale ještě ne Python 3.x). ActivePython můžete nainstalovat odtud.

  Pokud dáváte přednost sestavení Pythonu z python.org, mělo by vám také stačit.

• Xcode 6.4(SDK 10.9 & 10.10). Pro verzi 8.0 viz níže. Verzi 6.4 můžete získat ze stránek pro vývojáře ke stažení.

• MacOSX10.10.sdk nebo starší

• IDE POUZE SDK 10.8 pro Code Intel. Lze nalézt v Xcode 5.1.1

• Pokud máte/potřebujete nainstalované jiné verze Xcode, pak můžete pomocí xcode-select změnit aktivní Xcode:

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

• Nástroje příkazového řádku Xcode.

  Otevřete předvolby Xcode a poté na kartě Stažené soubory vyberte a nainstalujteNástroje příkazového řádku.

• MacPorty. (Poznámka: Fink může fungovat také, ale většina testování sestavení a návodů se provádí s MacPorts.)

• autoconf v2.13. Po instalaci MacPorts stačí spustit sudo port install autoconf213

• zajistit, že používáte clang nebo gcc 4.2 (nebo vyšší)

Podívejte se na http://developer.mozilla.org/en/docs/Mac_OS_X_Build_Prerequisitesforpodrobnější informace o předpokladech pro sestavení v systému Mac OS X. Dodržení výše uvedených kroků by však mělo stačit k tomu, aby se Komodo sestavilo.

Předpoklady pro Xcode 8

Oficiálně Xcode 8 nepodporujeme, je však možné sestavit Komodounder Xcode 8 pomocí nových dodatečných kroků.

• Překopírujte SDK 10.8 a 10.9 ze starší instalace XCode, měly by být v:Xcode.app/Contents/Developer/Platforms/macOSX.platform/
• Nastavte MinimumSDKVersion na 10.9 v Xcode.app/Contents/Developer/Platforms/macOSX.platform/Info.plist
• Ujistěte se, že používáte ccache 3.1 (novější verze se rozbijí)
• Konfigurujte Mozillu pomocí --options=disable-webrtc

Kroky sestavování

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

• Pomocí terminálu vstupte do adresáře checkout a spusťte:

   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)

  Tato konfigurace a sestavení Mozilly může trvat od 30 minutdo několika hodin (v závislosti na vašich specifikacích). U většiny moderních strojů by to mělo trvat asi hodinu.

** Sestavení s GCC 5.0 a vyšším **

Pokud používáte GCC 5.0, sestavení může selhat. Pokud se tak stane,je třeba provést změny ve dvou souborech. Pokud však spouštítečisté sestavení poprvé, musíte povolit, aby tato část sestavení selhala jako první. Je to proto, že tyto soubory jsou v části sestavení Mozilla, kterou je třeba stáhnout jako první.

Tyto soubory je třeba změnit:

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

Další informace viz chyba #1153109 v databázi chyb Mozilly.

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

Další informace viz Portování na GCC 5.

• Po úspěšném sestavení Mozilly se vraťte do hlavního adresáře repozitáře a sestavte 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 by mělo trvat podstatně kratší dobu než sestavení Mozilly.

• Po dokončení sestavení můžete jednoduše spustit Komodo příkazem bk run

Po provedení jakýchkoli úprav ve zdrojovém kódu budete muset opět spustit příkaz bk build,nebo jednoduše bk build && bk run, abyste se rychle dostali zpět do Komoda. Následné sestavení by mělo být mnohem rychlejší, protože většina zkompilovaných dat je uložena v mezipaměti.

Sestavení v Linuxu

Návod pro Linux

Sestavení pomocí Dockeru

Nejjednodušší způsob, jak začít, je použít náš obraz Dockeru, který vám v podstatě poskytne sestavení Komoda založené na Ubuntu 12.04. V případě, že se vám to podaří, můžete začít pracovat s dockerem.

Po naklonování repozitáře jednoduše přejděte do {repo}/util/docker a zaškrtněte ./docklet --help

Pro použití obrazu Docker musíte mít samozřejmě nainstalovaný Docker a také mít v klientovi SSH povoleno přesměrování X11 (ve výchozím nastavení by mělo fungovat ve většině linuxových distribucí).

Příprava obrazu Docker

• Sestavte obraz Docker: ./util/docker/docklet image
• Spusťte kontejner: ./util/docker/docklet start
• SSH do kontejneru a začněte pracovat: ./util/docker/docklet ssh

Vaše projektové soubory budou připojeny na /komodo/dev

POZNÁMKA – pokud aktualizujete z předchozí verze, kde byly vaše projektové soubory na /root/komodo, budete muset opravit práva na složkách Komodo project aprofile. Tj:

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

Také budete muset znovu provést sestavení (distclean mozilla a komodo).

Kroky sestavení

Jakmile je váš obraz připraven, můžete postupovat podle kroků sestavení pro linux, jak je popsáno výše. Budete je spouštět z kontejneru docker, takže se do něj přihlaste pomocí výše uvedeného příkazu a poté spusťte příkazy z /komodo/dev

Spuštění

Po dokončení sestavení ukončete kontejner (exit) a poté můžete spustit Komodo pomocí

./util/docker/docklet run

Pro opětovné sestavení Komoda (po provedení změn) a jeho spuštění můžete použít

./util/docker/docklet build run

Pokud se vaše změny neprojeví, možná budete muset sestavení vyčistit, k tomu použijte

./util/docker/docklet clean

Nebo to udělejte najednou (vyčistit, sestavit a spustit)

./util/docker/docklet clean build run

Komplikace při sestavování

Pokud se během prvního sestavení objeví nějaké chyby a není zřejmé, jak problém vyřešit sami, podívejte se do sekce Zpětná vazba, jak se s námi spojit.

Poznamenejte, že pokud se komplikace při sestavování objeví poté, co jste aktualizovali repozitář o nejnovějšízměny, možná budete muset vymazat místní mezipaměť, protože může být v konfliktu s novými změnami, za tímto účelem spusťte bk distclean před spuštěním kroků sestavení.

Pro-Tipy

Sestavte jeden kus

Někdy je bk build příliš mnoho a bk build quick nestačí. Pokud se zdá, že bk build quick nezachytí vaše změny, zkuste nasměrovat bk build na daný kus.

Příklad

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

POZNÁMKA: Nespoléhejte se na tuto metodu, protože bk build quick je rychlejší a v některých případech provádí některé kroky, které výše uvedený příklad neprovede. Použijte ji jako poslední pokus, než zkusíte bk distclean && bk build.