Bernd
Pol

# Introdução — o &appwizard;

No &kdevelop;, o trabalho de desenvolvimento de 'software' está organizado em projectos. Cada um desses projectos reúne tudo o que pertença a uma tarefa de programação completa: ficheiros de código, ficheiros de dados adicionais e todas as necessidades de gestão, como o sistema de compilação, assim como o acesso a todos os componentes e a todas as ferramentas adicionais que sejam necessárias para pôr a aplicação a funcionar.

A organização de todo o trabalho de desenvolvimento nos projectos permite-lhe mudar facilmente de tarefas para tarefas, a nível global. Isto é bastante útil se você, &eg;, trabalha em várias aplicações ao mesmo tempo, como poderá ser normalmente o caso. Diga ao &kdevelop; para abrir o projecto com que deseja trabalhar e poderá continuar no ambiente tal e qual o deixou.

## Projectos Novos

Sempre que deseje iniciar um novo projecto de programação, terão de ser efectuados vários procedimentos formais de configuração. Terá de ser criada uma estrutura de directorias inicial, os ficheiros de inclusão e de código terão de ser fornecidos, o sistema de compilações tem de ser inicializado, &etc;

O &kdevelop; fornece uma forma simples de iniciar um novo projecto de programação — o &appwizard;. Você irá encontrar o &appwizard; no item de menu Projecto Novo Projecto.

Só é necessária uma série curta de passos para iniciar um novo projecto de programação, usando o &appwizard;:

1. Seleccionar a linguagem de programação que você deseja usar e o tipo da aplicação que deseja compilar, a partir de um conjunto de modelos predefinidos.

2. Fornecer algumas informações gerais como o nome da aplicação, a directoria em que a aplicação deverá ser criada, &etc;

3. Decidir se deseja usar um sistema de controlo de versões, como &eg; o CVS, e fornecer os dados necessários.

4. Definir alguns modelos para os ficheiros de inclusão e de código iniciais (se for necessário).

5. Finalmente, dizer ao &appwizard; para configurar todos os artefactos iniciais, a estrutura de directorias, os modelos de ficheiros de ficheiros de código/inclusão iniciais e as ferramentas de gestão, &eg; um esqueleto inicial de compilação, &etc;

'Voilà' — é tudo. O &appwizard; irá fornecer-lhe então um conjunto inicial e funcional de ficheiros de programação, nos quais você poderá começar prontamente a trabalhar.

Vamos então olhar agora para tudo isto com mais detalhe ...

### Passos Iniciais

Para criar um novo projecto no &kdevelop;, seleccione Novo Projecto do menu Projecto. A janela para Criar um Novo Projecto irá aparecer e mostrar-lhe-á uma página Geral inicial:

Janela inicial de configuração de um novo projecto

Como pode ver, esta janela está dividida numa parte superior e numa inferior. Na parte superior, você poderá decidir sobre a linguagem de programação e o tipo de aplicação, enquanto que a parte inferior contém algumas informações gerais.

#### Seleccionar a Linguagem de Programação e o Tipo de Aplicação

O lado esquerdo da parte superior desta janela é onde você faz o trabalho de selecção. Quando aparecer, você irá encontrar então uma lista de pastas, em que cada uma contém uma linguagem de programação, como por exemplo:

- Ada

- C

- C++

- Bases de Dados (Projectos SQL)

- Fortran

- Haskell

- Java

- PHP

- Pascal

- Perl

- Python

- Ruby

- Linha de Comandos ('Scripts' para a Linha de Comandos Bash)

Para ser mais exacto, estas pastas não contêm ferramentas de programação de facto. Elas sim conduzem a modelos predefinidos que você poderá usar como ponto de partida para programar nessa linguagem. Para ter uma ideia do que é fornecido, basta abrir as pastas uma a seguir à outra. Irá aparecer um conjunto de subpastas em algumas e apenas um ou mais itens simples noutras. As subpastas que você verá organizam os modelos disponíveis de acordo com algumas tarefas, enquanto que os itens simples indicam os modelos que você poderá seleccionar.

