# 2.5. The Installation Program

O KDevelop inclui um módulo de instalação automatica que é invocado sempre que o Kdevelop é iniciado e o ficheiro de configuração kdeveloprc não existe. Sugerimos que siga os passos de instalação escolhendo "Prosseguir" para automaticamente verificar o seu sistema e configurar o ambiente do KDevelop.

Os botões de diálogo da instalação executam as seguintes acções:

Ajuda: Abrirá o programa KDEHelp.

Prosseguir: Isto inicia o processo de instalação e executa as seguintes acções:

1. Verificar a existência do make/gmake, autoconf, autoheader, automake e perl para a criação e compilação de novas aplicações geradas pelo KDevelop. Se o gmake estiver instalado, o comando make será definido automaticamente para utilizar o gmake. Outras opções de linha de comando para o seu programa make podem ser definidas no diálogo de configuração acessível pelo menu de opções, mais tarde. Uma introdução ao desenvolvimento em Unix é explicado na secção Programas.

2. Verificar a existência do KDoc e Glimpse. Estas permitirão criar automaticamente uma nova documentação de bibliotecas KDE e um indice de busca num passo seguinte da configuração, se encontradas.

3. Verificar a existência do a2ps e enscript para assegurar que é possível imprimir. Um destes dois programas tem de estar instalado para permitir imprimir correctamente. Se nenhum deles estiver instalado, pode faze-lo a qualquer momento mais tarde sem ter de correr a configuração de novo.

4. Verificar a existência do KDbg, KIconedit e KTranslator. Encorajamo-lo a instalar esses programas pois são bons ajudantes para criar aplicações KDE completas. Note que o KDbg é utilizado directamente para depurar o seu projecto actual dentro do KDevelop; o KIconedit é utilizado para apresentar e editar pixmaps seleccionados nas árvores de vista de ficheiros. Os programas KDbg, KIconedit e KTranslator serão então configurados para estarem disponíveis no menu "Ferramentas" da barra de menu do KDevelop se encontrados. Outras ferramentas podem ser adicionadas ao menu Ferramentas seleccionado "Ferramentas..." no menu de Opções mais tarde.

5. Resumo de programas detectados: a instalação lista os programas que encontrou e os que não encontrou. Dicas adicionais são dadas, see um um programa necessário for recomendado.

6. Detecção do caminho para a sua documentação electrónica Qt: verifica vários caminhos standard no seu sistema procurando a documentação e define o caminho automaticamente. Se a sua documentação Qt não tiver sido encontrada quer porque não está instalado ou o seu sistema a tem numa localização diferente, uma mensagem aparecerá pedindo-lhe para definir o caminho manualmente ou continuar. Escolhendo o botão para definir o caminho leva-lo-á de volta à janela principal de instalação e mostrará um campo de edição com um botão à direita para escolher o caminho. Normalmente isto é no directório qt/html. Após faze-lo, a instalação pode continuar com a selecção de "Prosseguir" novamente.

7. Se o KDoc foi detectado, ser-lhe-á pedido para criar/actualizar a documentação da sua biblioteca KDE . Para isso, precisa de ter as bibliotecas KDE em código fonte. Para utilizadore Linux que tiverem instalado o KDE de uma distribuição, sugerimos que copiem e extraiam o código fonte do pacote kdelibs para o seu sistema; utilizadores do Free BSD que tenham instalado as kdelibs como pacote deverão procurar o correspondente pacote de distribuição na colecção de portes. Se nenhum destes casos for o seu, deverá ir buscar o código fonte a http://www.kde.org e descomprimir as fontes no seu sistema. Se deseja utilizar o pacote de documentação disponibilizado por http://developer.kde.org, cancele a criação e continue criando o índice de busca. Depois do programa de instalação terminar e o KDevelop ter iniciado, defina o caminho para o pacote de documentação descomprimido no diálogo de Configuração do KDevelop e corra a configuração do índice de novo, que pode ser encontrado na mesma página do diálogo de configuração. O diálogo "Actualizar a documentação das bibliotecas KDE " é definido para utilizar um caminho por defeito para a localização da documentação em $(HOME)/.kde/share/apps/kdevelop/KDE-Documentation. A única coisa que tem a fazer é escolher o caminho para o código fonte das bibliotecas que descompactou no seu sistema com o botão de selecção no topo do diálogo e escolher OK. Como exemplo, se tiver o pacote kdelibs.tar.gz de http://www.kde.org e o tiver puxado para o seu directório principal, terá de abrir uma consola ou terminal e escrever "tar zxvf kdelibs.tar.gz". Isto irá descomprimir o código fonte para o directório $HOME/kdelibs, que então conterá o código fonte para cada biblioteca num subdirectório, por ex. para a kdecore, seria em /home/rnolden/kdelibs/kdecore. Agora, o caminho que tem de inserir no diálogo de documentação das bibliotecas KDEdeverá ser o caminho para todas as bibliotecas, no exemplo /home/rnolden/kdelibs. Se o caminho tiver sido definido correctamente, ser-lhe-á perguntado se a documentação deve ser criada utilizando a biblioteca khtml ou a khtmlw. Ambas disponibilizam um widget HTML que é utilizado para criar janelas que podem mostrar ficheiros HTML e é utilizado pelo KDEHelp e KFM. Como as classes são as mesmas em ambas as bibliotecas, decidimos apenas incluir uma biblioteca para documentação para evitar confusão devido ao facto de os ficheiros header que contêm as classes diferirem nos seus nomes. Após premir o botão OK, uma mensagem na janela de instalação mostra que ela está em progresso e que deve aguardar pela próxima mensagem.

   NOTA: Num sistema multi-utilizador ou sistemas com quotas de espaço em disco para contas de utilizadores, a instalação de uma documentação completa em HTML para cada utilizador seria um desperdício de espaço em disco. Neste caso, peça ao seu administrador de sistema para correr o KDevelop com a conta root para permitir acesso de escrita à raiz do sistema. Depois instalar a documentação dentro do directório KDE , debaixo de $KDEDIR/share/apps/kdevelop/KDE-Documentation. O caminho correcto pode depois ser definido mais tarde no diálogo de configuração do KDevelop, disponível no menu "Opções".

8. Se a verificação do sistema encontrou o programa Glimpse, é-lhe oferecida a possibilidade de criar uma base de dados de busca. A base de dados de busca pode ser criada com as opções de incluir a documentação KDE e a documentação Qt (defeito). Adicionalmente a documentação do KDevelop é incluida e será indexada. Se possuir outra documentação que deseje indexada pode seleccionar os directórios e adiciona-los também ao processo de indexação.

9. Durante a criação do index de busca, a janela de instalação apresentará uma mensagem indicando que está em progresso.

10. Se todos os passos de instalação tiverem sido realizados correctamente, uma mensagem final dirá que o KDevelop será iniciado após se premir OK. Lembre-se que pode definir opções adicionais tais como gravação automática no diálogo de Configuração do KDevelop que é acessível a partir do menu de opções.

Cancelar: Mostrará uma mensagem de aviso de que o processo de instalação será cancelado. Esta mensagem de aviso permite-lhe regressar à instalação ("Regressar") ou iniciar o KDevelop com os valores por defeito ("Continuar"). Lembre-se que neste caso terá de definir todas as opções sozinho com os diálogos de configuração disponibilizados no menu de opções.