Este readme explica cómo empezar a construir, utilizar y desarrollar con la base de código fuente de Komodo Edit.

Mientras que el código fuente principal de Komodo Edit está alojado en este repositorio también puede querer comprobar los repositorios de componentes/addon individuales en https://github.com/Komodo en caso de que sólo quiera contribuir a un componente específico. Esto le ahorrará algo de tiempo y molestias ya que no tendrá que construir todo el proyecto.

Tabla de contenidos

• Captura de pantalla
• Descarga
• Comentarios
• Construyendo Komodo
  • Construyendo en Windows
  • Construyendo en Mac
  • Construyendo en Linux
  • Construyendo con Docker
  • Complicaciones de la construcción

Captura de pantalla

Descarga

Puedes descargar Komodo Edit aquí.

Comentarios

Hay varias formas de ponerse en contacto con los desarrolladores de Komodo:

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

Foro: http://forum.komodoide.com/

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

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

Listas de correo: komodo-discuss & komodo-beta & komodo-announce

Construcción de Komodo

Nótese que estos son pasos simplificados del proceso de construcción, para una guía más profunda revisa el (obsoleto) BUILD.txt.

Construcción en Windows

• Requisitos previos
• Pasos de construcción

Requisitos previos

• Python >=2.7 (pero no Python 3.x todavía). Puedes instalar ActivePython desde aquí.

• Visual C++ 11.0 (también conocido como Visual Studio 2012) y todos los SDKs de la plataforma para construir Mozilla con vc11 como se describe aquí.

• Instalar la versión 1.9.0 del paquete «MozillaBuild-$ver.exe» en el directorio por defecto (es decir, «C:\zilla-build»).

  • Una vez instalado elimine los directorios wget y hg
  • Descargue la versión 2.2.0 e instálela en un directorio temporal, luego copie el directorio wget de la 2.2 al directorio de instalación de la 1.9 directorio de instalación

• Instalar el Perl <= 5.22

• Instalar Mercurial

Ver http://developer.mozilla.org/en/docs/Windows_Build_Prerequisites para más detalles sobre los requisitos previos de construcción de Windows. Sin embargo, siguiendo los abovesteps se supone que es suficiente para obtener Komodo edificio.

Pasos de la construcción

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

• Usando la línea de comandos, entre en su directorio de control y ejecute:

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

  Esto configurará y construirá mozilla y puede tomar desde 30 minutos a varias horas para completar (dependiendo de sus especificaciones). Para la mayoría de las máquinas modernas debería ser alrededor de una hora.

• Después de que mozilla se construya con éxito vuelva al directorio principal del repo y construya komodo:

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

  Esto debería tomar mucho menos tiempo que la construcción de Mozilla.

• Una vez que la construcción se ha completado simplemente puede ejecutar Komodo ejecutando bk run

Al hacer cualquier modificación en la fuente tendrá que ejecutar de nuevo bk build, o simplemente bk build && bk run para volver rápidamente a Komodo. Las construcciones posteriores deberían ser mucho más rápidas ya que gran parte de los datos compilados se almacenan en la caché.

Construcción en Mac

• Requisitos previos para Mac
• Pasos para la construcción

Requisitos previos para Mac

• Python >=2.7 (pero no Python 3.x todavía). Puedes instalar ActivePython desde aquí.

  Si prefieres las compilaciones de Python desde python.org deberían ser suficientes también.

• Xcode 6.4(SDK 10.9 & 10.10). Para la 8.0 ver más abajo. Puede obtener la versión 6.4 desde el sitio de descargas para desarrolladores.

• MacOSX10.10.sdk o anterior

• Sólo SDK 10.8 para Code Intel. Se puede encontrar en Xcode 5.1.1

• Si tienes/necesitas otras versiones de Xcode instaladas entonces puedes usar xcode-select para cambiar el Xcode activo:

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

• Herramientas de línea de comandos de Xcode.

  Abra las preferencias de Xcode, luego en la pestaña Descargas, seleccione e instale elCommand Line Tools.

• MacPorts. (Nota: Fink puede funcionar también, pero la mayor parte de las pruebas de construcción y las instrucciones se hacen con MacPorts.)

• autoconf v2.13. Una vez que tenga MacPorts instalado sólo tiene que ejecutarsudo port install autoconf213

• asegurarse de que está utilizando clang o gcc 4.2 (o superior)

Vea http://developer.mozilla.org/en/docs/Mac_OS_X_Build_Prerequisitesformás detalles sobre los requisitos previos de compilación de Mac OS X. Sin embargo, siguiendo theabove pasos se supone que es suficiente para obtener Komodo building.

Xcode 8 Prerrequisitos

Oficialmente no apoyamos Xcode 8, sin embargo, es posible construir Komodounder Xcode 8 utilizando un nuevo pasos adicionales.