Não poderemos entrar em detalhes aqui sobre que tarefas fazem o quê, mas é fácil descobrir. Sempre que você seleccionar um modelo, é mostrada alguma informação nos campos à direita. No campo inferior, você irá encontrar uma breve descrição sobre o que é que o modelo é suposto fazer. No campo acima dele é mostrada uma imagem, se estiver disponível, sobre o resultado da aplicação que este modelo produz se você a compilar e correr sem modificações. Normalmente, esta é uma fotografia da janela principal que a aplicação irá mostrar.

Seleccione o modelo que melhor se adequa aos objectivos da sua aplicação como ponto de partida. Depois introduza as informações das propriedades gerais no campo inferior, tal como é mostrado no capítulo seguinte.

##### Seleccionar um Sistema de Gestão de Projectos

Cada modelo está associado a um Sistema de Gestão de Projectos específico. De momento, não existe uma forma livre de seleccionar um desses Sistemas de Gestão de Projectos. Você terá de procurar um modelo que se adeque às suas necessidades ou de alterar o seu projecto, depois de criado, de acordo com isso.

#### Fornecer Informação Geral

A parte inferior da janela Criar um Novo Projecto, na página Geral, é uma área chamada Propriedades. Você tem de indicar aqui algumas informações gerais sobre o seu projecto, de modo a que o &appwizard; saiba como criar a estrutura inicial.

##### Nome da Aplicação

A sua aplicação precisa de um nome, como é óbvio. Indique-o no campo Propriedades, chamado Nome da Aplicação. Iremos usar MinhaAplicacao por exemplo.

Quando o fizer, você irá reparar que o &appwizard; se recusará a aceitar caracteres especiais de qualquer espécie. Os únicos caracteres aceites são:

- caracteres maiúsculos e minúsculos

- números

- o carácter de sublinhado (_)

Uma razão importante para esta restrição é que o &appwizard; irá usar este nome da aplicação como base dos nomes de algumas classes que irá construir quando configurar o projecto inicialmente. Daí, o nome da aplicação terá de se adequar às regras da linguagem de programação que usar.

##### A Directoria do Projecto

A outra causa para esta restrição poderá ser vista por si na linha inferior da área Propriedades. Chama-se Localização final e mostra a directoria onde o &appwizard; irá criar a aplicação.

À medida que você vai escrevendo o nome da aplicação, você irá reparar que o &appwizard; repete os seus dados introduzidos no fim da linha Localização final, usando apenas os caracteres minúsculos.

Como tal, você terá de seleccionar o nome da sua nova aplicação com cuidado. Se você terminar com o nome de uma directoria já utilizada, o &appwizard; não lhe permitirá passar para o próximo passo, mantendo o botão Próximo > desactivado (a cinzento). De qualquer forma, ele avisá-lo-á nesse caso, adicionando o texto (dir/ficheiro já existe) no campo Localização final.

##### A Localização Inicial

Existem duas formas de seleccionar outra pasta para a sua nova aplicação. Uma passa por seleccionar outro nome. Contudo, isso nem sempre é conveniente (você poderá, &eg;, configurar outra versão de uma aplicação já existente). Como alternativa, você poderá seleccionar outra localização para a pasta da aplicação.

Isto é feito com o segundo campo das Propriedades, chamado Localização. O que você indicar aqui é a localização inicial da directoria de desenvolvimento da nova aplicação. O &appwizard; irá adicionar o nome da aplicação a esta directoria quando inicializar o novo projecto. O resultado é apresentado no campo Localização final, que lhe dá um melhor controlo sobre o que se passa.

O &appwizard; irá copiar um valor inicial para o campo Localização no início. Este é extraído a partir do que você tiver escolhido no campo Directoria de projectos por omissão dos passos gerais de configuração. No nosso caso, o &kdevelop; está configurado para usar a `/home/ze/projectos`.

