# Introdução ao &kdevelop; — Uma Visita Guiada

Agora que você instalou o seu IDE &kdevelop;, como é que o vai utilizar bem? Dado que esta é uma aplicação complexa, a curva de aprendizagem pode ser um pouco inclinada, principalmente se não estiver já habituado a este tipo de ambientes de desenvolvimento integrados.

Iremos tentar suavizar esta curva de aprendizagem um pouco, vendo os passos de criação de uma aplicação do KDE em C++. Como tal, iremos dar uma vista de olhos (focada) em:

- O que é visto à superfície do IDE do &kdevelop;.
- Alguns passos de configuração iniciais.
- Como criar um novo projecto.
- Como lidar com os documentos.
- Como compilar a aplicação deste projecto.
- Como adicionar classes e outros detalhes ao seu projecto.
- O que fazer para depurar a aplicação.
- Algumas ferramentas básicas para compilar o programa ou a documentação do utilizador.

## Uma Vista Introdutória sobre o &kdevelop;

### À Superfície

Quando você inicia o &kdevelop; pela primeira vez, irá obter uma visualização semelhante à seguinte:

A disposição inicial do &kdevelop;

### Área de Trabalho e Páginas das Janelas de Ferramentas

Neste caso inicial, o &kdevelop; usa o modo denominado por modo de interface de utilizador IDEAl. Um espaço de trabalho com o tamanho máximo possível fica rodeado pela esquerda, baixo e direita por uma série de botões que actuam de forma semelhante às páginas numa área dividida em páginas. Se carregar numa destas páginas, aparece então uma janela de ferramentas que lhe permitirá trabalhar numa tarefa específica.

### Menu e Barras de Ferramentas

No topo, existe o menu normal, seguido de várias filas de barras de ferramentas, estando algumas vazias inicialmente. Elas serão populadas, logo que exista um projecto aberto para o trabalho de facto.

### Barra de Estado

Finalmente, existe uma barra de estado no fundo da janela que mostra algumas informações curtas sobre as várias tarefas.

### Como Obter Alguma Ajuda

Para além da Ajuda, que oferece algumas respostas a perguntas específicas, a barra de estado e dois tipos de dicas de ferramentas oferecem algumas informações rápidas.

### O Que Este Item do Menu Faz?

Quando voce coloca o cursor do rato sobre um item do menu, existe alguma informação curta que será apresentada na barra de estado. Embora isto, em alguns casos, repita apenas o nome da selecção, noutros poderá oferecer algumas informações adicionais sobre o intuito do comando do menu.

### Qual é o Nome Deste Item?

Em vários itens, irá aparecer uma dica com um nome curto da função, quando você colocar o cursor por cima dela durante alguns segundos. Isto é útil para uma orientação rápida na barra de ferramentas ou nas páginasd de ferramentas no modo IDEAl, quando o IDE tiver sido configurado para mostrar os ícones apenas nestes botões.

### O Que é Que Este Item Faz?

Está disponível mais alguma informação, através da ajuda de dicas de ferramentas para muitos itens do IDE. Seleccione a opção Ajuda O Que É Isto? ou carregue em &Shift;F1, podendo então com o cursor do ponto de interrogação seleccionar o item que deseja conhecer. Poderá também abrir qualquer menu desta forma e carregar num item específico do menu (tanto os activos como os desactivados, a cinzento) para ver se está disponível mais alguma informação.

### O que está nos menus

Existem dez menus seleccionáveis na barra de menu. A maioria deles fica preenchida por completo, logo que um projecto tenha sido aberto para trabalho, enquanto outros necessitam pelo menos de um documento aberto. Em resumo, eles irão permitir os seguintes tipos de acção.

Ficheiro

- ### Acções Normais

  Este menu é bastante comum. Permite criar, abrir, gravar, imprimir e fechar ficheiros de documentos, assim como sair da aplicação &kdevelop;, como é normal acontecer.

  ### Reverter as Alterações

  Para além disso, permite reverter as alterações, carregando de novo o conteúdo do ficheiro de uma forma ordeira.

Editar

- Este menu só é útil se estiver algum documento aberto.

  ### Acções Normais

  Oferece as acções normais para desfazer/refazer e para cortar/copiar/colar. Para além disso, permite seleccionar blocos de texto de várias formas.

  ### Procurar e Substituir

  Existe uma funcionalidade de procura muito poderosa disponível no menu Editar. Para além das acções normais de procura e substituição que se limitam ao documento actual, você poderá também conduzir uma procura e substituição a nível global. Isto permite trabalhar em todos os ficheiros do projecto de uma vez.

  ### Edição de Texto Avançada

  Existem possibilidades para formatar de novo o documento actual e para completar automaticamente alguns textos escritos parcialmente de várias formas.

Ver

- Tal como no menu Editar, este menu só é útil se estiver algum projecto aberto de momento. Neste caso, ficarão disponíveis as seguintes acções (entre outras):

  ### Histórico de Navegação

  Avance e recue pelos documentos &etc; que tenha visitado.

  ### Registo de Erros

  Navegue pelas linhas de código dos erros que foram encontrados no último processo de compilação/construção.

  ### Gerir a Janela de Ferramentas

  Seleccione ou esconda as janelas de ferramentas ou as áreas acopláveis de ferramentas.

  ### Acções Relacionadas com o Editor

  Alguns itens do menu Ver controlam a aparência e comportamento do editor que você usa. No caso do componente do &kate; (Editor de Texto Avançado Incorporado), ficarão disponíveis os seguintes controlos:

  - Controlar o comportamento de mudança de linha na janela do documento.

  - Mostrar ou esconder vários dados nas janelas de documentos: os números de linhas, ícones e, adicionalmente, as marcações de favoritos na barra de posicionamento.

  - Controlar a visibilidade das secções dobradas (temporariamente escondidas) num texto de código.

