# Guia de Início Rápido

Este tutorial introduz o Workbench, fornecendo uma breve visão geral das etapas requeridas para criar aplicativos simples. Explicações mais abrangentes, incluindo imagens, estão disponíveis no Guia do Usuário do Workbench.

Início Rápido do Workbench

Tarefa | Descrição

Criar um Projeto Simples

1. Selecione Arquivo > Novo > Projeto....
2. No assistente Novo Projeto, selecione Simples > Projeto e, em seguida, clique em Avançar.
3. No campo Nome do Projeto digite um nome para o novo projeto.

4. Especifique um local para o projeto ou utilize o padrão.

5. Clique em Concluir.

Criar uma Pasta

1. Verifique se existem um ou mais projetos.
2. Selecione Arquivo > Novo > Pasta.
3. No campo Nome da Pasta do assistente Nova Pasta, digite um nome para a nova pasta.
4. Clique em Concluir.

Criar um Arquivo

1. Verifique se existem um ou mais projetos.
2. Selecione Arquivo > Novo > Arquivo.
3. No campo Nome do Arquivo do assistente Nova Pasta, digite um nome para a nova pasta.
4. Clique em Concluir.

Importar Recursos

1. Selecione Arquivo > Importar.
2. Selecione uma origem de importação.
3. Clique em Avançar.
4. Selecione o local de importação que contém o recurso, seguindo as etapas indicadas no assistente aplicável.
5. Clique em Concluir.

Exportar Recursos

1. Selecione Arquivo > Exportar.
2. Selecione um destino de exportação.
3. Clique em Avançar.
4. Selecione o destino de exportação, seguindo as etapas indicadas no assistente aplicável.
5. Clique em Concluir.

Criar um Projeto Java: exemplo do JUnit

1. Para fazer o download do código fonte JUnit, visite o site http://www.eclipse.org/downloads/ e localize o release do Eclipse com o qual você está trabalhando.
2. Role até a seção Plug-ins de Exemplo e faça download do archive de exemplos.
3. Extraia o conteúdo do arquivo Zip para um diretório.
4. Retorne ao Eclipse e selecione Arquivo > Novo > Projeto....
5. Selecione Projeto Java e clique em Avançar.
6. No campo Nome do Projeto digite JUnit.
7. Clique em Concluir.
8. No Package Explorer, certifique-se de que o projeto JUnit esteja selecionado.
9. Selecione o item de menu Arquivo > Importar....
10. Selecione o arquivo Zip e clique em Avançar.
11. Clique em Procurar próximo ao campo do arquivo Zip e navegue para selecionar <Exemplos_de_Caminho_de_Download>eclipse/plugins/org.eclipse.jdt.ui.examples.projects_3.0.0/archive/junit/junit381src.jar.

12. No assistente para Importação, abaixo da lista da hierarquia, clique em Selecionar Tudo.

13. Quando o projeto JUnit aparecer no campo de destino Pasta clique em Concluir.

14. No indicador de progresso da importação, observe que os recursos importados são compilados à medida que são importados para o workbench. Isso é porque a opção Construir Automaticamente está marcada na página de preferências do Workbench. Será necessário sobrescrever os arquivos .classpath e .project no projeto JUnit. Isto porque o recurso .classpath foi criado para você quando você criou o projeto JUnit. É seguro sobrescrever esses arquivos.
    Na exibição Package Explorer, expanda o projeto JUnit para exibir os pacotes JUnit.

Criar uma Classe Java: Exemplo do JUnit