Altere o conteúdo do campo Localização para que a directoria de desenvolvimento das aplicações mostrada na linha Localização final seja única.

Tenha em atenção se a linha do campo Localização já existe ou não. O &appwizard; irá avisá-lo se indicar localizações inexistentes adicionando (inválido) ao campo Localização final.

##### Dados Pessoais

Os campos a seguir não são tão críticos. Basta indicar o seu nome (i.e., o nome da pessoal responsável pela aplicação) no campo Autor e um endereço de e-mail válido no campo E-mail, de modo que os utilizadores lhe possam comunicar algo sobre a aplicação.

1. O &appwizard; preenche este campos com alguns valores predefinidos, extraídos a partir da configuração do E-mail no &kcontrolcenter;. Se estes valores nos campos da janela Criar um Novo Projecto, para o Autor e para o E-mail não forem válidos, você poderá ter de ver a sua configuração de e-mail no &kcontrolcenter;.

2. O &appwizard; integrará esta informação nos modelos iniciais de programas, se tal se aplicar. Nos programas em C++ para o &kde;, por exemplo, você poderá encontrá-la perto do início do ficheiro de código `main.cpp`.

3. De todos os campos, o E-mail é opcional, o que reflecte o facto de que nem todos os programadores terão acesso à Internet. Você poderá manter este campo em branco se o desejar e continuar o seu trabalho.

##### Informação da Versão e da Licença

Finalmente indique um número de versão inicial para a sua aplicação nova no campo Versão e seleccione a licença segundo a qual deseja publicar a sua aplicação na página Licença.

Se você seleccionar um tipo de aplicação para o qual o &appwizard; forneça textos de modelos de código comuns (&eg;, C/C++), você poderá ver o texto de notificação da licença na terceira página desta janela Criar um Novo Projecto (veja o capítulo sobre como Fornecer modelos de código/inclusão em baixo).

Se você indicou Personalizada na página Licença, você terá de indicar um texto próprio para a licença.

Tanto a informação da licença como da versão serão integradas nos modelos iniciais num formato adequado que o tipo de aplicação que você seleccionou ofereça.

Logo que tenha introduzido toda esta informação, carregue no botão Próximo > para avançar, tal como é mostrado nos capítulos seguintes.

### Fornecer a Informação do Sistema de Controlo de Versões

Num segundo passo, o &appwizard; levá-lo-á para a página do Sistema de Controlo de Versões, onde poderá decidir qual o sistema de controlo de versões que desejará usar.

Esta discussão concentra-se nas necessidades apenas para a criação do projecto. Para mais informações sobre o &CVS; veja o capítulo sobre como Usar o &CVS; em baixo.

#### Nenhum Sistema de Controlo de Versões Necessário

Inicialmente, está a opção Nenhum seleccionada na página do Sistema de controlo de versões, onde a página ficará em branco. Se não quiser usar nenhum sistema de controlo de versões, basta carregar no botão Próximo > e seguir em frente.

#### Usar o &CVS;

Caso contrário, você terá de seleccionar de novo o sistema de controlo de versões que deseja usar na página Sistema de controlo de versões. De momento, só o &cvs; é que está disponível. Se o seleccionar, então o &appwizard; irá mostrar de novo a página, mostrando ela agora um conjunto de campos que precisa de preencher.

Configurar o novo projecto no CVS

Um sistema de controlo de versões como o &CVS; (que significa Concurrent Versions System ou Sistema Concorrente de Versões) guarda as cópias dos ficheiros seleccionados do projecto numa espécie de base de dados. Se você usar o &CVS; você poderá, entre outras coisas, enviar (fazer commit) destes ficheiros ou carregá-los para a sua directoria do projecto (fazer um checkout ou um update). O que há de especial nisto é que os ficheiros na base de dados das versões são gravados de uma forma estruturada que permite em qualquer altura voltar atrás a um estado anterior de desenvolvimento, se for necessário. Para além disso, o &CVS; permite a vários programadores colaborarem facilmente num grande projecto (como o &kdevelop;) sem estragar o trabalho dos outros.

