Suporte / Configuração do Eclipse

Este tutorial ensina como configurar o Eclipse (versao 3.0M7) para ser usado como ferramenta de depuração, desenvolvimento, com suporte a programação em Time usando um CVS. Exemplificaremos usando o projeto ACME. Faça o download dos arquivos do projeto ACME aqui, e extraia (recriando os diretórios) para \acme_project.

Notas:

• As explicações sempre aparecem antes da figura correpondente.
• Para diminuir o tamanho dos arquivos, diminuímos a quantidade de cores das figuras, ocasionando algumas variações de tons entre as telas.

1. Inicialize o Eclipse. Uma figura como a abaixo aparecerá
   
   
    

2. Clique File / New / Project
   
   
    

3. Selecione Java / Java Project. Clique Next.
   
   
    

4. Em Project name, digite ACME. Desmarque Create project in workspace e selecione o diretório para o projeto (no nosso caso, é o diretório \acme_project). Clique no botão Next
   
   
    

5. Aparecerá uma figura como a abaixo:
   
   
    

6. Precisamos agora adicionar o SuperWaba.jar, que contém os .class e os .java de toda a biblioteca do SuperWaba. Para isso, clique na aba Libraries, e em seguida, no botão Add External JARs.
   
   
    

7. Selecione o arquivo /SuperWabaSDK/lib/SuperWaba.jar
   
   
    

8. Clique no sinal de + para abrir a árvore de opções para o SuperWaba.jar. Clique em Javadoc location e no botão Edit....
   
   
    

9. Certifique-se que Javadoc URL está selecionado e clique no botão Browse
   
   
    

10. Selecione o diretório /SuperWabaSDK/docs/html e clique Ok
    
    
     

11. Selecione a opção Source attachment e clique no botão Edit
    
    
     

12. Na tela seguinte, clique no botão External Folder
    
    
     

13. Selecione o diretório java
    
    
     

14. Clique Finish. Ele vai perguntar se deseja recompilar o projeto; selecione Yes.
    
    
     

15. Após este processo inicial, aparecerá uma tela. Expanda o pacote acme.coyote, clicando no sinal de +, e dê um clique-duplo em cada um dos arquivos (Eat, Fall, etc), e a tela ficará parecida com a abaixo.
    
    
     

16. Agora vamos configurar o CVS, para acessar o repositório no servidor do SuperWaba. (Nota: se não for subscrito à versão Profissional e não quizer configurar o CVS, pule para o passo 26). Caso o Package Explorer não esteja aparecendo, clique no menu Window / Show View / Package Explorer. Nesta janela, clique com o botão direito do mouse em ACME para abrir o menu popup, e selecione Team / Share Project....
    
    
     

17. Certifique-se que Create a new repository location está selecionado e clique no botão Next
    
    
     

18. Agora entre com os dados abaixo (ao adquirir um plano, os dados correspondentes à sua empresa serão enviados por e-mail):
    • Host: gforge.superwaba.net
    • Repository path: /cvsroot/spacme
    • User: acme
    • Password: segredo!
    • Connection type: extssh
    Clique no botão Next. Nota: você não poderá testar isso por este tutorial porque a senha não é verdadeira. Quando for compartilhar um projeto real, você poderá obter as informações da sua empresa fazendo o login no site, e clicando no link "Exibir instrucoes para uso do CVS e do sistema de suporte" na página de download do SDK.
    
    
     

19. Clique em Use specified module name e digite spacme. Clique no botão Finish
    
    
     

20. Selecione a perspectiva Team Synchronizing (4o botão na barra vertical de ferramentas). Caso ela não esteja disponível, clique em Window / Open Perspective / Other / Team Synchronizing. Nesta perspectiva são exibidos apenas os ítens do projeto que estão fora de sincronismo com o repositório. Como o repositório está vazio, deve-se Gravar (commit) os arquivos (a setinha azul com sinal de + indica que o arquivo é novo e deve ser gravado). Nota: a não ser que se tenha certeza que o projeto é novo, deve-se sempre fazer um Refresh com o repositório antes de se gravar os arquivos, pois caso contrario, você poderá sobrescrever alterações feitas por outras pessoas.
    
    
     

21. Para fazer o commit, clique com o botão direito do mouse em ACME para abrir o menu popup, e selecione Commit...
    
    
     

22. Em seguida, são listados todos os arquivos modificados. Clique em Yes
    
    
     

23. Escreva agora um comentário descritivo sobre essa gravação. Isso poderá ser lido por todos que acessarem o projeto. Seja o mais descritivo o possível (nesse primeiro caso, não há muito o que escrever). Clique no botão Ok.
    
    
     

24. Ao retornar à tela do Team Synchronizing, repare que nenhum arquivo é exibido, pois não existem mais diferenças entre o repositório e seu micro local. Só para ter certeza, clique no botão Incoming/Outgoing mode (8o botão na janelinha de Synchronize View), e clique em seguida o 2o botão, Refresh with remote. Nenhum arquivo será exibido, como já era de se esperar. Nota: este repositório é privado, e somente você e a equipe SuperWaba tem acesso a ele.
    
    
     

