# O Manual do &kpackage;

Toivo
Pedaste

    toivo@ucs.uwa.edu.au

Lauri
Watts

    &Lauri.Watts.mail;

Revisão
José
Pires

    zepires@gmail.com

Tradução
2007
Toivo Pedaste
&FDLNotice;
2008-02-08
4.00.60

O &kpackage; é uma interface &GUI; para os gestores de pacotes RPM, Debian, Slackware e BSD; usava o gestor de pacotes SMART.

kpackage
pacote
gestor de pacotes
RPM
deb

## Introdução

O &kpackage; é uma interface &GUI; para o gestor de pacotes SMART. O &kpackage; faz parte do Ambiente de Trabalho K e, por consequência, está desenhado para se integrar no gestor de ficheiros do &kde;.

## Fundamental da Interface

O &kpackage; tem dois painéis. O painel esquerdo mostra uma árvore com os pacotes instalados e disponíveis, enquanto o painel direito mostra alguma informação sobre os pacotes.

### A Janela Principal - Árvore de Pacotes

Quando o &kpackage; é iniciado normalmente (isto é, não foi invocado através de arrastamento para o mesmo e não lhe foi indicado nenhum parâmetro), ele mostra dois painéis com a árvore de pacotes à esquerda; esta árvore mostra os pacotes instalados e pode mostrar também os pacotes novos e actualizados.

O Painel Esquerdo do &kpackage;
Painel Esquerdo - Árvore de Pacotes

Painel Esquerdo - Árvore de Pacotes

O painel esquerdo mostra a lista de pacotes

Por baixo das páginas, encontra-se a linha Procurar:, que filtra a árvore de pacotes, de modo que só os pacotes, cujo nome ou resumo contenha o texto procurado, sejam apresentados. As colunas que são pesquisadas podem ser alteradas num menu que aparece se carregar com o &RMB; na linha de procura.

A seguir à linha de procura existe um menu que filtra os pacotes apresentados com base no estado:

- Pacotes Instalados - Mostra os pacotes instalados

- Pacotes Novos - Mostra os pacotes não instalados

- Pacotes Actualizados - Mostra os pacotes para os quais estão disponíveis novas versões

- Pacotes Disponíveis - Mostra os pacotes não instalados

- Todos os Pacotes - Todos os pacotes

A árvore de pacotes baseia-se nas secções da distribuição e mostra uma informação de resumo sobre os pacotes:

- Pacote - Nome do pacote

- Marcado - Mostra um sinal se o pacote foi marcado. A marcação permite instalar ou desinstalar vários pacotes de uma vez, usando os botões por baixo da árvore de pacotes.

- Resumo - Uma breve descrição do pacote.

- Tamanho- O tamanho do pacote

- Versão - A versão do pacote

- Versão Antiga - Se o pacote actualiza a versão antiga de um pacote

Os pacotes têm legendas gráficas para indicar o seu estado, uma imagem que represente o tipo de pacote significa que o pacote está instalado, um D indica um pacote disponível e um A corresponde a um pacote que pode actualizar um outro já instalado.

Pode seleccionar um único pacote se carregar no seu nome. Se carregar no ponto na coluna Marca, assinala o pacote, enquanto que ao carregar segunda vez remove a marca; para além disso o &Shift;botão esquerdo pode ser usado para seleccionar um conjunto de pacotes e o &Ctrl;esquerdo poderá também ser usado para adicionar e remover marcas nos pacotes.

Ao seleccionar um pacote na árvore obtém as suas informações no painel direito.

### A Janela Principal - Painel de Informação do Pacote

O painel direito tem páginas para apresentar quatro tipos diferentes de informação acerca dos pacotes seleccionados

- O Painel Direito do &kpackage; - Propriedades
  Painel Direito - Propriedades do Pacote

  A página de Propriedades que mostra informações sobre o pacote seleccionado.

- O Painel Direito do &kpackage; - Dependências
  Painel Direito - As Dependências do Pacote

  A página de Lista de Dependências mostra as dependências e ofertas do pacote.

- Painel Direito do &kpackage; - Ficheiros
  Painel Direito - Os Ficheiros no Pacote

  O botão Lista de Ficheiros mostra os ficheiros no pacote e para os pacotes instalados mostra o estado dos ficheiros. Os ficheiros existentes tem uma marca de confirmação, os que faltarem têm uma cruz.

- Painel Direito do &kpackage; - Registo de Alterações
  Painel Direito - Os Ficheiros no Pacote

  O botão Registo de Alterações mostra o texto do registo de alterações do pacote.

### Instalar Pacotes

Para instalar um pacote, poderá

- localizar o pacote que deseja instalar no &konqueror; e arrastá-lo para uma instância a correr do &kpackage;

- carregar num ficheiro de pacote no &konqueror; e iniciar uma nova instância do &kpackage;

- usar os itens do menu Abrir no &kpackage;

- seleccionar um pacote disponível na árvore de pacotes

Para um pacote seleccionado, o botão Instalar faz aparecer a janela de instalação.