#### Raiz do &CVS;

O &CVS; precisa de gerir a base de dados de versões que mantém para os seus ficheiros do projecto. Para o conseguir, ele mantém alguma informação especial da base de dados numa directoria própria, chamada de raiz do &CVS;. O primeiro passo para configurar o &CVS; para o seu projecto novo é então indicar ao &kdevelop; onde é que se localiza essa raiz.

Raiz local do &CVS;. Existem duas possibilidades básicas. Ou você usa uma base de dados local do &CVS; ou poderá usar uma base de dados que é mantida num servidor remoto. Se fizer desenvolvimentos próprios, você poderá usar a base de dados do &CVS; como uma espécie de base de dados de salvaguarda no seu próprio computador. Normalmente esta é configurada na raiz da sua área pessoal e é-lhe dado o nome `cvsroot`. Isto poderá assemelhar-se ao seguinte:

``/home/ze/cvsroot`` (em que `ze` poderá ser substituído pelo nome do seu utilizador).

De facto, este é um formato curto. De forma exacta, a raiz local do &CVS; deverá ser endereçada com o prefixo `:local:`. O formato curto só é permitido nos casos em que o nome do ficheiro começa por uma barra (`/`). O nome completo do nosso exemplo seria então igual a `:local:/home/ze/cvsroot`

Indique o nome da directoria-raiz do &CVS; que foi configurada para o seu sistema no campo Raiz do CVS. Em princípio, você poderá seleccionar qualquer nome, ou até mesmo usar várias bases de dados do &CVS;, mas aconselha-se que você se associe à raiz do &CVS; logo que esteja configurada.

Inicializar uma nova raiz do &CVS;. Se não existir ainda nenhuma raiz do &CVS;, o &kdevelop; poderá dizer ao sistema do &CVS; para criar uma para si na directoria indicada. Basta assinalar a opção Iniciar raiz por baixo do campo Raiz do CVS.

Como foi dito, o &kdevelop; só manda o sistema do &CVS; inicializar uma nova raiz do &CVS;. Não faz nada, por si só, a esta directoria. Felizmente, o &CVS; é esperto o suficiente para verificar se a directoria de raiz do &CVS; já existe ou não. Como tal, não fará mal nenhum se você tiver assinalado inadvertidamente a opção Iniciar raiz numa directoria de raiz do &CVS; já existente.

Raiz do &CVS; remota. Existem ocasiões em que a base de dados do &CVS; deverá ser mantida num servidor remoto, especialmente quando vários programadores trabalharem no mesmo projecto. Aí, você terá de indicar o URL da raiz do &CVS; deste servidor no campo Raiz do CVS. Por exemplo, se você quiser aceder ao servidor de &CVS; do &kde;:

``:pserver:utilizador@cvs.kde.org:/home/kde`` (onde o utilizador corresponde ao nome do utilizador definido para a sua conta de &CVS; do &kde;)

#### Tipos de Servidores de &CVS; Remotos

Basicamente existem dois tipos de servidores de &cvs; remotos largamente usados, o pserver que usa um protocolo não-cifrado e protegido por senha, ou o ext que uma transferência de dados cifrada por RSH ou SSH. Eles são distinguidos de acordo com o prefixo do &URL; que usam:

`:pserver:`

para o tipo de servidor não-cifrado e protegido por senha, ou

`:ext:`

para um tipo de servidor cifrado por RSH ou SSH. Por exemplo, o

``:ext:utilizador@cvs.cervisia.sourceforge.net:/cvsroot/cervisia``

acede à raiz do &CVS; da conhecida aplicação Cervisia, que é usada para gerir o &CVS; e que está no servidor do SourceForge.

Se você quiser usar um servidor cifrado por RSH ou por SSH para o acesso ao &CVS;, você terá de dizer ao &kdevelop;, qual o protocolo de cifra a usar. Basta indicar `rsh` ou `ssh` no campo CVS_RSH da página Criar um Novo Projecto Sistema de Controlo de Versões.

