# O Manual do &kpackage;

Toivo
Pedaste

    toivo@ucs.uwa.edu.au

Lauri
Watts

    &Lauri.Watts.mail;

Revisor
Henrique
Marks

    henrique@if.ufrgs.br

Tradução
Marcus
Gama

    marcus_gama@uol.com.br

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

O &kpackage; é uma interface &GUI; para os gerenciadores de pacotes RPM, Debian, Slackware e BSD,que usa o gereciador de pacotes SMART.

kpackage
pacote
gerenciador de pacotes
RPM
deb

## Introdução

O &kpackage; é uma interface &GUI; para os gerenciadores de pacotes RPM, Debian, Slackware e BSD. O &kpackage; é parte do KDE e, como resultado, é desenvolvido para integrar-se com o gerenciador de arquivos do &kde;.

## Fundamentos de Operação

O &kpackage; possui dois painéis. O painel esquerdo mostra uma árvore dos pacotes instalados e disponíveis, enquanto o painel direito mostra informações dos pacotes.

### A Janela Principal - Árvore de Pacotes

Quando o &kpackage; é iniciado normalmente (ou seja, não foi chamdo através de arrastar-e-soltar e não lhe foi passado parâmetros) ele mostra dois painéis, com a árvore de pacotes a esquerda; esta árvore mostra os pacotes instalados e também, opcionalmente, pacotes novos e atualizáveis.

Painel esquerdo do &kpackage;
Painel esquerdo - Árvore de Pacotes

Painel esquerdo - Árvore de Pacotes

O painel esquerdo exibe a lista de pacotes

Abaixo 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 foram buscadas podem, ser alteradas pelo menu clicando na linha de busca &RMB;.

Ao lado da busca existe um menu que filtra os pacotes exibidos baseados em seu status:

- Instalado - Mostra os pacotes instalados

- Novo - Mostra os pacotes não instalados ou não atualizados

- Atualizado - Mostra os pacotes que possuem versões novas disponíveis

- Novo - Mostra os pacotes não instalados

- Todos - Mostra todos os pacotes

A ávore de pacotes é baseada nas seções da distribuição e mostra informações resumidas sobre os pacotes

- Pacote - Nome do pacote

- Marcar - Mostra uma marca se o pacote foi marcado. As marcações permitem que múltiplos pacotes sejam instalados ou desinstalados de uma vez usando os botões localizados abaixo da árvore de pacotes

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

- Tamanho - O tamanho do pacote

- Versão - A versão do pacote

- Versão Antiga - Se o pacote atualiza um pacote instalado, mostra a versão do pacote antigo

Os pacotes possuem marcas gráficas para indicar seu estado, sendo que uma imagem ao lado de um pacote significa que ele está instalado, um N indica um pacote disponível para instalação e um U indica que o pacote pode ser atualizado

Um pacote é selecionado clicando no seu nome. Clicando na marca (ponto) ao lado do pacote, na coluna correpondente a aba Marcar marca o pacote com um traço, e um segundo clique desmarca-o, enquanto apertando &Shift;Botão esquerdo pode ser usado para marcar um conjunto de pacotes num intervalo e clicando &Ctrl;Botão esquerdo pode ser usado para adicionar e remover marcas dos pacotes.

Selecionando um pacote da árvore mostra informações sobre ele no painel a direita

### A janela principal - Painel de informações dos pacotes

O painel a direita tem abas para mostrar quatro tipos diferentes de informações sobre os pacotes selecionados

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

  A aba Propriedades mostra as informações do pacote selecionado.

- Painel direito do &kpackage; - Dependências
  Painel direito - As dependências do pacote

  A aba Lista de dependência mostra as dependências do pacote.

- Painel direito do &kpackage; - Arquivos
  Painel Direito - Os arquivos do pacote

  A aba Lista de Arquivos mostra os arquivos no pacote, e, para os pacotes instalados (desde que a informação esteja disponível) mostra o estado dos arquivos. Arquivos que existem estão marcados com um traço, e aqueles que não existem estão marcados com um X

