&Jack.H.Ostroff; &Jack.H.Ostroff.mail;
2010-07-25
4.5

# Instalação

Este apêndice descreve principalmente a instalação do &kappname; no sistema operacional &Linux;. A seção final fala sobre os outros sistemas operacionais.

## Como obter o &kappname;

Ainda que o &kappname; já existe há muito tempo, ainda estamos trabalhando para uma integração completa no &kde;. As versões estáveis anteriores (1.0.x) necessitavam de bibliotecas do &kde; 3 e, por isso, não estavam disponíveis nas distribuições mais recentes do Linux, que já migraram para o &kde; 4. Contudo, com o lançamento da versão 4.5, o &kappname; poderá agora ser compilado facilmente e instalado em qualquer versão do &kde; 4.3 ou superior.

O resto desta seção irá descrever a instalação do &kappname; com o processo normal de instalação de aplicações na sua distribuição de Linux. A seção seguinte irá discutir a compilação a partir do código-fonte.

### Pacotes oficiais da distribuição

A melhor forma de instalar o &kappname; é usar o gerenciador de pacotes da sua distribuição, como o 'apt-get', o 'yum', o 'portage' ou o 'pacman'. Ele irá tratar de todas as dependências e bibliotecas necessárias. Ainda que possa levar algum tempo, após o lançamento desta versão, para que todas as distribuições adicionem o &kappname; aos seus repositórios oficiais, cheque aí inicialmente.

### Repositórios não suportados

Muitas distribuições de Linux possuem usuário que fornecem repositórios não-suportados mas que possuem pacotes mais atualizados que os repositórios oficiais. Você poderá encontrar uma lista destes na página Web do &kappname;.

## Compilando o &kappname; a partir do código-fonte

Você poderá encontrar informações mais atualizadas sobre a última versão disponível e sobre outros problemas de instalação na página Web do &kappname;. Essa página terá também referências para pacotes TAR de versões mais recentes, assim como instruções para obter o código a partir do SVN do KDE, no caso de querer compilar a última versão em desenvolvimento.

Como observado no parágrafo anterior, existem duas razões distintas para compilar o &kappname; a partir do código. Se não conseguir encontrar uma versão com um pacote especificamente criado para a sua distribuição, baixe por favor o pacote TAR da versão estável mais recente. Esta é a versão 4.5.0, no momento em que o documento foi escrito. Esta é a opção de compilação recomendada para os usuários normais.

Por outro lado, se você quiser ver o estado atual do desenvolvimento, para ver uma correção de erro ou funcionalidade recente, poderá obter um pacote TAR com uma imagem do repositório de desenvolvimento. Também poderá obter o código diretamente a partir do repositório. (O código da versão 4.x está no SVN do &kde; e o código das versões 1.0.x está no CVS do SourceForge. As instruções de acesso estão na página Web do projeto.)

O código nos repositórios e imagens de desenvolvimento está em constante mudança: poderá conter erros, poderá estourar ou você poderá corromper ou perder dados. Se usá-lo, certifique-se de fazer cópias de segurança adequadas. A menos que tenha uma boa razão para usar esta versão, opte por uma versão estável.

O &kappname; depende das bibliotecas do KDE na versão 4.3 ou posterior, nomeadamente o 'kdelibs' e o 'kdepimlibs'. Você poderá ter que carregar de forma explícita as versões -devel para poder compilar o &kappname;, em vez de executar apenas uma versão pré-compilada. Você poderá obter funcionalidades adicionais se tiver disponíveis algumas bibliotecas extras no momento de compilação – veja a página Web para mais detalhes.

O &kappname; usa o sistema de compilação 'cmake'. Você poderá encontrar mais informações no arquivo 'README.cmake' na pasta de topo do código. Os passos básicos são os seguintes:

- `$ mkdir build`
- `$ cd build`
- `$ cmake .. -DCMAKE_INSTALL_PREFIX=/usr/`
- `$ make`
- `$ sudo make install/fast`

Repare que o último passo é obrigatório. O &kappname; espera encontrar determinados componentes nas localizações-padrão e, caso execute o programa a partir da pasta de compilação, você terá ícones faltando ou outras surpresas.

Se você tiver compilado o código a partir do SVN, e quiser estar com a última versão atualizada, na maior parte dos casos poderá fazer o seguinte:

- `$ cd <pasta de topo do código>`
- `$ svn update`
- `$ cd build`
- `$ make`
- `$ sudo make install/fast`

Contudo, as alterações feitas pelos programadores poderão provocar alguns problemas de compilação, caso não comece com uma base de código limpa. Nesses casos, você precisará fazer o seguinte:

- `$ cd <pasta de topo do código>`
- `$ svn update`
- `$ rm -r build`
- `$ mkdir build`
- `$ cd build`
- `$ cmake .. -DCMAKE_INSTALL_PREFIX=/usr/`
- `$ make`
- `$ sudo make install/fast`

## Instalando o &kappname; sem Linux

O &kappname; foi compilado com sucesso no &MacOS; X e está disponível na página Web MacPorts.

O &kappname; também foi apresentado como disponível para o &Windows;, mas ainda não estão disponíveis os detalhes para o incluir aqui. Verifique por favor a página Web do &kappname; para obter informações mais atualizadas.

Se você souber que o &kappname; está sendo compilado com sucesso e disponibilizado em outro sistema operacional, comunique-nos, para que possamos difundir isso.