Komodo / KomodoEdit
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
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:
- /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.
- /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
.