Existe uma contrapartida se você usar um servidor cifrado para o &CVS; no &kdevelop;. Veja o capítulo Usar o &CVS; para mais detalhes.

#### O Repositório de &CVS;

Até agora você só indicou ao &kdevelop; onde é que a raiz do &CVS; se encontra para gerir a base de dados das versões e como aceder-lhe. Agora, você irá precisar de dizer ao &kdevelop; sob que nome você irá querer que o &CVS; grave os seus ficheiros do projecto nessa base de dados. O local onde os seus ficheiros do projecto serão guardados no &CVS; é chamado de repositório.

Em princípio, você poderá usar qualquer nome para o repositório de &CVS; dos ficheiros do seu projecto, desde que corresponda às especificações de nomes de ficheiros. Mesmo assim, a maioria dos programadores usam apenas o nome da aplicação em si. O &CVS; irá criar uma directoria com esse nome na raiz do &CVS;, para que seja encontrada com maior facilidade se você mantiver o nome da aplicação nela.

Basta indica o nome do repositório que deseja usar no campo Repositório do CVS da página Criar um Novo Projecto Sistema de Controlo de Versões. No nosso exemplo, esta é: `NovaAplicacao`

Tenha cuidado em não usar um repositório que já exista! O sistema &CVS; não o avisa sobre os ficheiros duplicados mas irá limpar tudo o que não conduza a um conflito formal. Em resumo, você poderá deixar tudo confuso!

#### Os Campos Restantes

Não existe já muito mais para fazer. O &appwizard; já configurou os campos restante por si. Em detalhe:

O campo do Vendedor é usado apenas por razões de compatibilidade. Você poderá usar o valor por omissão distribuidor que o &appwizard; usa.

O campo da Mensagem permite-lhe comentar o conteúdo inicial do &CVS;. Use o texto que desejar ou poderá manter o texto novo projecto que o &appwizard; colocou.

O campo Marca de lançamento contém o nome que é marcado para o estado inicial do seu projecto. Essa marca define um certo ponto no repositório do &CVS; a que você poderá aceder posteriormente para este estado do seu desenvolvimento. (Veja mais no capítulo Usar o &CVS;.)

O &appwizard; colocou uma marca inicio, a qual é uma proposta aceitável. Basta usá-la.

Quando qualquer uma destas informações está errada, o &kdevelop; normalmente não irá saber de nada até à altura da criação do projecto. É o sistema do &CVS; que irá descobrir esses erros ao tentar criar o repositório. Aqui você deverá dar uma vista de olhos na janela Mensagens do &kdevelop; logo que o projecto for criado no passo final da configuração. Se ocorreu algum erro com o &CVS;, você irá ver na maioria dos casos uma mensagem semelhante a esta:

    * cd '/home/ze/teste' e&& cvs -d '/home/ze/raiz_cvs' \
      import -m 'novo projecto' '' 'distribuidor' 'inicial' &&\
      sh /opt/kde3/share/apps/kdevcvs/buildcvs.sh . '' \
      '/home/ze/raiz_cvs'
    * cvs [import aborted]: /home/ze/raiz_cvs/CVSROOT: No such file or
      directory
    * *** Exited with status: 1 ***

Se isto acontecer, você terá de configurar manualmente o &CVS; (o &kdevelop; deverá ter conseguido inicializar com sucesso os ficheiros do seu projecto nesta altura) ou então remover a directoria do projecto e começar tudo de novo com a opção Novo Projecto do menu Projecto.

Depois de você ter introduzido toda a configuração relacionada com o &CVS;, carregue no botão Próximo > para prosseguir.

Se você quiser corrigir um erro na página anterior do Criar um Novo Projecto, basta carregar no botão < Anterior. O &appwizard; irá recordar os seus resultados na página actual, por isso você poderá prosseguir com facilidade quando regressar.

