Dette readme forklarer, hvordan du kommer i gang med at bygge, bruge og udvikle med Komodo Edit-kildebasen.

Mens Komodo Edit-hovedkilden er hostet under dette arkiv, kan du også tjekke de individuelle komponent/addon-repositorier underhttps://github.com/Komodo, hvis du kun ønsker at bidrage til en specifikkomponent. Dette vil spare dig tid og besvær, da du ikke behøver at bygge hele projektet.

Indholdsfortegnelse

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

Skærmbillede

Download

Du kan downloade Komodo Edit her.

Feedback

Der er flere måder at komme i kontakt med Komodo udviklerne på:

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

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

http://forum.komodoide.com/

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

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

Mailinglister: komodo-discuss & komodo-beta & komodo-announce

Opbygning af Komodo

Bemærk, at dette er forenklede trin af opbygningsprocessen, for en mere dybdegående vejledning, se (forældet) BUILD.txt.

Bygning på Windows

• Forudsætninger
• Bygningsskridt

Forudsætninger

• Python >=2.7 (men ikke Python 3.x endnu). Du kan installere ActivePython herfra.

• Visual C++ 11.0 (alias Visual Studio 2012) og alle Platform SDK’er til opbygning af Mozilla med vc11 som beskrevet her.

• Installer version 1.9.0 af “MozillaBuild-$ver.exe”-pakken i standarddich(dvs. “C:\mozilla-build”).

  • Når den er installeret, skal du fjerne wget- og hg-mapperne
  • Download version 2.2.0 og installer den i en temp-mappe, og kopier derefter wget-mappen fra 2.2 til 1.9 installationsmappe

• Installer Perl <= 5.22

• Installer Mercurial

Se http://developer.mozilla.org/en/docs/Windows_Build_Prerequisitesfor yderligere detaljer om forudsætninger for Windows-bygning. Det er dog meningen, at det er tilstrækkeligt at følge ovenstående trin for at få Komodo til at bygge.

Bygningstrin

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

• Giv dig ind i din checkout-mappe på kommandolinjen, og kør:

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

  Dette vil konfigurere og bygge mozilla og kan tage alt fra 30 minutter til flere timer at gennemføre (afhængigt af dine specifikationer). For de fleste moderne maskiner bør det være omkring en time.

• Når mozilla er bygget med succes, skal du gå tilbage til hovedrepo-mappen og bygge komodo:

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

  Dette bør tage betydeligt mindre tid end at bygge Mozilla.

• Når build’en er færdig, kan du blot køre Komodo ved at udføre bk run

Når du foretager ændringer i kildekoden, skal du igen køre bk build,eller blot bk build && bk run for hurtigt at komme tilbage til Komodo. Efterfølgende builds skulle være meget hurtigere, da mange af de kompilerede data er cachet.

Bygning på Mac

• Mac Prerequisites
• Building Steps

Mac Prerequisites

• Python >=2.7 (men ikke Python 3.x endnu). Du kaninstallere ActivePython herfra.

  Hvis du foretrækker Python-builds fra python.org burde det også være tilstrækkeligt.

• Xcode 6.4(SDK 10.9 & 10.10). For 8.0 se nedenfor. Du kan få version 6.4 fra udviklerens downloadsite.

• MacOSX10.10.sdk eller ældre

• IDE KUN SDK 10.8 for Code Intel. Kan findes i Xcode 5.1.1

• Hvis du har/har brug for andre versioner af Xcode installeret, kan du bruge xcode-select til at ændre den aktive Xcode:

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

• Xcode Command Line Tools.

  Åbn Xcode-præferencerne, og under fanen Downloads skal du vælge og installereCommand Line Tools.

• MacPorts. (Bemærk: Fink kan også fungere, men det meste af build-testningen og instruktionerne er udført med MacPorts.)

• autoconf v2.13. Når du har MacPorts installeret, skal du blot køresudo port install autoconf213

• sørg for, at du bruger clang eller gcc 4.2 (eller højere)

Se http://developer.mozilla.org/en/docs/Mac_OS_X_Build_Prerequisitesfor flere detaljer om forudsætninger for Mac OS X-bygningen. Det er dog meningen, at det er tilstrækkeligt at følge ovenstående trin for at få Komodo bygget.

Xcode 8-forudsætninger

Officielt understøtter vi ikke Xcode 8, men det er muligt at bygge Komodounder Xcode 8 ved hjælp af et nyt ekstra trin.