- Painel direito do &kpackage; - Log
  Painel Direito - Os arquivos do pacote

  A aba Modificar Registro mostra as mudanças de registro (logs) para o pacote

### Instalando Pacotes

Para instalar um pacote você pode

- Localizar o pacote que você quer instalar no &konqueror;, e arrastá-lo para dentro do &kpackage; que está rodando

- Clicar num arquivo de pacote no &konqueror; e iniciar uma nova sessão do &kpackage;

- Uso do item Abrir do menu do &kpackage;

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

Para pacotes marcados, use o botão Instalar na caixa de diálogo que abre a janela de instalação.

Para pacotes marcados, use o botão Instalar Marcados no painel a esquerda, que abre a janela de instalação.

Diálogo de instalação do &kpackage;
Diálogo de Instalação

Diálogo de Instalação

A janela de instalação lista os pacotes que serão selecionados para serem instalados num painel no canto superior esquerdo, e mostra também os pacotes necessários para satisfazer as dependências. Abaixo deste há um conjunto de caixas de verificação com opções para a instalação do programa a ser desabilitada.

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

O painel à direita é uma janela de terminal integrada na qual os programas de instalação são rodados; para os programas de instalação interativa esta interação é feita nesta janela.

### Desinstalando Pacotes

Um pacote selecionado pode ser desinstalado usando o botão Desinstalar no painel direito; o botão Desinstalar marcados no painel direito poderá ser usado para desinstalar os pacotes marcados. Os botões fazem aparecer a janela de desinstalação Uninstall.

Diálogo de instalação do &kpackage;
Diálogo de Desinstalação

Diálogo 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.

### Procurando

#### Linha de Procura de Pacote

Linha de Procura do &kpackage;
Linha de Procura

Linha de Procura

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

#### Procurar Pacote

Procurar Pacote no &kpackage;
Procurar Pacote

Procurar Pacote

O diálogo Procurar 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 exatas para os nomes dos pacotes. Se a opção Procura geral não estiver ativada, a procura não irá para o início no caso de chegar ao fim da árvore de pacotes.

#### Procurar Arquivo

Procurar Arquivo no &kpackage;
Procurar Arquivo

Procurar Arquivo

O diálogo para Procurar Arquivo pesquisa nos arquivos as ocorrências que contenham o texto de procura. As colunas apresentadas são:

- Instalado - Assinalado se for um pacote instalado.

- Tipo - O tipo do pacote.

- Pacote - O nome do pacote.

- Nome do Arquivo - O nome do arquivo correspondente