### Fornecer os Modelos de Ficheiros de Código/Inclusão

O próximo passo leva-o a uma série de páginas onde poderá configurar informações comuns que deseje incluir nos seus ficheiros de código e de inclusão, se a tarefa à mão o permitir.

Tanto os modelos para ficheiros de código e de inclusão são fornecidos para as aplicações de C e C++, cada um na sua própria página. Para as outras linguagens, só deverão existir modelos de ficheiros de código. E ainda, noutros casos, você poderá encontrar esta página de modelos em branco.

Se a página for usada, o &appwizard; irá preencher um dado comentário comum sobre o que uma aplicação em C++ poderá parecer (o texto está em inglês, dado ser uma transcrição da licença GPL):

    /***************************************************************************
     *   Copyright (C) 2003 by O Seu Nome                                      *
     *   voce@proprio.com                                                      *
     *                                                                         *
     *   This program is free software; you can redistribute it and/or modify  *
     *   it under the terms of the GNU General Public License as published by  *
     *   the Free Software Foundation; either version 2 of the License, or     *
     *   (at your option) any later version.                                   *
     *                                                                         *
     *   This program is distributed in the hope that it will be useful,       *
     *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
     *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
     *   GNU General Public License for more details.                          *
     *                                                                         *
     *   You should have received a copy of the GNU General Public License     *
     *   along with this program; if not, write to the                         *
     *   Free Software Foundation, Inc.,                                       *
     *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
     ***************************************************************************/

Outros modelos irão fornecer várias informações semelhantes num formato que esteja de acordo com as definições da linguagem de programação que deseja usar.

Como você poderá já ter notado, o gestor de aplicações já preencheu alguma informação que você indicou na primeira página Geral da janela Criar um Novo Projecto, nomeadamente o conteúdo dos campos Autor e E-mail. Também a informação adequada da licença foi introduzida de acordo com a sua selecção na página Licença.

#### Como Editar os Modelos

Os modelos que você configurar na janela Criar um Novo Projecto serão depois processados, sempre que você disser ao &kdevelop; para configurar um novo ficheiro de código e/ou de inclusão. A informação que indicar aqui será incluída no topo, como um cabeçalho de documentação, antes de a parte do código começar.

Você não está restrito ao texto normal, de qualquer forma. O &kdevelop; reconhece diversas variáveis que lhe permitirão incluir a informação actualizada no ficheiro. O &appwizard; usou de facto algumas variáveis para inserir o Autor, o E-mail e a Licença no campo de texto do modelo inicial.

Incluir a Informação do Ficheiro para o &doxygen;

  Se, por exemplo, você quiser que a documentação da &API; gerada pelo &doxygen; mostre alguma informação sobre o conteúdo do ficheiro na sua lista de ficheiros, você poderá incluir as seguintes linhas no modelo do ficheiro de código:

      /**
       * \file $MODULE$.cpp
       * \brief (ponha uma descrição breve aqui).
       **/

  Sempre que você criar um novo ficheiro de código, o &kdevelop; irá substituir a variável `$MODULE$` pelo nome do ficheiro criado como novo. Por exemplo, se você criou uma nova classe de C++ chamada `TesteSimples`, você irá ver as seguintes linhas no ficheiro `testesimples.cpp`:

      /**
       * \file testesimples.cpp
       * \brief (ponha uma descrição breve aqui).
       **/

  Você terá à mesma de fornecer a breve descrição a seguir à palavra-chave \brief, mas parte do trabalho é automaticamente feita para si.

O Ficheiro de Texto da Licença

  Como outro exemplo, você poderia incluir uma referência explícita para o texto da licença que deseja usar no modelo. Use a variável `$LICENSEFILE$` para esse fim e adicione, por exemplo, esta linha:

      //   Veja o $LICENSEFILE$ para o texto completo da licença.

  O &appwizard; irá substituir o `$LICENSEFILE$` pela localização do ficheiro com o texto completo da licença, nomeadamente:

      //   Veja o COPYING para o texto completo da licença.

  para a licença GPL ou

      //   Veja o LICENSE.BSD para o texto completo da licença.

  se optou por colocar a sua aplicação segundo os termos da licença BSD.

  Existem obviamente mais variáveis que o &kdevelop; conhece. Veja a secção sobre como Editar os modelos no capítulo Ferramentas de edição para saber o que é possível.