1. Na visualização Explorador de Pacotes, clique com o botão direito do mouse no projeto JUnit, selecione Novo > Pacote.
2. No campoNome, digitetest como o nome do novo pacote.
3. Clique em Concluir.
4. Na visualização Explorador de Pacotes, selecione o novo pacote de teste e clique em Nova Classe Java na barra de ferramentas. Verifique se JUnit aparece no campo Pasta de Origem e se Testar aparece no campo Pacote.
5. No campo Nome, digite MyTestCase.
6. Próximo ao campo Superclasse, clique em Procurar.
7. No campoEscolher um tipo no diálogo Seleção de Superclasse, digiteTest para restringir a lista de superclasses disponíveis.
8. Selecione a classeTestCase e clique emOK.
9. Selecione a caixa de opções paraConstrutores da superclasse.
10. Clique em Concluir.
11. O arquivo novo é aberto no editor. Na visualização Outline, selecione a nova classeMyTestCase. Abra o menu de contexto e selecioneOrigem > Substituir/Implementar Métodos....
12. No diálogo Substituir Métodos, selecione setUp() e tearDown() e clique em OK.
13. Altere o corpo de setUp() para o contêiner= new Vector();.
14. contêiner e Vetor são sublinhados com uma linha de realce de problema uma vez que não podem ser resolvidos. Aparece uma lâmpada elétrica na barra do marcador. Posicione o cursor dentro do Vetor e pressione Ctrl+1 (ou utilize Editar > Correção Rápida na barra de menus). Escolha Importar 'Vetor' (java.util). Isso incluirá a declaração de importação ausente.
15. Posicione o cursor dentro do contêiner e pressione Ctrl+1. Escolha Criar Campo 'Contêiner' para incluir o novo campo.
16. Na visualização Outline, selecione a classe MyTestCase. Abra o menu de contexto e selecione Origem > Gerar Getter e Setter....
17. O diálogo Gerar Getter e Setter sugere a criação dos métodos getContainer e setContainer. Selecione ambos e clique em OK. São adicionados métodos getter e setter ao contêiner de campo.
18. Salve o arquivo.
19. A formatação do código gerado pode ser configurada em Janela > Preferências > Java > Estilo de Código > Formatador de Código. Se você utilizar um prefixo ou sufixo para nomes de campos, poderá especificar isso em Janela > Preferências > Java > Estilo do Código > Campos para que os getters e setters gerados sugiram nomes de métodos sem o prefixo ou sufixo.

Ativar um Programa Java: Exemplo de JUnit

1. Na visualização Explorador de Pacotes, localize junit.textui.TestRunner.java e dê um clique duplo para abri-lo em um editor.
2. Na visualização de Tópicos, observe que a classe TestRunner possui um ícone que indica que a classe define um método principal.
3. Clique com o botão direito do mouse em TestRunner.java no Explorador de Pacotes e selecione Executar > Aplicativo Java.
4. Selecione Executar > Executar.... O diálogo Configurações de Ativação é aberto com a configuração de ativação TestRunner selecionada.
5. No diálogo Configurações de Ativação selecione a guia Argumentos e digite junit.samples.VectorTest na área de argumentos Programa.
6. Clique em Executar. Neste momento, o programa é executado corretamente, indicando o número de testes que foram executados.
7. Vá para a perspectiva Depurar. Na visualização Depuração, observe que um processo para a ativação do último programa foi registrado quando o programa estava em execução.
8. Clique em Executar na barra de ferramentas do workbench. Esta lista contém os programas lançados anteriormente. Estes programas podem ser ativados novamente selecionando-os na lista de históricos.
9. No menu de contexto da visualização Depurar (ou o botão equivalente da barra de ferramentas), selecione Remover Todos Finalizados para limpar a visualização de processos de ativações finalizados.

Crie um

Plug-in

1. Selecione Arquivo > Novo > Projeto.
2. Selecione Projeto de Plug-in e clique em Avançar.
3. No campo Nome do projeto, digite um nome para o projeto e clique em Avançar.
4. Na página Conteúdo de Plug-in, configure os dados com os quais o arquivo plugin.xml será inicializado, incluindo o ID do plug-in, a versão e o nome.
5. Selecione um gabarito disponível e clique em Avançar.
6. Customize a extensão de amostra e clique em Concluir.

Ativar uma instância do workbench de tempo de execução do Eclipse para testar um plug-in

