Komodo / KomodoEdit

Jun 19, 2021
admin

Este readme explica como começar a construir, usar e desenvolver com a base de fontes do Komodo Edit.

Aonde a fonte principal do Komodo Edit estiver hospedada sob este repositório, você também pode querer verificar os repositórios individuais de componentes/addon sobhttps://github.com/Komodo no caso de você só querer contribuir com um componente específico. Isto irá poupar-te algum tempo e aborrecimentos, pois não terás de construir o projecto inteiro.

Índice

  • Screenshot
  • Download
  • Feedback
  • Construindo Komodo
    • Construindo em Windows
    • Construindo em Mac
    • Construindo em Linux
    • Construção com Docker
    • Complicações da construção

Screenshot

 Screenshot

Download

Você pode fazer o download do Komodo Edit aqui.

Feedback

Existem várias formas de entrar em contacto com os Komodo devs:

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

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

Bug Tracker: https://github.com/Komodo/KomodoEdit/emissões

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

>

Listas de discussão por e-mail: komodo-discuss & komodo-beta & komodo-announce

Construir Komodo

Note que estes são passos simplificados do processo de construção, para uma verificação mais aprofundada (desatualizada) BUILD.txt.

Construir em Windows

  • Prrequisitos
  • Passos da construção

Prrequisitos

  • Python >=2.7 (mas ainda não Python 3.x). Você pode instalar o ActivePython daqui.

  • Visual C+++ 11.0 (aka Visual Studio 2012) e todos os SDKs de plataforma para construir o Mozilla com a vc11 como descrito aqui.

  • Instalar a versão 1.9.0 do pacote “MozillaBuild-$ver.exe” no dir(i.e. “C:\mozilla-build”) padrão.

    • Após instalado remova os directórios wget e hg
    • Download versão 2.2.0 e instale-a num directório temp, depois copie o directório wget da 2.2 para a 1.9 instalar diretório
  • Instalar o Perl <= 5.22

  • Instalar Mercurial

Veja http://developer.mozilla.org/en/docs/Windows_Build_Prerequisites detalhes de construção de formulários no Windows. No entanto, seguir os pré-requisitos acima é suficiente para obter a construção do Komodo.

Passos de construção

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

  • Utilizando a linha de comando, entre no seu directório de checkout e execute:

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

    Isto irá configurar e construir o mozilla e pode levar de 30 minutos a várias horas para completar (dependendo das suas especificações). Para a maioria das máquinas modernas deve levar cerca de uma hora.

  • Após o mozilla ser construído com sucesso volte ao diretório principal do repo e construa o komodo:

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

    Isto deve levar significativamente menos tempo do que construir o Mozilla.

  • Após a compilação ter terminado você pode simplesmente executar o Komodo executando bk run

Upão fazendo quaisquer modificações no código fonte você terá que executar novamente bk build,ou simplesmente bk build && bk run para voltar rapidamente ao Komodo. A compilação subseqüente deve ser muito mais rápida, pois grande parte dos dados compilados está em cache.

Construir em Mac

  • Mac Pré-requisitos
  • Etapas de construção

Mac Pré-requisitos

  • Python >==2.7 (mas não Python 3.x ainda). Você pode instalar o ActivePython a partir daqui.

    Se preferir as construções Python a partir de python.org também deve ser suficiente.

  • Xcode 6.4(SDK 10.9 & 10.10). Para 8.0 veja abaixo. Você pode obter a versão 6.4 no site de downloads do desenvolvedor.

  • MacOSX10.10.sdk ou mais antigo

  • IDE ONLY SDK 10.8 for Code Intel. Pode ser encontrado em Xcode 5.1.1

  • Se tiver/necessária a instalação de outras versões do Xcode então pode usar xcode-select para alterar o Xcode activo:

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

  • Xcode Ferramentas de Linha de Comando.

    Abra as preferências do Xcode, depois no separador Downloads, seleccione e instale as Ferramentas de Linha de Comando.

  • >

    MacPorts. (Nota: O Fink pode funcionar também, mas a maioria dos testes de compilação e instruções é feita com o MacPorts)

  • autoconf v2.13. Uma vez que você tenha o MacPorts instalado, basta rodar sudo port install autoconf213

  • seguir que você está usando clang ou gcc 4.2 (ou superior)

Ver http://developer.mozilla.org/en/docs/Mac_OS_X_Build_Prerequisitesformais detalhes sobre os pré-requisitos de construção do Mac OS X. No entanto, seguindo os passos acima pretende-se ser suficiente para obter Komodo building.

Xcode 8 Pré-requisitos