Projecto

- Todo o trabalho do &kdevelop; baseia-se em projectos que coleccionam basicamente os ficheiros de código, os ficheiros de gestão das compilações e outras informações numa pasta de projecto. Neste menu, poderá controlar o projecto a usar, as propriedades que tem e algumas acções de gestão. Em particular:

  ### Abrir um Projecto

  Permite criar projectos novos, abrir projectos existentes e importar os projectos de outros ambientes.

  ### Opções do Projecto

  Permite definir um conjunto completo de propriedades diferentes do projecto.

  ### Gestão de Classes

  Adiciona novas classes ao projecto e atravessa a árvore de heranças de uma classe.

  ### Distribuir o Projecto

  Ajuda a distribuir os pacotes de distribuição do projecto.

Compilar

- Este menu tem a ver com tudo o que respeita à compilação e documentação do projecto. Como tal, só é usado quando está um projecto aberto de momento. Neste caso, oferece as seguintes acções:

  ### Compilar, Editar as Ligações, Executar

  Permite compilar e gerar o executável do projecto completo ou de partes dele, assim como executar a aplicação a partir do IDE.

  ### Preparar as Operações de Compilação

  Isto depende, de facto, do sistema de compilações que usa para este projecto. No caso dos projectos do 'automake', ele permite correr o `Makefile.cvs` e o `configure` por si só. Existe também a possibilidade de remover os ficheiros traduzidos do projecto em várias etapas de intensidade.

  ### Instalar a Aplicação

  Permite instalar a aplicação, tanto nas pastas locais como nas pastas do sistema que só estão acessíveis para o utilizador 'root'.

  ### Documentação da API

  Compila ou remove a documentação da API baseada no 'doxygen' do projecto, tal como está definido nas opções do projecto.

Depuração

- Ainda que este menu seja preenchido quando está activo um projecto, só é útil de facto se o projecto actual tiver sido compilado previamente com a informação de depuração (o que é definido basicamente na opção Projecto Opções do Projecto..). Estão disponíveis as seguintes acções neste caso:

  ### Acções Normais do Depurador

  A primeira secção na opção Depurar oferece uma interface gráfica para o depurador simbólico GDB da &GNU;. Permite iniciar e parar a sua aplicação no depurador e percorrê-lo de várias formas.

  ### Pontos de Paragem

  O &kdevelop; oferece várias formas de definir pontos de paragem no código da sua aplicação. Uma delas é através da opção do menu Comutar o Ponto de Paragem.

  ### Depuração Avançada

  Outras opções do menu Depurar permitem uma análise mais sofisticada do programa. Use o &Shift;F1 para obter mais informações sobre o seu objectivo.

Janela

- Este menu é relativamente comum. Poderá seleccionar qualquer janela de documento aberta, assim como fechar aqui uma ou mais janelas. Poderá até seleccionar um conjunto de janelas de documentos para serem fechadas de uma vez.

Ferramentas

- O &kdevelop; é altamente personalizável. Poderá seleccionar um editor favorito para os seus documentos, assim como oferecer ferramentas externas e incorporadas para extender as capacidades básicas do IDE. O menu Ferramentas reflecte a maior parte desta configuração.

  ### Edição Avançada

  O conjunto superior dos itens do menu Ferramentas será oferecido pelo 'plugin' do editor em uso. Poderá seleccionar o seu editor favorito coma opção menu entries will be provided by the editor plugin which is in use. You may select your favorite Configuração Configurar o KDevelop... Editor. Logo que tenha sido seleccionado um ficheiro de documento editável, a parte superior do menu Ferramentas irá oferecer comandos de edição avançados, específicos para a componente do editor em uso.

  ### Tratamento da Parte Web

  No caso de a janela do documento activa conter uma página em HTML (⪚ mostrada numa selecção de Documentação), o menu Ferramentas irá mostrar itens de menu adicionais que oferecem várias formas de lidar com as páginas Web.

  ### Outras Ferramentas

  Normalmente existirão um conjunto de outros itens, de acordo com as ferramentas disponíveis de momento. Use o &Shift;F1 para obter mais informações sobre os seus fins.

Configuração

Ajuda

## Alguma Configuração

(--- a ser escrito ---)

## Como Iniciar um Projecto Novo — o &appwizard;

(--- a ser escrito ---)

## Lidar com os Documentos

(--- a ser escrito ---)

### Como Automatizar Algumas Tarefas de Escrita

(--- a ser escrito ---)

## Como Compilar um Projecto

(--- a ser escrito ---)

### O que Dizem as Mensagens

(--- a ser escrito ---)

## Como Extender um Projecto — o &automanag;

(--- a ser escrito ---)

### Uma Vista Rápida sobre a Maquinaria do Automake

(--- a ser escrito ---)

### Como Colocar os Ícones numa Pasta Separada

(--- a ser escrito ---)

### Como Adicionar Classes Novas

(--- a ser escrito ---)

Tenha cuidado quando selecciona os nomes dos seus ficheiros de classes. É extremamente difícil alterá-los depois.

### O que Está num Sub-Projecto?

(--- a ser escrito ---)

#### Concentre-se no seu Trabalho — o Alvo Activo

(--- a ser escrito ---)

### Alguns Passos para Restruturar um Projecto

(--- a ser escrito ---)

## Como Depurar

(--- a ser escrito ---)

## Uma Nota Sobre a Documentação

(--- a ser escrito ---)