1. Selecione Executar > Executar....
2. No diálogo de Configuração de Ativação, digite um nome para a configuração no campo Nome.
3. No campo Dados do Espaço de Trabalho, clique em Procurar para definir o espaço de trabalho que será utilizado pelo workbench de tempo de execução. A localização do espaço de trabalho do tempo de execução deve ser diferente do espaço de trabalho da instância do host.
4. No campo Executar um Aplicativo selecione o aplicativo padrão do Eclipse org.eclipse.ui.ide.workbench.
5. Clique em Executar.

Uma segunda instância do workbench aparecerá, cujos plug-ins constituintes são os plug-ins do espaço de trabalho e os plug-ins selecionados na página de preferências Plataforma de Destino. É possível testar o workbench de tempo de execução utilizando o JRE de sua escolha e não tem que ser o mesmo em relação ao qual os plug-ins são compilados no espaço de trabalho. Também é possível especificar quaisquer argumentos VM apropriados para o teste.

Executando construções automaticamente

1. Selecione Window > Preferences.
2. Selecione a categoria Geral na área de janela à esquerda.
3. Selecione Construir Automaticamente.
4. Clique em OK.

Executando construções manualmente

1. Na visualização Navegador da perspectiva Recurso, selecione um ou mais projetos.
2. Clique o botão direito e selecione a opção Construir Projeto no menu pop-up.

Início Rápido do CVS

Nota: Um servidor CVS já deve estar configurado na máquina host para criar um local do repositório válido no Workbench.

Tarefa | Descrição

Criando um local de repositório do CVS

1. Selecione Janela > Mostrar Visualização > Outros...
2. Selecione CVS > CVS Repositórios.
3. Clique em Incluir Repositório CVS.
4. Digite as informações requeridas para identificar e conectar-se com o local do repositório.
5. Clique em Concluir.

Conectando e Configurando o CVS com SSH

1. Selecione Window > Preferences.
2. Selecione Equipe > CVS > Método de Conexão SSH2.
3. Selecione a guia Geral, clique em Incluir Chave Privada e inclua a chave privada na lista.
4. Forneça uma senha para a chave privada e salve-a no seu computador.

Se você não tiver um par de teclas:

1. Selecione Window > Preferences.
2. Selecione Equipe > CVS > Método de Conexão SSH2.
3. Selecione a guia Gerenciamento de Chaves.
4. Se o servidor suportar a versão 1 do protocolo, selecione Gerar Chave RSA, para a versão 2 selecione Gerar Chave DSA. Uma chave pública e uma privada serão geradas. A chave pública será mostrada na área de texto de leitura.
5. Copie a chave pública no servidor. Se o servidor estiver executando um servidor OpenSSH, clique em Exportar por Meio de sftp. Caso contrário, copie e cole a chave pública no seu arquivo remoto ~/.ssh/authorized_keys.

Registrando Saída de um Projeto de um Repositório do CVS

1. Alterne para a perspectiva Exploração de Repositório do CVS.
2. Na visualização Repositórios de CVS, expanda a localização do repositório.
3. Expanda o HEAD e selecione as pastas que deseja incluir como projetos no Workbench.
4. Selecione um dos seguintes no menu para as pastas selecionadas:
   - Registrar Saída para registrar saída de cada pasta selecionada como um projeto no espaço de trabalho local com o mesmo nome que a pasta no repositório.
   - Registrar Saída Como... para registrar saída das pastas selecionadas em um projeto personalizado configurado no espaço de trabalho local.

Sincronizando com o Repositório e Atualizando ou Consolidando Alterações

1. Na visualização Navegador, selecione os recursos que deseja sincronizar.
2. Clique com o botão direito do mouse e selecione Equipe > Sincronizar com o Repositório.
3. Na visualização Sincronizar, clique com o botão direito do mouse no recurso e selecione um dos seguintes:
   - Confirmação, se desejar substituir a versão CVS existente do recurso e salvar a versão no repositório.
   - Atualizar, se desejar atualizar o espaço de trabalho com a versão armazenada dentro do repositório.