• Copie los SDK 10.8 y 10.9 de una instalación antigua de XCode, deberían estar en:Xcode.app/Contents/Developer/Platforms/macOSX.platform/
• Ajuste MinimumSDKVersion a 10.9 en Xcode.app/Contents/Developer/Platforms/macOSX.platform/Info.plist
• Asegúrese de que está utilizando ccache 3.1 (las versiones posteriores se romperán)
• Configure Mozilla con --options=disable-webrtc

Pasos de construcción

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

• Usando el terminal, entra en tu directorio de checkout y ejecuta:

   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)

  Esto configurará y construirá mozilla y puede tardar desde 30 minutoshasta varias horas en completarse (dependiendo de tus especificaciones). Para la mayoría de las máquinas modernas debería ser alrededor de una hora.

** Construir con GCC 5.0 y superior **

Si está utilizando GCC 5.0, la construcción puede fallar. Si lo hace, hay cambios que deben hacerse en dos archivos. Sin embargo, si está ejecutando una construcción limpia por primera vez, necesita permitir que esta parte de la construcción falle primero. Esto se debe a que los archivos están en la parte de Mozilla de la construcción que tiene que ser descargado primero.

Estos archivos deben ser cambiados:

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

Vea el error #1153109 en la base de datos de errores de Mozilla para más información.

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

Vea Porting to GCC 5 para más información.

• Después de que mozilla se construya con éxito, vuelva al directorio principal del repo y construya 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

  Esto debería llevar mucho menos tiempo que construir Mozilla.

• Una vez que la construcción se ha completado simplemente puede ejecutar Komodo ejecutando bk run

Al hacer cualquier modificación en la fuente tendrá que ejecutar de nuevo bk build, o simplemente bk build && bk run para volver rápidamente a Komodo. Las construcciones posteriores deberían ser mucho más rápidas ya que gran parte de los datos compilados se almacenan en caché.

Construcción en Linux

Instrucciones para Linux

Construcción con Docker

La forma más fácil de empezar es utilizar nuestra imagen Docker, esto básicamente le proporcionará una construcción de Komodo basada en Ubuntu 12.04.

Después de clonar el repositorio simplemente navegue en {repo}/util/docker y compruebe ./docklet --help

Para utilizar la imagen Docker necesita, por supuesto, tener Docker instalado, así como tener habilitado el reenvío X11 en su cliente SSH (debería funcionar por defecto en la mayoría de las distros de Linux).

Prepare la imagen Docker

• Construya la imagen Docker: ./util/docker/docklet image
• Inicie su contenedor: ./util/docker/docklet start
• SSH en su contenedor para empezar a trabajar: ./util/docker/docklet ssh

Tus archivos de proyecto se montarán en /komodo/dev

NOTA – si estás actualizando desde una versión anterior donde tus archivos de proyecto estaban en /root/komodo tendrás que arreglar los permisos de tus carpetas de proyecto y perfil de Komodo. Es decir:

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

También tendrá que rehacer su construcción (distclean mozilla y komodo).

Pasos de construcción

Una vez que su imagen está preparada puede seguir los pasos de construcción para linux como se describe anteriormente. Usted va a ejecutar estos desde el contenedor docker, por lo que ssh intoit utilizando el comando anterior y luego ejecutar los comandos de /komodo/dev

Running

Una vez que su construcción se ha completado usted salir del contenedor (exit) y puede entonces ejecutar Komodo con

./util/docker/docklet run

Para reconstruir Komodo (después de hacer los cambios) y ejecutarlo de nuevo puede utilizar

./util/docker/docklet build run

Si sus cambios no se reflejan puede necesitar limpiar su construcción, Para ello, utilice

./util/docker/docklet clean

O para hacerlo todo de una vez (limpiar, construir y ejecutar)

./util/docker/docklet clean build run

Complicaciones de construcción

Si se produce algún error durante su primera construcción y no es obvio cómo solucionar el problema por su cuenta, por favor, consulte la sección de comentarios sobre cómo ponerse en contacto con nosotros.

Tenga en cuenta que si surgen complicaciones en la construcción después de actualizar su repo con los últimos cambios es posible que tenga que borrar su caché local, ya que podría estar en conflicto con los nuevos cambios, para hacer esto ejecute bk distclean antes de ejecutar sus pasos de construcción.

Pro-Tips

Construya una sola pieza

A veces bk build es demasiado y bk build quick no es suficiente. Si bk build quick no parece recoger sus cambios, intente apuntar con bk build a la pieza en cuestión.

Ejemplo

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

NOTA: No confíe en este método ya que bk build quick es más rápido y en algunos casos hace algunos pasos que el ejemplo anterior no realiza. Utilícelo como un último esfuerzo antes de intentar bk distclean && bk build.