Para os pacotes marcados, usando os botões no painel esquerdo, o botão Instalar os Marcados faz aparecer a janela de instalação.

Janela de instalação do &kpackage;
Janela de Instalação

Janela de Instalação

A janela para Instalar indica os pacotes que podem ser seleccionados para ser instalados num painel em cima e à esquerda, assim como os pacotes necessários para satisfazer todas as dependências. Os pacotes seleccionados têm opções de marcação que permite desactivar a instalação dos mesmos.

O botão Instalar irá iniciar a instalação de facto. Normalmente a janela de instalação será fechada após uma instalação com sucesso mas, se a opção Manter esta janela estiver seleccionada, a janela irá permanecer.

O painel à direita é uma janela de terminal integrada, na qual os programas de instalação são corridos; para os programas de instalação interactiva esta interacção é feita nesta janela.

### Desinstalar Pacotes

Um pacote seleccionado pode ser desinstalado se usar o botão Desinstalar no painel direito; o botão Desinstalar os Marcados no painel direito poderá ser usado para desinstalar os pacotes marcados. Os botões fazem aparecer a janela para Desinstalar.

Janela de Desinstalação do &kpackage;
Janela de Desinstalação

Janela de Desinstalação

O botão Desinstalar na janela fará com que os pacotes sejam desinstalados; o painel direito disponibiliza uma janela de terminal integrada para os programas de desinstalação.

### Pesquisa

#### Linha de Procura de Pacotes

Linha de Procura do &kpackage;
Linha de Procura

Linha de Procura

A linha de Procura filtra a árvore de pacotes, de modo a que só os pacotes, cujo nome ou resumo contenha o texto procurado, sejam apresentados.

#### Procurar um Pacote

Procurar um Pacote do &kpackage;
Procurar um Pacote

Procurar um Pacote

A janela para Procurar um Pacote pesquisa os nomes dos pacotes na árvore e salta para o próximo pacote correspondente. Se o Sub-texto não estiver assinalado, então só serão apresentadas correspondências exactas para os nomes dos pacotes. Se a opção Procura geral não estiver activada, a procura não dará a volta no caso de chegar ao fim da árvore de pacotes.

#### Procurar um Ficheiro

Procurar um Ficheiro do &kpackage;
Procurar um Ficheiro

Procurar um Ficheiro

A janela para Procurar um Ficheiro pesquisa nos ficheiros as ocorrências que contenham o texto de procura. As colunas apresentadas são:

- Instalados - Assinalado se for um pacote instalado.

- Tipo - O tipo do pacote.

- Pacote - O nome do pacote

- Nome do ficheiro - O nome do ficheiro correspondente

Só os ficheiros nos pacotes instalados é que são mostrados, a menos que a opção Também procurar pacotes não instalados esteja activa; isto só irá funcionar com os pacotes do APT da Debian e só se o comando `apt-file` estiver instalado. A base de dados utilizada pelo comando `apt-file` é actualizada pelo item do menu Actualização de ficheiro Apt.

### Diversos

#### Acesso de Root

O &kpackage; precisa de acesso como root para instalar/desinstalar os pacotes; isto pode ser feito se correr o &kpackage; como root, por exemplo, através do &kdesu;.

Em alternativa, se o &kpackage; está a correr com um utilizador normal, ele irá tentar correr os programas de instalação/desinstalação como 'root', ligando-se através dum pseudo-terminal onde usa o `su`, o `sudo` ou o `ssh` para fazer isto. Se necessário, fará aparecer uma janela de terminal onde a senha de root pode ser escrita ou a chave de `ssh` ser fornecida. Para isto funcionar, a linha de comandos do root tem de acabar em # . A opção Recordar a senha faz com que o &kpackage; recorde a senha introduzida.

Linha de senha do &kpackage;
Linha de senha

Linha de senha

#### Arrastar e Largar

O &kpackage; recorre ao protocolo do KDE para Arrastar e Largar ('Drag-and-Drop'). Isto significa que o utilizador poderá arrastar e largar pacotes no &kpackage; para os abrir. Se largar um ficheiro na janela "Procurar Ficheiro", ela irá procurar o pacote que contém o ficheiro.

## Menus

Isto descreve os menus do &kpackage;.

### O Menu Ficheiro

Os itens no menu Ficheiro são:

&Ctrl;O Ficheiro Abrir...

  Invoca o selector de ficheiros para os ficheiros locais e de &FTP;

Ficheiro Abrir um Recente

  Uma lista com os ficheiros de pacotes abertos mais recentemente

Ficheiro Máquina Remota...

  Inicia outra cópia do &kpackage; para gerir outro sistema remotamente com o 'ssh'

Ficheiro Máquinas Remotas Recentes

  Uma lista com os sistemas remotos acedidos mais recentemente

Ficheiro Actualizar

  Actualiza os índices `apt` dos repositórios de pacotes.

Ficheiro Actualizar

  Actualiza a instalação da Debian para as últimas versões de todos os pacotes.

Ficheiro Corrigir

  Tentativa de resolver os problemas de dependências