Oficialmente não suportamos o Xcode 8, no entanto é possível construir Komodounder Xcode 8 usando um novo passo extra.

  • Copiar sobre os SDK’s 10.8 e 10.9 de uma instalação XCode antiga, eles devem estar em:Xcode.app/Contents/Developer/Platforms/macOSX.platform/
  • Definir a versão mínimaSDK para 10.9 em Xcode.app/Contents/Developer/Platforms/macOSX.platform/Info.plist
  • Segure que você está usando ccache 3.1 (versões posteriores irão quebrar)
  • Configurar Mozilla com --options=disable-webrtc

Etapas de Construção

  • Configuração do Komodo Edit: git clone https://github.com/Komodo/KomodoEdit.git

    >

  • Usando o terminal, entre no seu directório de checkout e execute:

     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)

    Isto irá configurar e construir o mozilla e pode levar de 30 minutos a várias horas para ser concluído (dependendo das suas especificações). Para a maioria das máquinas modernas deve ser cerca de uma hora.

** Construção com GCC 5.0 e superior **

Se você estiver usando GCC 5.0, a construção pode falhar. Se isso acontecer, há alterações que precisam ser feitas em dois arquivos. Entretanto, se você estiver rodando uma compilação limpa pela primeira vez, você precisa permitir que essa parte da compilação falhe primeiro. Isto é porque os ficheiros estão na parte Mozilla da compilação que tem de ser descarregada primeiro.

Estes ficheiros precisam de ser alterados:
  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

Ver bug #1153109 na base de dados de bugs do Mozilla para mais informações.

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

Ver Porting to GCC 5 para mais informações.

  • Após o mozilla ser construído com sucesso, volte ao diretório principal do repo e construa o 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

    Isto deve levar significativamente menos tempo do que construir o Mozilla.

  • Após a compilação ter terminado você pode simplesmente executar o Komodo executando bk run

Aponto fazendo quaisquer modificações no código fonte você terá que executar novamente bk build,ou simplesmente bk build && bk run para voltar rapidamente ao Komodo. A compilação subseqüente deve ser muito mais rápida, pois muitos dos dados compilados estão em cache.

Compilação no Linux

Instruções do Linux

Compilação com Docker

A maneira mais fácil de começar é usar a nossa imagem Docker, isto basicamente lhe fornecerá uma compilação baseada no Ubuntu 12.04 do Komodo.

Após clonar o repositório simplesmente navegue em {repo}/util/docker e faça o checkout ./docklet --help

Para usar a imagem Docker você precisa, é claro, ter o Docker instalado assim como ter o encaminhamento X11 habilitado no seu cliente SSH (deve funcionar por padrão em distros mostlinux).

Prepare a imagem Docker

  • Build the docker image: ./util/docker/docklet image
  • Inicie o seu contentor: ./util/docker/docklet start
  • SH para dentro do seu contentor para começar a trabalhar: ./util/docker/docklet ssh

Os seus ficheiros de projecto serão montados em /komodo/dev

NOTE – se estiver a actualizar a partir de uma versão anterior onde os seus ficheiros de projecto estavam em /root/komodo necessitará de corrigir as permissões nas pastas do seu projecto Komodo e perfil. Ie:

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

Você também precisará refazer sua construção (distclean mozilla and komodo).

Building Steps

Após a sua imagem estar preparada você pode seguir os passos de construção para linux asdescribed acima. Você estará executando estes a partir do container da doca, Então, ssh intoit usando o comando acima e então execute os comandos de /komodo/dev

Executando

Após a sua construção estar completa você sai do container (exit) e pode então executar Komodo com

./util/docker/docklet run

Para reconstruir o Komodo (depois de fazer alterações) e executá-lo novamente pode usar

./util/docker/docklet build run

Se as suas alterações não estão a ser reflectidas pode precisar de limpar a sua construção, para usar

./util/docker/docklet clean

Or para fazer tudo de uma só vez (limpar, construir e correr)

./util/docker/docklet clean build run

Complicações de Construção

Se ocorrer algum erro durante a sua primeira construção e não for óbvio como resolver o problema por si próprio, por favor consulte a secção Feedback sobre como entrar em contacto connosco.

Note que se surgirem complicações de construção depois de ter actualizado o seu repo com as últimas alterações, poderá ter de limpar o seu cache local, pois pode estar em conflito com as alterações do thenew, para fazer esta execução bk distclean antes de executar os seus passos de construção.

Pro-Tips

Build uma única peça

Por vezes bk build é demasiado e bk build quick não é suficiente. Se bk build quick não aparecer para pegar suas mudanças, tente apontar bk build para a peça em questão.

Exemplo

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

NOTE: Não confie neste método pois bk build quick é mais rápido e em alguns casos faz alguns passos que o exemplo acima não executará. Use-o como último esforço de vala antes de tentar bk distclean && bk build.

Deixe uma resposta

O seu endereço de email não será publicado.