# Instruções de instalação

Estas são instruções genéricas para o Ambiente de Trabalho K. Complemente a sua leitura com os `README`s e os `INSTALL`s que vêm com o pacote. Leia-os cuidadosamente e tente procurar ajuda se algo correr mal. Se necessitar de mais assistência, pense em juntar-se às listas do correio (veja as instruções do nosso 'site' Web para se juntar às listas de correio) ou grupos de notícias do &kde;.

Para possíveis convertidos

Então ouviu os rumores. Ou viu as imagens exemplo, e está ansioso por possuir o &kde;, mas não sabe nada sobre esta história de SO alternativo. Não se preocupe! Só precisa de fazer algumas (bem, talvez nem tantas) leituras e é tudo!

O &kde; não executa sob o Windows 9x/Me/NT/2000/XP ou OS/2 (ainda). Para executar o &kde;, você precisa ter um sistema &UNIX;. Baseie-se na para mais detalhes.

Decida a plataforma e configure-a para o seu sistema. Esta FAQ não pode lhe ajudar com iso, dado que o &kde; é executado em muitas plataformas &UNIX;.

Finalmente, está pronto para iniciar a instalação do &kde;. Comece a ler a partir da próxima seção. Para obter o &kde;, veja . Por último, se encontrar alguns problemas ao instalar o &kde;, não hesite em usar as listas do correio e grupos de discussão do &kde;. Mas tenha isto em mente: não existem perguntas descabidas, existem é respostas descabidas, principalmente se já foram respondidas na FAQ.

Boa sorte e divirta-se!

Formatos de pacotes disponíveis

Você pode encontrar vários tipos de pacotes binários e de código para as diferentes distribuições e sistemas operacionais em &kde-ftp;. Os pacotes binários não são feitos pela equipe do &kde;, mas pelos próprios distribuidores ou por indivíduos dedicados. Veja na Política de Pacotes do &kde; Explicada para mais informações sobre a Política de Pacotes do &kde;. A única versão oficial são os pacotes tar.bz2 de código. Veja os `README`s e `INSTALL`s nos vários diretórios de binários. Para uma lista dos pacotes disponíveis para uma dada versão, veja a página de informação relevante. Para a última versão esta é a Página de Informação do &kde; 3.0.1.

Pré-requisitos

Para o &kde; 3.0.1, você necessita da biblioteca &Qt; versão 3.0.2 ou superior. Confirme que obteve o &Qt; correto. Também necessita dos arquivos de inclusão, se quiser compilar você mesmo o &kde;. Estão todos disponíveis sem encargos em http://www.trolltech.com/download. Além disso, existem bibliotecas opcionais que podem melhorar o &kde; se estiverem instalados no seu sistema. Um dos exemplos é o OpenSSL que permitirá ao &konqueror; navegar seguramente nas páginas Web; a versão necessária deve ser >= 0.9.6. Esta deve ser fornecida pelo próprio distribuidor; se não for, peça uma atualização.

Descrição dos pacotes de base.

A distribuição de base consiste neste momento em onze pacotes. Alguns são obrigatórios, enquanto que outros não. Cada pacote está disponível em cada um dos formatos supracitados.

kdelibs

  Necessário

  Este pacote contém as bibliotecas compartilhadas que são necessárias para todos os aplicativos do &kde;.

kdebase

  Necessário

  Este pacote contém os aplicativos de base que formam o núcleo do Ambiente de Trabalho K, como o gerenciador de janelas, o emulador de terminal, o centro de controle, o gerenciador de arquivos e o painel.

&arts;

  O servidor de som &arts;. Um servidor de som poderoso e transparente na rede.

kdeaddons

  Opcional

  Vários plugins para o &kate;, o &kicker;, o &knewsticker;, o &konqueror; e o &noatun;

kdeartwork

  Opcional

  Papéis de parede, temas, estilos, sons, ... adicionais

kdebindings

  Opcional

  Várias interfaces para outras linguagens, incluindo o &Java;, o Perl, o Python, ...

kdegames

  Opcional

  Vários jogos como &kmahjongg;, o &ksnake;, o &kasteroids; e o &kpat;.

kdegraphics

  Opcional

  Vários programas gráficos como os visualizadores de &PostScript; e &DVI; e um programa de desenho.

kdeutils

  Opcional

  Várias ferramentas de trabalho como um calculadora, um editor e outras coisas úteis.

kdemultimedia

  Opcional

  Aplicações multimídia como um leitor de &CD;s e um mixer.

kdenetwork

  Opcional

  Aplicativos de rede. Atualmente contém o cliente de email &kmail;, o leitor de notícias &knode;, entre muitos outros programas de rede.

kdeadmin

  Opcional

  Programas de administração do sistema.

kdeedu

  Aplicativos educativos e de entretenimento para os usuários do &kde; mais novos.