• Kopier SDK’erne 10.8 og 10.9 over fra en ældre XCode-installation, de skal være i:Xcode.app/Contents/Developer/Platforms/macOSX.platform/
• Sæt MinimumSDKVersion til 10.9 i Xcode.app/Contents/Developer/Platforms/macOSX.platform/Info.plist
• Sørg for, at du bruger ccache 3.1 (senere versioner vil gå i stykker)
• Konfigurer Mozilla med --options=disable-webrtc

Byggetrin

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

• Indtast din checkout-mappe i terminalen og 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)

  Dette vil konfigurere og bygge Mozilla og kan tage alt fra 30 minutter til flere timer at gennemføre (afhængigt af dine specifikationer). For de fleste moderne maskiner bør det tage omkring en time.

**Bygning med GCC 5.0 og højere **

Hvis du bruger GCC 5.0, kan opbygningen mislykkes. Hvis det gør,er der ændringer, der skal foretages i to filer. Men hvis du kører et rent build for første gang, skal du tillade, at denne del af buildet fejler først. Det skyldes, at filerne er i Mozilla-delen af build’et, som skal hentes først.

Disse filer skal ændres:

1. /KomodoEdit/mozilla/build/moz3500-ko9.10/mozilla/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 fejl #1153109 i Mozillas fejldatabase for yderligere oplysninger.

1. /KomodoEdit/mozilla/build/moz3500-ko9.10/mozilla/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 Portering til GCC 5 for yderligere oplysninger.

• Når mozilla er bygget med succes, skal du gå tilbage til hovedrepo-mappen og bygge 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

  Dette skulle tage betydeligt mindre tid end at bygge Mozilla.

• Når build’en er færdig, kan du blot køre Komodo ved at udføre bk run

Når du foretager ændringer i kilden, skal du igen køre bk build,eller blot bk build && bk run for hurtigt at komme tilbage til Komodo. Efterfølgende builds skulle være meget hurtigere, da mange af de kompilerede data er cachet.

Bygning på Linux

Linux-instruktioner

Bygning med Docker

Den nemmeste måde at komme i gang på er at bruge vores Docker-image, dette vil dybest set give dig et Ubuntu 12.04-baseret build af Komodo.

Når du har klonet repositoryet skal du blot navigere ind i {repo}/util/docker og checke ud ./docklet --help

For at bruge docker-image skal du selvfølgelig have Docker installeret samt have X11 forwarding aktiveret i din SSH-klient (burde virke som standard på de fleste Linux-distroer).

Forbered Docker-image

• Byg docker-image op: ./util/docker/docklet image
• Start din container: ./util/docker/docklet start
• SSH ind i din container for at begynde at arbejde: ./util/docker/docklet ssh

Dine projektfiler vil blive monteret på /komodo/dev

BEMÆRK – hvis du opdaterer fra en tidligere version, hvor dine projektfiler var på /root/komodo, skal du rette tilladelser på dine Komodo projekt- og profilmapper. Dvs:

Du skal også lave din build om (fjern mozilla og komodo).

Byggetrin

Når dit image er forberedt, kan du følge byggetrinene for linux som beskrevet ovenfor. Du vil køre disse fra docker-containeren, så ssh ind iit ved hjælp af kommandoen ovenfor og kør derefter kommandoerne fra /komodo/dev

Running

Når din opbygning er færdig, afslutter du ud af containeren (exit) og kan derefter køre Komodo med

./util/docker/docklet run

For at genopbygge Komodo (efter at have foretaget ændringer) og køre den igen kan du bruge

./util/docker/docklet build run

Hvis dine ændringer ikke bliver afspejlet, skal du muligvis rense dit build, for at gøre dette brug

./util/docker/docklet clean

Og for at gøre det hele på én gang (rense, bygge og køre)

./util/docker/docklet clean build run

Byggekomplikationer

Hvis der opstår fejl under din første byggetid, og det ikke er indlysende, hvordan du selv kan løse problemet, henvises du til afsnittet Feedback om, hvordan du kan komme i kontakt med os.

Bemærk, at hvis der opstår komplikationer ved opbygning, efter du har opdateret din repo med de seneste ændringer, skal du muligvis rydde din lokale cache, da den kan være i konflikt med de nye ændringer, for at gøre dette skal du køre bk distclean, før du kører dine opbygningstrin.

Pro-Tips

Byg et enkelt stykke

I nogle tilfælde er bk build for meget, og bk build quick er ikke nok. Hvis bk build quick ikke ser ud til at opsamle dine ændringer, kan du prøve at pege bk build på det pågældende stykke.

Eksempel

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

BEMÆRK: Stol ikke på denne metode, da bk build quick er hurtigere og i nogle tilfælde udfører nogle trin, som ovenstående eksempel ikke vil udføre. Brug den som et sidste forsøg, før du prøver bk distclean && bk build.