Os modelos que definir aqui ficarão em efeito só após o &appwizard; ter criado o projecto novo. Você irá encontrar esta informação no topo dos ficheiros que você criou durante o processo de desenvolvimento. Ao criar os ficheiros iniciais, o &appwizard; irá usar alguns modelos-padrão predefinidos. Você terá de adaptar manualmente estes ficheiros iniciais de acordo com as suas necessidades.

### Criar os Ficheiros Iniciais do Projecto

Está quase tudo feito, por agora. Na última página de modelos, o botão Próximo > terá mudado para aparecer então Terminar.

Pense duas vezes antes de carregar nele! Você terá à mesma a opção de rever tudo se carregar repetidamente no botão < Anterior. Dado que o &appwizard; recorda todas as informações que você introduziu até agora, é aconselhável que você ocupe algum tempo a rever tudo de novo. No caso de você usar o &CVS; local, não se esqueça de verificar com atenção o nome do repositório de &CVS; (não deverá existir nenhuma subdirectoria com esse nome na directoria da raiz do &CVS; — se existir, tente outro nome de repositório).

Se em alguma altura não desejar que o novo projecto, seja criado, interrompa a janela do Criar um Novo Projecto com o botão Cancelar. Caso contrário, carregue em Terminar e veja na janela Mensagens como é que o &appwizard; inicia o projecto.

Se você quiser usar um sistema de controlo de versões (&CVS;), irão existir dois passos, de facto. O &appwizard; irá primeiro criar as directorias e ficheiros do projecto e então depois invocará o programa &CVS; que irá reiniciar a janela de Mensagens com o seu próprio conteúdo. Se ocorrer algum erro durante uma dessas execuções, o processo irá terminar, mostrando-lhe uma mensagem de erro correspondente na janela.

Em muitos casos em que o seu projecto foi configurado desta forma, o &kdevelop; irá automaticamente carregar os ficheiros de código de um ou mais módulos importantes para que você possa começar logo a trabalhar. (Os módulos de código que serão mostrados—se existir algum que seja—contudo, depende do modelo seleccionado inicialmente no &appwizard;.)

Não se esqueça de verificar inicialmente o que é que o &appwizard; forneceu. Por exemplo, você poderá querer alterar as informações iniciais dos cabeçalhos, de acordo com os seus próprios modelos. Normalmente, você irá encontrar estes numa subdirectoria `templates` da directoria do seu projecto. À partida, somente algumas cópias simples serão suficientes.

Aí, é aconselhável que você compile o projecto inicial antes de tentar alterar qualquer código que seja. Na maioria dos casos, esta compilação inicial será possível à partida. Como tal, você poderá começar logo a preparar o projecto para ser alterado de acordo com a sua vontade. Se não foi possível, basta remover a directoria do projecto (e da sua raiz local do &CVS; se usar alguma) e recomeçar do princípio.

Antes de você compilar o seu novo projecto da primeira vez, dê uma vista de olhos no Projecto Configuração da Construção. Devem existir três selecções mostradas: default, optimized e debug, com a debug seleccionada; use se possível esta, ou então use a optimized em alternativa.

Devido a algumas limitações na configuração actual do autoconf/automake, você não deverá de forma alguma compilar com a configuração default. Esta irá corromper algumas configurações de directorias internas, fazendo com que o `configure` se queixe quando o tentar usar nas configurações optimized ou debug, a seguir.

(Isto aplica-se apenas às capacidades com várias opções. Se o tipo de aplicação que você seleccionou só contém uma configuração default, você deverá obviamente usar esta.)