kdetoys

  Opcional

  Brinquedos!

kdevelop

  Opcional

  Um Ambiente de Desenvolvimento Integrado para o &kde; e para o Qt

O arts e o kdelibs devem ser instalados antes de tudo; por último deve-se instalar o kdeaddons. Os restantes pacotes podem ser instalados em qualquer ordem.

A maioria das ferramentas de gerenciamento de pacotes irão deixá-lo colocar estes pacotes num diretório e instalá-los de uma vez, descobrindo eles próprios as suas dependências.

Instruções de instalação para os diferentes formatos de pacotes

Não se esqueça de ler os arquivos `README` e `INSTALL` se estiverem disponíveis.

Instalação dos pacotes da Debian

  Os pacotes da Debian instalam-se de acordo com o FHS (File Hierarchy Standard).

  1. torne-se super-usuário

  2. Execute `dpkg `-i nomepacote.deb`` para todos os pacotes que deseja instalar.

Instalação dos pacotes RPM

  ## Para instalar os RPMs com binários

  1. torne-se super-usuário

  2. execute `rpm `-ivh nomepacote.rpm``

Instalação dos arquivos `.tar.bz2` com código

  Uma vez que existem sempre alterações e atualizações na forma como o &kde; é compilado, veja em Transferir e Instalar o Código para as instruções de instalação dos pacotes com código-fonte mais atualizadas.

  A seguinte aproximação deve, contudo, funcionar na maioria dos casos.

  O pacote `.tar.bz2` de código instala-se em `/usr/local/kde` por padrão. Você pode alterar esta configuração usando a opção `--prefix` do programa `configure`.

  1. descompacte os pacotes com o comando `tar `jxvf nomepacote.tar.bz2``

  2. mude o diretório atual para o do pacote: `cd nomepacote`

  3. configure o pacote: `./configure`

     Alguns pacotes (notavelmente o kdebase) têm opções especiais de configuração que podem ser apropriadas para a sua instalação. Digite `./configure `--help`` para ver as opções disponíveis.

  4. construa o pacote: `make`

  5. instale o pacote: `su `-c "make install"`` (se não for o root). Se já estiver como root, basta digitar `make `install``.

Procedimentos pós-instalação

Primeiramente, certifique-se que já adicionou o diretório de instalação dos binários do &kde; (e.g. `/opt/kde/bin`) ao seu `PATH` e o diretório de instalação das bibliotecas do &kde; ao seu `LD_LIBRARY_PATH` (só é necessário nos sistemas que não suportam o rpath; no &ELF; do &Linux;, deve funcionar sem isto). Esta variável de ambiente pode ser chamada de forma diferente em alguns sistemas, p. ex. é chamada de `SHLIB_PATH` no &IRIX;. Depois defina a variável `KDEDIR` apontando para a base da sua árvore do &kde; p.ex. `/opt/kde`.

Tenha em conta que é pouco inteligente definir a variável `LD_LIBRARY_PATH` sem ter cuidado. Na maioria dos casos é desnecessária e pode causar problemas em vez de ajudar. Existe uma página Web escrita por Dave Barr explicando os problemas da variável `LD_LIBRARY_PATH` e pode ser encontrada em http://www.cis.ohio-state.edu/~barr/ldpath.html.

Ainda que possa usar a maioria dos aplicativos do &kde; bastando para isso chamá-los, só pode beneficiar completamente das funcionalidades avançadas do &kde; se usar o gerenciador de janelas do &kde; e os seus programas auxiliares.

De modo a ser fácil para o usuário, existe um programa simples chamado `startkde` que é instalado no diretório `$`KDEDIR`/bin` e que, por isso, está no seu PATH.

Edite o arquivo `.xinitrc` no seu diretório pessoal (faça uma cópia de segurança primeiro!), remova tudo o que pareça chamadas ao gerenciador de janelas e introduza `startkde` em alternativa. Reinicie o X. Se usar o &kdm;/xdm, terá de editar o arquivo `.xsession` em vez do `.xinitrc` . Se não existir nenhum dos arquivos `.xinitrc` ou `.xsession` no seu diretório pessoal, basta criar um deles, contendo apenas uma linha que diz `startkde`.

Alguns sistemas (notavelmente o &RedHat; &Linux;) utilizam o `.Xclients` como alternativa.

Isto deve-lhe apresentar um novo ambiente de trabalho do &kde;. Pode começar a explorar o mundo maravilhoso do &kde;. No caso de querer ler alguma documentação em primeiro lugar, existe um Guia de Iniciação Rápida altamente recomendado e disponível. Além disso, cada aplicativo tem uma ajuda 'online' que está disponível através do menu de ajuda.

Devo remover a versão antiga xyz antes de instalar uma nova?