25. Voltemos agora à perspectiva Java (3o botão da barra vertical). Repare que ao lado de ACME no Package Explorer, aparece o nome do repositório associado, e ao lado de cada arquivo, aparece a versão. Pode-se clicar no arquivo com o botão direito e selecionar Compare with para verificar modificações entre versões. Terminamos, assim, de configurar o repositório.
    
    
     

26. Vamos agora terminar de configurar o Eclipse. Clique com o botão direito do mouse em ACME, e selecione Properties.
    
    
     

27. O SuperWaba não suporta o novo formato de .class surgido a partir do JDK 1.3. Logo, temos que especificar ao Eclipse que ele gere .class no formato 1.1. Para isso, na tela de Properties, selecione Java Compiler.
    
    
     

28. Marque Use project specific settings.
    
    
     

29. Na combobox Compiler compliance level mude para 1.3. Clique Ok.
    
    
     

30. Clique Yes na janela a seguir.
    
    
     

31. Vamos agora configurar o Eclipse para executar nossa aplicação. O botão executar (Run) é o homem que corre, exibido na figura abaixo. O botão depurar (debug) se encontra ao lado esquerdo deste: a joaninha. Clique na setinha à direita do botão Run.
    
    
     

32. Aparecerá o menu popup abaixo. Clique em Run...
    
    
     

33. Na janela a seguir, clique no botão New.
    
    
     

34. Em Name, digite ACME. Em Main class digite waba.applet.Applet. Esta é a classe do SuperWaba que emula o PDA sob o JDK e deve ser sempre a escolhida.
    
    
     

35. Clique na aba Arguments e digite a seguinte linha de comando em Program arguments: /w 320 /h 320 /bpp 8 /scale 1 acme.coyote.Live. Os primeiros parâmetros especificam o que estamos emulando (no caso, um PDA da Palm de alta resolução como o Tungsten T, por exemplo), e acme.coyote.Live é o nome de nossa classe principal (que extende waba.ui.MainWindow). Para saber quais parâmetros passar, verifique o manual SuperWaba Companion.pdf.
    
    
     

36. Agora, clique no botão Run. Deverá aparecer a figura abaixo. Caso não apareça, revise os passos anteriores.
    
    
     

37. Pronto, já temos nossa aplicação sendo executada. Vamos agora matar o processo dessa aplicação. Na tela de Console, clique no botão Terminate. A janela de execução do aplicativo será fechada
    
    
     

38. Agora, para limpar a lista de processos, clique no botão Remove All Terminated Launches. A lista será limpa. Caso se queira depurar ao invés de executar (depurar permite que se acompanhe o programa passo a passo), basta marcar os locais de parada (breakpoints) dando um clique duplo na barra que aparece à esquerda da linha no código fonte (aparecerá um círculo vermelho), e clicar no botão de debug (o da joaninha). As configurações do projeto de depuração foram copiados da configuração Run. Caso não seja o programa ACME o que é executado, clique na seta à direita da joaninha e selecione o projeto ACME.
    
    
     

39. Ótimo, já temos nosso projeto sendo executado no desktop. Agora precisamos apenas gerar os arquivos a serem exportados para o PDA, usando para isso o Warp e o Exegen (consulte o SuperWaba Companion.pdf caso não saiba o que é isso). Para isso utilizaremos o ANT (vide http://ant.apache.org), que é uma espécie de .bat multiplataforma. Existe um script no acme.zip e iremos usa-lo.
    
     

40. Verifique se a janela do Ant aparece no Eclipse. Caso não apareça, selecione Window / Show view / Ant. Clique agora no botão Add Buildfiles
    
    
     

41. Selecione o único build.xml que está disponível e clique no botão Ok.
    
    
     

42. Clique agora no sinal de + ao lado de ACME [run-warp]. Aparecerão todos os alvos (targets) contidos neste script. Para não exibir os targets privados, clique no botão Hide internal targets. Repare que existem 3 targets públicos: um que executa o Warp, outro para o Exegen, e um terceiro para ambos. Na maioria dos casos, o Exegen só precisa ser executado uma vez (a exceção é quando se cria arquivos cab para instalacao nos PDAs Windows CE, ou quando se muda algum ícone, versão do programa ou título). Já o Warp deve ser executado sempre que algum arquivo fonte é alterado.
    
    
     

43. Dê um clique-duplo em run-exegen. A saída será exibida na tela do console.
    
    
     

44. Dê um clique-duplo em run-warp. Caso queira apenas executar o warp, pode-se também clicar no botão Run the Default Target of the Selected Buildfile. Pronto, os arquivos Live.pdb e Live.prc estão gerados. Agora basta importa-los para o PDA ou para o Emulador (para saber como proceder, verifique no SuperWaba Companion.pdf e também o Wiki no site do SuperWaba).
    
    
     

45. Caso tenha configurado o CVS, precisamos agora gravar o build.xml no repositório. Mude para a perspectiva Team Synchronizing. Veja que o build.xml está com a seta azul+. Clique no botão Refresh with remote.
    
    
     

46. Clique Yes na tela seguinte.
    
    
     

47. Digite um comentário descritivo e clique no botão Ok.