KomodoEdit
12.0.1
Este leia-me explica como começar a construir, usar e desenvolver com a base de origem Komodo Edit.
Embora a fonte principal do Komodo Edit esteja hospedada neste repositório, você também pode verificar os repositórios de componentes/complementos individuais em https://github.com/Komodo, caso queira contribuir apenas para um componente específico. Isso economizará tempo e complicações, pois você não precisará construir o projeto inteiro.
Você pode baixar o Komodo Edit aqui.
Existem várias maneiras de entrar em contato com os desenvolvedores do Komodo:
Github: https://github.com/Komodo/Komodo
Fóruns: http://forum.komodoide.com/
Rastreador de bugs: https://github.com/Komodo/KomodoEdit/issues
IRC: irc://irc.mozilla.org/#komodo
Listas de discussão: komodo-discuss & komodo-beta & komodo-announce
Observe que essas são etapas simplificadas do processo de construção, para uma verificação mais aprofundada do guia (desatualizado) BUILD.txt.
Python >=2.7 (mas ainda não Python 3.x). Você pode instalar o ActivePython aqui.
Visual C++ 11.0 (também conhecido como Visual Studio 2012) e todos os SDKs da plataforma para construir o Mozilla com vc11 conforme descrito aqui.
Instale a versão 1.9.0 do pacote "MozillaBuild-$ver.exe" no diretório padrão (ou seja, "C:mozilla-build").
Instale o Perl <= 5.22
Instale o Mercurial
Consulte http://developer.mozilla.org/en/docs/Windows_Build_Prerequisites para obter mais detalhes sobre os pré-requisitos de compilação do Windows. No entanto, seguir as etapas acima é suficiente para construir o Komodo.
Confira a edição do Komodo: git clone https://github.com/Komodo/KomodoEdit.git
Usando a linha de comando, entre no diretório de checkout e execute:
cd mozilla
setenv-moz-msvc11.bat
python build.py configure -k 11.10
python build.py distclean all
Isso irá configurar e construir o Mozilla e pode levar de 30 minutos a várias horas para ser concluído (dependendo de suas especificações). Para a maioria das máquinas modernas, deve demorar cerca de uma hora.
Depois que o Mozilla for compilado com sucesso, volte para o diretório principal do repositório e construa o Komodo:
cd ..
set PATH=utilblack;%PATH%
bk configure -V 11.10.0-devel # --without-binary-dbgp-clients
bk build
Isso deve levar muito menos tempo do que construir o Mozilla.
Assim que a compilação for concluída, você pode simplesmente executar o Komodo executando bk run
Ao fazer qualquer modificação na fonte, você terá que executar novamente bk build , ou simplesmente bk build && bk run para voltar rapidamente ao Komodo. As compilações subsequentes devem ser muito mais rápidas, pois muitos dos dados compilados são armazenados em cache.
Python >=2.7 (mas ainda não Python 3.x). Você pode instalar o ActivePython aqui.
Se você preferir, as compilações do Python em python.org também devem ser suficientes.
Xcode 6.4 (SDK 10.9 e 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 anterior
IDE SOMENTE SDK 10.8 para Código Intel. Pode ser encontrado no Xcode 5.1.1
Se você tiver/precisar de outras versões do Xcode instaladas, poderá usar xcode-select para alterar o Xcode ativo:
$ xcode-select -s /Path/To/Xcode 6.4.app/
Ferramentas de linha de comando do Xcode.
Abra as preferências do Xcode e, na guia Downloads, selecione e instale as ferramentas de linha de comando.
MacPorts. (Observação: o Fink também pode funcionar, mas a maior parte dos testes e instruções de construção são feitos com MacPorts.)
autoconf v2.13. Depois de instalar o MacPorts, basta executar sudo port install autoconf213
certifique-se de estar usando clang ou gcc 4.2 (ou superior)
Consulte http://developer.mozilla.org/en/docs/Mac_OS_X_Build_Prerequisites para obter mais detalhes sobre os pré-requisitos de compilação do Mac OS X. No entanto, seguir as etapas acima é suficiente para construir o Komodo.
Oficialmente não oferecemos suporte ao Xcode 8, porém é possível construir o Komodo no Xcode 8 usando novas etapas extras.
--options=disable-webrtc Confira a edição do Komodo: git clone https://github.com/Komodo/KomodoEdit.git
Usando o terminal, entre no seu diretó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)
Isso irá configurar e construir o Mozilla e pode levar de 30 minutos a várias horas para ser concluído (dependendo de suas especificações). Para a maioria das máquinas modernas, deve demorar cerca de uma hora.
Se você estiver usando o GCC 5.0, a compilação poderá falhar. Se isso acontecer, há alterações que precisam ser feitas em dois arquivos. No entanto, se você estiver executando uma compilação limpa pela primeira vez, será necessário permitir que essa parte da compilação falhe primeiro. Isso ocorre porque os arquivos estão na parte Mozilla da compilação que deve ser baixada primeiro.
@@ -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
Veja o bug #1153109 no banco de dados de bugs da Mozilla para mais informações.
@@ -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;
}
Consulte Portando para GCC 5 para obter mais informações.
Depois que o Mozilla for compilado com sucesso, volte para o diretório principal do repositório 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
Isso deve levar muito menos tempo do que construir o Mozilla.
Assim que a compilação for concluída, você pode simplesmente executar o Komodo executando bk run
Ao fazer qualquer modificação na fonte, você terá que executar novamente bk build , ou simplesmente bk build && bk run para voltar rapidamente ao Komodo. As compilações subsequentes devem ser muito mais rápidas, pois muitos dos dados compilados são armazenados em cache.
Instruções Linux
A maneira mais fácil de começar é usar nossa imagem Docker, que basicamente fornecerá uma versão do Komodo baseada no Ubuntu 12.04.
Após clonar o repositório, basta navegar em {repo}/util/docker e verificar ./docklet --help
Para usar a imagem do Docker, é claro que você precisa ter o Docker instalado, bem como o encaminhamento X11 habilitado em seu cliente SSH (deve funcionar por padrão na maioria das distros Linux).
./util/docker/docklet image./util/docker/docklet start./util/docker/docklet ssh Seus arquivos de projeto serão montados em /komodo/dev
NOTA - se você estiver atualizando de uma versão anterior onde seus arquivos de projeto estavam em /root/komodo você precisará corrigir permissões em seu projeto Komodo e pastas de perfil. Ou seja:
chown -R <my-username>:<my-group> <my-project-location>
chown -R <my-username>:<my-group> ~/.komodoide
Você também precisará refazer sua compilação (distclean mozilla e komodo).
Depois que sua imagem estiver preparada, você poderá seguir as etapas de construção para Linux conforme descrito acima. Você os executará a partir do contêiner do docker, então faça ssh nele usando o comando acima e execute os comandos de /komodo/dev
Assim que sua compilação estiver concluída, você sai do contêiner ( exit ) e pode executar o Komodo com
./util/docker/docklet run
Para reconstruir o Komodo (depois de fazer alterações) e executá-lo novamente, você pode usar
./util/docker/docklet build run
Se suas alterações não estiverem sendo refletidas, talvez seja necessário limpar sua compilação. Para fazer isso, use
./util/docker/docklet clean
Ou fazer tudo de uma vez (limpar, construir e executar)
./util/docker/docklet clean build run
Se ocorrer algum erro durante o primeiro tempo de construção e não for óbvio como resolver o problema sozinho, consulte a seção Feedback sobre como entrar em contato conosco.
Observe que se surgirem complicações de construção após você atualizar seu repositório com as alterações mais recentes, talvez seja necessário limpar seu cache local, pois pode estar em conflito com as novas alterações. Para fazer isso, execute bk distclean antes de executar as etapas de construção.
Construa uma única peça
Às vezes, bk build é demais e bk build quick não é suficiente. Se bk build quick não parece captar suas alterações, 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
NOTA : Não confie neste método, pois bk build quick é mais rápido e, em alguns casos, executa algumas etapas que o exemplo acima não executará. Use-o como um último esforço antes de tentar bk distclean && bk build .