Em princípio, isso não é necessário. Os pacotes RPM e da Debian devem resolver todas as dependências.

Se você mesmo for compilar o código-fonte, deve ter cuidado para não compilar versões diferentes dos pacotes do &kde;. Logo se voc~e instalar uma nova versão, por favor primeiro 'make' e 'install' arts, então o kdelibs, e então o kdebase.

Uma coisa que deve evitar: instalar duas ou mais versões do &kde; em paralelo. Isto pode acontecer se especificar um diretório de destino diferente para uma versão e para outra. O resultado pode ser imprevisível. O mesmo se aplica se tiver diferentes versões do &Qt; instaladas ao mesmo tempo. Isto acontece com facilidade se já tiver uma versão antiga do &Qt; instalada com uma distribuição do &Linux;.

Como é que inicio o &kde;?

O método mais confortável de iniciar o &kde; é usar o arquivo `startkde`. Basta pôr a linha `startkde` no fim do seu arquivo `.xsession` (ou um dos arquivos `.xinitrc` ou `.Xclients`, se não estiver usando o &kdm; ou o xdm). Remova também as linhas que iniciam o seu gerenciador de janelas anterior. Se não existir um arquivo `.xsession`, `.xinitrc` ou `.Xclients` na seu diretório pessoal, basta criar um novo que contenha apenas uma linha: `startkde`.

É possível instalar o &kde; num diretório de usuário?

Sim, pode instalar o &kde; em qualquer diretório que desejar. O que tem a fazer depende do tipo de pacotes que quer instalar.

## Pacotes de código

1. Configure e instale o pacote usando `configure `--prefix=/users/myhome/kde`; make; make install` para instalar dentro de `/users/myhome/kde`.

2. Adicione o seguinte aos seus arquivos init. Repare que não é necessário definir o valor de `LD_LIBRARY_PATH`, por isso é melhor deixá-lo.

   Para o csh ou o tcsh:

       setenv KDEDIR /users/myhome/kde

       if ( $?LD_LIBRARY_PATH ) then
          setenv LD_LIBRARY_PATH $KDEDIR/lib:$LD_LIBRARY_PATH
       else
          setenv LD_LIBRARY_PATH $KDEDIR/lib
       endif

       if ( ! $?LIBRARY_PATH ) then
          setenv LIBRARY_PATH $LD_LIBRARY_PATH
       endif

   No bash:

       KDEDIR=/users/myhome/kde
       PATH=$KDEDIR/bin:$PATH
       LD_LIBRARY_PATH=$KDEDIR/lib:$LD_LIBRARY_PATH
       LIBRARY_PATH=$LD_LIBRARY_PATH
       export KDEDIR PATH LD_LIBRARY_PATH LIBRARY_PATH

## pacotes RPM

1. O `rpm` permite usar a opção `--prefix` para selecionar o diretório em que deseja instalar. Por exemplo, a execução de `rpm `-i --prefix=/users/myhome/kde pacote.rpm`` irá instalar o pacote em `/users/myhome/kde`.

Embora o &kde; vá executar a partir de um diretório de usuário, existem alguns problemas com os programas que necessitem de suid root, p.ex. os programas do pacote kdeadmin. Mas como na inicialização não são para ser executados pelos usuários, não há motivo de preocupação.

Contudo, nos sistemas com senhas ocultas, os protetores de tela têm de estar 'suid root' para permitir o acesso às senhas para desbloquear a tela, por isso esta opção não irá funcionar.

O `startkde` falha com can not connect to X server. O que está errado?

Provavelmente tentou iniciar o servidor X com o `startkde`. O servidor X é iniciado com o `startx`. O `startkde` é o programa que deve ser executado a partir do seu `.xinitrc`, `.xsession` ou `.Xclients` para ativar o gerenciador de janelas e os programas de servidor necessários para o &kde;. Veja também .

&kde; no &AIX;?

Se tiver problemas a compilar o &kde; no &AIX;, verifique a página de Stefan Westerfeld Executar o &kde; no AIX para obter diversas ajudas a compilar o &kde; nesta variante excepcional do &UNIX;.

&kde; num portátil?

Se você consegue executar o &X-Window;, não deverá ter nenhum problema para executar o &kde;. Além disso, poderá achar as seguintes referências úteis:

- http://www.linux-laptop.net/

- http://www.sanpei.org/Laptop-X/note-list.html

Eu tenho um novo chipset neomagic em meu laptop. Existe alguma coisa em especial que eu tenha que fazer para executar o &kde;?

Em alguns laptops que usam o chipset 2160 (MagicGraph 128XD) as seguintes opções no `XF86Config` são necessárias para permitir o funcionamento do motor gráfico:

               Option "XaaNoScanlineImageWriteRect"
               Option "XaaNoScanlineCPUToScreenColorExpandFill"