F5 Ficheiro Recarregar

  Relê os dados dos pacotes e reconstrói a árvore de pacotes

&Ctrl;Q Ficheiro Sair

  Sai do &kpackage;

### O Menu Editar

Os itens no menu Editar são:

&Ctrl;F Editar Procurar Pacote...

  Procura na lista de pacotes instalados por um pacote cujo nome contenha o texto introduzido

Editar Procurar Ficheiro...

  Produz uma lista de pacotes que contêm o nome de ficheiro indicado, em que, se seleccionar uma linha, irá apresentar a informação sobre esse pacote. Isto comporta-se de maneira ligeiramente diferente para o RPM (onde o utilizador terá de indicar o nome do ficheiro exacto) e para o DEB (onde poderá introduzir uma expressão regular).

Editar Actualização do Ficheiro Apt

  A procura dos ficheiros de desinstalação usa o comando `apt-file`, o qual actualiza a base de dados que o `apt-file` usa.

### O Menu Pacotes

Os itens no menu Pacotes são:

&Alt;Esquerda Pacotes Recuar

  Um botão para voltar atrás para navegar pelas hiperligações nas entradas de Propriedades no painel direito.

&Alt;Direita Pacotes Avançar

  Um botão para avançar na navegação pelas hiperligações nas entradas de Propriedades no painel direito.

Pacotes Expandir a Árvore

  Expande completamente a árvore de pacotes

Pacotes Compactar a Árvore

  Fecha a árvore de pacotes, de modo que só a estrutura em árvore fique visível

Pacotes Limpar os Marcados

  Retira as marcas de todos os pacotes

Pacotes Marcar Tudo

  Marca todos os pacotes que sejam membros da janela seleccionada

Pacotes Instalar

  Instala o pacote seleccionado no momento

Pacotes Instalar os Marcados

  Instala todos os pacotes marcados

Pacotes Desinstalar

  Desinstala o pacote seleccionado no momento

Pacotes Desinstalar os Marcados

  Desinstala todos os pacotes marcados

### O Menu Configuração

Os itens no menu Configuração são:

Configuração Mostrar a Barra de Ferramentas

  Liga ou desliga a barra de ferramentas

Configuração Gravar a Configuração

  Grava as opções imediatamente

Configuração Configurar os Atalhos...

  A janela normal do &kde; para configurar as teclas de atalho

Configuração Configurar as Barras de Ferramentas...

  A janela normal do &kde; para configurar as barras de ferramentas

Configuração Configurar o &kpackage;...
  A janela de configuração do &kpackage; tem duas páginas:
    Comando
      Como Executar os Comandos Privilegiados

        Use o `su`, `sudo` ou `ssh` para correr comandos privilegiados para algumas coisas como a instalação e e desinstalação de pacotes. Por omissão, é o `su`, mas alguns sistemas como o &ubuntu; precisam do comando `sudo`. Para executar os comandos privilegiados nas máquinas remotas, é usado sempre o `ssh`.

    Diversos
      Verificar a Lista de Ficheiros

        Se a opção estiver assinalada, a lista de ficheiros no pacote é analisada para ver se eles estão realmente instalados

### O Menu Ajuda

Os itens no menu Ajuda são:

&help.menu.documentation;

### Barra de Ferramentas

- Abrir

- Recuar

- Avançar

- Expandir a Árvore

- Compactar a Árvore

- Procurar um Pacote

- Procurar um Ficheiro

- Actualizar

- Actualizar

- Actualizar

## Créditos e Licenças

&kpackage;

Documentação copyright 2005 Toivo Pedaste toivo@ucs.uwa.edu.au

Tradução de José Nuno Pires zepires@gmail.com

&underFDL; &underGPL;

## Instalação

### Como obter o &kpackage;

&install.intro.documentation;

Para mais informações sobre como obtê-lo e compilá-lo, veja o URL http://techbase.kde.org/Getting_Started

Existe mais informação sobre como compilar em http://techbase.kde.org/Getting_Started/Build/FAQ

Existe uma página Web em http://www.general.uwa.edu.au/u/toivo/kpackage

### Requisitos

Para instalar o &kpackage; é necessário:

- &Qt; 4 e o &kde; 4

- O gestor de pacotes SMART

Para listar os pacotes da Debian não é necessário outro 'software' mas, para instalar ou desinstalar os pacotes, é necessário:

- o gestor de pacotes `dpkg` ou

- o `apt-get` e o `apt-cache`

Para os pacotes do BSD, serão necessários os programas de gestão de pacotes:

- `pkg_info`

- `pkg_add`

- `pkg_delete`

Para os pacotes do Slackware, é necessário:

- `installpkg`

- `removepkg`

Para gerir os pacotes da Redhat é necessário:

- `rpm`

Para o &kpackage; funcionar correctamente com os pacotes RPM, a base de dados do RPM precisa de ser inicializada. Se, ao executar ```rpm `-qa```', ocorrer um erro do tipo ``unable to open....`` então deverá executar ```rpm `--rebuilddb```'.