Só os arquivos nos pacotes instalados são mostrados, a menos que a opção Também procurar pacotes não instalados esteja ativa; 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` é atualizada pelo item do menu Atualizar arquivo Apt.

### Outros

#### Acesso de Root

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

Como alternativa, se o &kpackage; está rodando com um usuário normal ele irá tentar rodar os programas de instalação/desinstalação como root logando-se através dum pseudo-terminal, em que usa o `su` ou o `ssh` para fazer isto. Se necessário fará aparecer uma janela de terminal onde a senha de root pode ser digitada. Para isto funcionar a linha de comando do root tem que terminar em #. A opção Lembrar senha faz o &kpackage; lembrar da senha que é digitada.

Solicitação de senha do &kpackage;
Solicitação de senha

Solicitação de senha

#### Arrastar e Soltar

O &kpackage; usa o protocolo do KDE de 'Arrastar e Soltar'. Isto significa que você pode arrastar e soltar pacotes no &kpackage; para abrí-los. Ao soltar um arquivo no diálogo Procurar Arquivo ele irá procurar o pacote que contém o arquivo.

## Menus

Isto descreve os menus do &kpackage;.

### O menu Arquivo

Os itens no menu Arquivo são:

&Ctrl;O Arquivo Abrir...

  Invoca o seletor de arquivos para os arquivos locais e de &FTP;

Arquivo Abrir recente

  Uma lista com os arquivos de pacotes abertos mais recentemente

Arquivo Servidor remoto

  Inicia outra cópia de &kpackage; para gerenciar outro sistema remoto usando ssh

Arquivo Abrir servidor remoto recente

  Uma lista com os servidores remotos acessados mais recentemente

Arquivo Atualizar

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

Arquivo Atualizar

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

Arquivo Corrigir

  Tentar corrigir os problemas de dependência

F5 Arquivo Recarregar

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

&Ctrl;Q Arquivo 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 inserido

Editar Procurar arquivo...

  Produz uma lista de pacotes que contém o nome de arquivo inserido, onde selecionando uma linha apresentará as informações sobre esse pacote. Isto comporta-se de maneira ligeiramente diferente para o RPM (onde você tem que indicar o nome do arquivo exato) e para o DEB (onde você pode inserir uma expressão regular).

Editar Atualizar apt-file

  Ao procurar por arquivos de desinstalação usa o comando `apt-file`, que atualiza a base de dados que o `apt-file` usa.

### O menu Pacotes

Os itens no menu Pacotes são:

&Alt;Seta esquerda Pacotes Recuar

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

&Alt;Seta direita Pacotes Avançar

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

Pacotes Expandir Árvore

  Expande completamente a árvore de pacotes

Pacotes Colapsar Árvore

  Fecha a árvore de pacotes de maneira que só a estrutura em árvore é visível

Pacotes Limpar Marcados

  Retira as marcas de todos os pacotes

Pacotes Marcar Tudo

  Marca todos os pacotes que sejam membros da visão selecionada

Pacotes Instalar

  Instalar o pacote selecionado atualmente

Pacotes Instalar Marcados

  Instala todos os pacotes marcados

Pacotes Desinstalar

  Desinstala o pacote selecionado atualmente

Pacotes Desinstalar Marcados

  Desinstala todos os pacotes marcados

### O menu Configurações

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

Configurações Mostrar Barra de Ferramentas

  Liga ou desliga a barra de ferramentas

Configurações Salvar configurações

  Salva as opções imediatamente

Configurações Configurar Atalhos...

  O diálogo padrão do &kde; para configurar as teclas de atalho

Configurações Configurar barras de ferramentas

  O diálogo padrão do &kde; para configurar as barras de ferramentas

Configurações Configurar o &kpackage;...
  A caixa de diáologo de configuração da &kpackage; tem duas páginas:
    Comando
      Como executar comandos privilegiados

        Use `su`, `sudo` ou `ssh` para executar comandos com privilégios para algumas coisas como instalar e desinstalar pacotes, o padrão é `su` mas alguns sistemas como &ubuntu; necessitam do `sudo`. Para executar comandos com privilégios em máquinas temotas o `ssh` é sempre usado.

    Outros
      Verificar a lista de arquivos

        Se estiver assinalado a lista de arquivos 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 árvore de pacotes

- Recolher árvore de pacotes

- Procurar Pacote

- Procurar Arquivo

- Atualizar

- Atualização da Instalação

- Atualizar

## Créditos e Licenças

&kpackage;

Direitos autorais da documentação 2000 Toivo Pedaste toivo@ucs.uwa.edu.au

Tradução de Marcus Gamamarcus_gama@uol.com.br

&underFDL; &underGPL;

## Instalação

### Como obter o &kpackage;

&install.intro.documentation;

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

Existem 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 &kde; 4

- Gerenciador 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 gerenciador de pacotes `dpgk`

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

Para os pacotes do BSD você precisas dos programas de gerenciamento de pacotes:

- `pkg_info`

- `pkg_add`

- `pkg_delete`

Para os pacotes do Slackware você precisa do:

- `installpkg`

- `removepkg`

Para gerenciar os pacotes da Redhat é necessário:

- `rpm`

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