Se você observou desligamentos do seu desktop durante a utilização do &kde;, por favor tente esta opção.

Não gosto do diretório padrão do &kde; depois da instalação. Como posso movê-lo sem danificar nada?

Assumindo que o diretório padrão é o `/opt/kde` e quer movê-lo para o `/usr/local/kde`, aqui está o que deve ser feito:

1. mudar para super-usuário se não estiver já como tal

2. `mv /opt/kde /usr/local/kde`

3. `ln -s /usr/local/kde /opt/kde`

Isto irá pôr todos os arquivos do &kde; no diretório `/usr/local/kde`, embora continue tudo a estar acessível em `/opt/kde`.

Quais os arquivos que posso apagar do meu diretório de instalação do &kde;? Os arquivos `*.h`, `*.c` e `*.o` podem ser removidos em segurança?

Não deve existir a necessidade de manter os arquivos `.c` e `.o`, mas o usuário poderá querer manter os arquivos `.h` , uma vez que são incluídos se quiser compilar os seus próprios programas do &kde;. Mas se quiser aplicar correções aos programas de origem à medida que estes vão se tornando disponíveis (em vez de obter tudo de novo), então estes devem ficar.

Irei perder a minha configuração atual quando atualizar o &kde;?

Não. O &kde; irá, na maioria dos casos, ser capaz de transportar a sua configuração intacta. Poderá ter de reintroduzir senhas em algumas aplicações (como o &kmail; ou o &knode;) mas a maior parte das outras configurações serão seguras.

Ocorreram relatórios misturados de resultados entre algumas versões anteriores do &kde;. Para ter a certeza, poderá querer salvaguardar a sua configuração inteira do &kde;.

A configuração é mantida na sub-diretório `.kde` ou `.kde2` da sua área local. Copie seu diretório antigo `.kde`/`.kde2` para uma localização de segurança, instale o &kde; 3.0.1 e copie de volta todas as configurações de email e notícias necessárias. Feito isto, a maioria das pessoas conseguirão fazer uma atualização direta sem remover o diretório `.kde` antigo, sem impacto de espécie alguma.

Eu atualizei o &kde; e tudo pareceu bem, mas quando eu inicializo, aparece uma tela cinza em branco, e nada acontece. Existem erros no console sobre o servidor DCOP. O que está acontecendo?

O &kde; utiliza muito arquivos temporários durante sua operação. Eles são comumente encontrados nas seguintes localizações:

- `~/.DCOPserver-*` (existem comumente dois destes, um como link simbólico do outro)

- `~/.kde/socket-hostname`

- `~/.kde/tmp-hostname` o qual é normalmente um link simbólico para o próximo arquivo:

- `/tmp/tmp-kde-USER`

- `~/.kde/socket-hostname` que é normalmente um link simbólico para:

- `/tmp/ksocket-USER`

Se os links simbólicos forem quebrados, comumente por causo de um script `cron` ou shutdown que esteja limpando o diretório `/tmp`, então estranhas coisas podem acontecer.Estes arquivos, e seus links simbólicos, são criados automaticamente na inicialização do &kde; então você pode removê-lo com segurançaenquanto o &kde; não está sendo executado.

Se você está conseguindo apenas uma tela cinza quando inicia o &kde;, ou se você recebe uma mensagem lhe dizendo Verifique sua instalação, então saia do X e apague todos os arquivos listados acima, e então tente reiniciar o X.

Normalmente (&ie; quando não se está atualizando entre versões do &kde;) é seguro deixar estes arquivos intactos, e você deve sair por alguns segundos do seu &kde; e reiniciá-lo.

A compilação do kdebase retorna um erro bin/sh: msgfmt: command not found!

Necessita do pacote da GNU msgfmt, o qual faz parte do pacote de i18n da GNU gettext. Deve poder transferí-lo a partir de qualquer 'mirror' da GNU.

Como é que desinstalo os aplicativos do &kde; compilados do zero?

Você pode desinstalar os seus programas escrevendo `make uninstall` no diretório onde fez `make install`. Se já tiver excluído esse diretório, então só existe uma forma, e ela não é boa: vá ao diretório `$`KDEDIR` /bin` e comece a apagar os arquivos um a um.

O que houve com o suporte de &GIF;s?

Isto tem algo a ver com a patente do &LZW; da Unisys. O suporte de &GIF; vem desligado por padrão desde o &Qt; 1.44 em diante. Quando quiser usar &GIF;s e tiver a licença relevante, recompile o &Qt; com o suporte de &GIF;: `./configure `-gif``.

Como é que instalo os temas do &kde;?

Existe um Gerenciador de Temas no &kde; a partir do 2.2.1, por isso baseie-se na ajuda do Centro de Controle para mais referência, ou então veja temas do KDE3 em kde.themes.org.