Trabalhando com o rastreamento de problemas no NetBeans IDE
No NetBeans IDE, você pode trabalhar com rastreadores de problema e realizar tarefas comuns tais como pesquisar e atualizar problemas e relatar novos problemas. Se o seu projeto estiver sob controle de versão, você pode atualizar os problemas como parte do processo de envio. Neste tutorial o IDE será usado para abrir um exemplo de projeto de um repositório com controle de versão. Após abrir o projeto, você aprenderá como visualizar os problemas do projeto, relatar um novo problema, aplicar um arquivo de patch anexado a um problema e solucionar um problema quando envia as alterações. Esse tutorial demonstrará como registrar e usar um rastreador de problemas externo no IDE.
Assista o Vídeo sobre o uso do rastreamento de problemas integrado no NetBeans IDE.
Conteúdo
Para seguir este tutorial, você precisa dos seguintes recursos e softwares.
Observação.Este tutorial requer o controle de versão Subversion. Para obter mais detalhes sobre o uso do Subversion no IDE, consulte a seção sobre configuração do Subversion no Tour guiado do Subversion.
Abrindo o exemplo de projeto
Para fins de demonstração, este tutorial usa o projeto de amostra Anagram Game para demonstrar como trabalhar com um rastreador de problemas no IDE. Os códigos-fonte do exemplo de projeto Anagram Game existem como um projeto do NetBeans em um repositório do Subversion e há um problema Bugzilla para o projeto. As tarefas demonstradas neste tutorial podem ser usadas com qualquer rastreador de problemas (Bugzilla, JIRA) e sistemas de controle de versão (Subversion, Mercurial) suportados.
Caso conheça a localização do repositório do projeto, é possível usar o assistente Retirar para retirar os códigos-fonte diretamente do repositório. Realize as etapas a seguir para retirar os códigos-fonte do projeto diretamente usando o assistente Retirar.
- Selecione Equipe > Subversion > Retirar, para abrir o assistente Retirar.
- Digite https://svn.kenai.com/svn/anagram-game~subversion para o URL do repositório. Clique em Próximo.
- No assistente, clique em Procurar para especificar Pasta do repositório e selecione AnagramGame. Clique em OK.
- Especifique o local da pasta local para repositório local.
- Clique em Terminar.
Ao clicar em Terminar, o IDE inicializa a pasta local como um repositório Subversão e verifica os códigos fonte do projeto.
- Clique em Abrir projeto na caixa de diálogo que aparece quando a retirada estiver completada.
Após clicar em Abrir projeto, o projeto é aberto como um projeto NetBeans na janela Projetos.
Observação. Este tutorial demonstra como trabalhar com traços da pilha e aplicar um patch que está anexado como um problema. Para realizar essas tarefas será necessário retirar os códigos-fonte do projeto.
Registrando um rastreador de problemas
O IDE permite registrar qualquer quantidade de rastreadores de problemas suportados. Após registrar o rastreador, o nome do rastreador é adicionado à lista suspensa Rastreador de problemas nas caixas de diálogo de envios e formulários do problema, permitindo a visualização atualização e criação de problemas a partido do IDE. É possível registras um rastreador de problemas Bugzilla ou JIRA existente, com o IDE na janela Serviços.
Observação Para usar um rastreador de problemas, você deve fazer o download dos plug-ins de suporte ao JIRA na Central de Atualizações. Para obter mais informações, consulte a pergunta frequente sobre NetBeans Como obtenho e instalo o plug-in JIRA NetBeans?
Execute os passos a seguir para registrar um rastreador de problemas do projeto Anagram Game.
- Clique com o botão direito do mouse no nó Rastreadores de problemas na janela Serviços e escolha Criar rastreador de problemas.
- Selecione o Conector do rastreador de problemas.
(O Anagram Game usa um rastreador Bugzilla).
- Digite AnagramGame para o rastreador de problemas.
O nome é usado para identificar o rastreador de problemas nas janelas e caixas de diálogo do IDE.
- Especifique o URL do rastreador de problemas.
(O URL do rastreador de problemas do Anagram Game é http://kenai.com/bugzilla/)
- Clique em Validar para testar a conexão do rastreador de problemas. Clique em OK.
Quando você clica em OK, o IDE adiciona um nó para o novo rastreador de problemas no nó Rastreadores de problemas na janela Serviços.
Depois de adicionar o rastreador de problemas, você pode clicar com o botão direito do mouse no rastreador para realizar as seguintes tarefas.
- Localizar problemas existentes
- Reportar um novo problema
- Editar os detalhes do rastreador de problemas
- Remover o rastreador de problemas da lista
Você também pode localizar e reportar problemas selecionando a tarefa no menu Equipe.
Encontrando e visualizando problemas
Nesta seção, você usará a janela Pesquisar problemas no IDE para recuperar uma lista de problemas em aberto do projeto Anagram Game. O rastreador de problemas associado com o projeto Anagram Game contém alguns exemplos de problemas. Você também pode abrir a janela Pesquisar problemas selecionando a tarefa no menu Equipe.
Pesquisar por problemas e salvar consultas de pesquisas
Neste exercício, você usará o formulário Pesquisar problemas para procurar todos os novos problemas de prioridade P1.
- Escolha Equipe > Localizar problemas no menu para abrir a janela Pesquisar problemas.
Como alternativa, clique com o botão direito do mouse no nó rastreador de problemas na janela Serviços e escolha Pesquisar problemas.
- Selecione Anagram Game na lista suspensa Rastreador de problemas.
- Selecione anagram-game da lista Produto.
- Especifique critérios de pesquisa ao selecionar Novo como Status e P1 como a Prioridade. Clique em Pesquisar.
Ao clicar em Pesquisar, o IDE pesquisa todos os problemas que correspondem ao critério e exibe uma lista de resultados na parte inferior do formulário.
- Clique em Salvar essa consulta na parte inferior da guia Pesquisar problemas.
- Digite Problemas P1 novos como nome da consulta na caixa de diálogo Salvar consulta. Clique em Salvar.
Quando você clica em Salvar, o IDE abra a guia Consulta que exibe os resultados da consulta.
Após salvar a consulta, é possível executar a consulta novamente a qualquer momentos a partir da guia Pesquisar problemas ao clicar no nome exibido próximo à Minhas consultas. Clique duas vezes no problema na lista para abri-lo em uma nova janela.
Na aba Consulta, você pode adotar o procedimento seguinte para modificar a lista de problemas.
- Clique no cabeçalho de uma coluna selecionar a ordem na qual os problemas serão listados
- Filtre os resultados exibidos usando a lista suspensa Filtro
- Recupere a lista mais recente de problemas clicando em Atualizar
Clique em Modificar consulta na aba Consulta para modificar os critérios da pesquisa salva.
Visualizando e atualizando um problema
Neste exercício, você verá e, em seguida, modificará os detalhes de um dos problemas do projeto Anagram Game.
Também pode ver e atualizar um problema dentro do IDE clicando duas vezes em tal problema na lista de resultados de pesquisa. Não é necessário ser membro de um projeto ou ter efetuado logon para ver o problema, mas se quiser atualizar o problema para solucioná-lo, adicionar comentários, alterar a prioridade, etc., você deve estar registrado com o rastreador de problemas do projeto e deve efetuar logon.
Quando for adicionado como um membro do projeto Kenai, você é registrado automaticamente com o rastreador de problemas do projeto e pode modificar os problemas e enviar novos problemas.
- Abra a lista de problemas do projeto.
- Clique duas vezes no problema n° 257 Erro tipográfico em StaticWordLibrary para ver os detalhes do problema na janela principal.
- Faça quaisquer alterações nos detalhes do problema e adicione um comentário. Clique em Enviar alterações.
Ao clicar em Enviar alterações, o IDE se conecta ao rastreador de problemas para atualizar os detalhes do problema. É enviado um e-mail à pessoa que está fazendo as alterações, ao licenciado e a quaisquer endereços de copiados no problema.
Observação. Neste tutorial, você não poderá enviar as alterações para este problema porque não é um membro do projeto Anagram Game.
Reportando um novo problema
Esta seção mostra como enviar um novo problema do projeto Anagram Game a partir do IDE.
Você pode usar o formulário Reportar um novo problema do IDE para enviar um novo problema a um rastreador de problemas registrado. Você pode abrir o formulário escolhendo Equipe > Reportar um problema no menu principal e, em seguida, escolhendo o rastreador de problemas na lista suspensa do formulário.
Observação. Para reportar um problema, você deve estar registrado com o rastreador de problemas e deve ter efetuado logon. Se não tiver efetuado logon, você será solicitado a efetuar logon ao enviar um problema.
Para reportar um novo problema do projeto Anagram Game, realize as etapas seguintes.
- Escolha Equipe > Reportar um problema no menu principal para abrir a janela Reportar um novo problema.
- Selecione o rastreador na lista suspensa Rastreador de problemas.
- Selecione o projeto do Produto na lista suspensa.
- Especifique os detalhes, o resumo e a descrição do problema. Clique em Enviar problema.
Quando você clica em Enviar problema, o IDE envia o problema para o rastreador.
Observação. Neste exemplo, você não poderá enviar o problema porque não é membros do projeto.
Trabalhando com rastreamentos de pilha
Quando a descrição de um problema contém um rastreamento de pilha que faz referência ao código-fonte de um projeto, você pode ir diretamente do problema para a linha do código-fonte local. O rastreamento de pilha copiado no problema pode ser usado da mesma forma que um rastreamento de pilha da janela Saída.
Observação. Para ir para as linhas no código-fonte a partir de um rastreamento de pilha, deve-se fazer check-out dos códigos-fonte do projeto e o projeto deve ser aberto no IDE.
- Abra o problema 1446 Não é possível iniciar o AnagramGame devido a NullPointerException.
O problema 1446 do projeto Anagram Game afirma que um NullPointerException é lançado quando o aplicativo é executado.
- Na descrição do problema, clique na linha seguinte do rastreamento de pilha.
com.toy.anagrams.ui.Anagrams$2.windowOpened(Anagrams.java:72)
A descrição do problema contém uma cópia do rastreamento de pilha que foi copiado da janela Saída.
Quando você clica na linha no rastreamento de pilha, o IDE abre o arquivo local no editor e coloca o cursor na linha indicada no código-fonte.
Observação. O IDE pode abrir o arquivo local porque os códigos-fonte foram retirados anteriormente nesse tutorial.
Você pode reproduzir a exceção iniciando o aplicativo Anagram Game e, em seguida, visualizando a saída na janela Saída. Na janela Saída, você deve ver uma saída semelhante à seguinte.
Abrindo e aplicando um arquivo de patch
Nesta seção, você verá um arquivo de patch anexado e, em seguida, aplicará o patch.
O problema 1446 reporta que ocorre um NullPointerException quando o aplicativo Anagram Game é executado. Um arquivo de patch, que contém a correção do NullPointerException, é anexado ao problema. Quando um arquivo de patch estiver anexado a um problema, é possível abrir e aplicar o patch diretamente a partir da janela do problema.
- Abra o problema 1446 Não é possível iniciar o AnagramGame devido a NullPointerException.
- Clique no nome do arquivo de patch que está anexado ao problema.
Quando você clica no nome do arquivo, o IDE abre o arquivo no editor. Você pode observar que o patch faz as seguintes alterações em StaticWordLibrary.java.
- static WordLibrary DEFAULT;
+ final static WordLibrary DEFAULT = new StaticWordLibrary();
Feche o arquivo de patch.
- Na janela do problema, clique em aplicar ao lado do nome do arquivo de patch anexado para abrir a caixa de diálogo Aplicar patch.
- Expanda o projeto Anagram Game e selecione o diretório Pacotes de código-fonte na caixa de diálogo Aplicar patch. Clique em Aplicar.
Observação. Ao aplicar um patch, é necessário selecionar o diretório ou o arquivo de acordo com a localização da raiz no momento em que o patch foi criado. Neste caso, você precisa especificar o diretório Pacotes de código-fonte como a localização da raiz ao aplicar o patch.
Quando você clica em Aplicar, o IDE aplica o patch e modifica StaticWordLibrary.java. Você pode abrir o arquivo no editor para ver as alterações. Se observar a janela Projetos, poderá ver que o IDE marca o arquivo como modificado.
Integração com o controle de versão
Nesta seção, você atualiza um problema como parte do processo de envio de alterações nos códigos-fonte do projeto Anagram Game.
O IDE integra suporte ao controle de versão de código-fonte (usando Subversion ou Mercurial) e os rastreadores de problemas suportados. O suporte integrado permite atualizar os problemas em um rastreador de problemas registrado como parte do processo de envio.
O Kenai oferece repositórios de controle de versão dedicados como um dos serviços disponíveis para projetos hospedados. Quando você abriu o projeto Anagram Game do Kenai e fez o check-out dos códigos-fonte do projeto, o IDE associou automaticamente o projeto a um rastreador de problemas do projeto.
Para obter detalhes sobre como usar o Subversion no NetBeans IDE, consulte Tour guiado do Subversion.
Para obter mais informações sobre o suporte Kenai para sistemas de controle de versão, consulte a documentação do Kenai em Gerenciamento de código-fonte.
Este exercício demonstra como atualizar um problema como parte do processo de envio.
- Expanda o pacote com.toy.anagrams.lib do nó Pacotes de código-fonte na janela Projetos.
O Anagram Game já está em um repositório com controle de versão. Os nomes dos arquivos de código-fonte modificados que precisam ser enviados ao repositório estão em azul. A identificação nos diretórios indicam que eles contêm arquivos que precisam ser enviados.
- Clique com o botão direito do mouse no arquivo StaticWordLibrary.java e escolha Subversion > Submeter para abrir a caixa de diálogo Submeter.
- Insira uma mensagem que descreva o envio.
- Expanda o painel Atualizar problema na caixa de diálogo Submeter.
- Selecione o rastreador de problemas do projeto Anagram Game da lista suspensa (se não estiver selecionado).
- Digite 1446 no campo Problema.
As alterações em StaticWordLibrary.java que você está enviando corrigirão a exceção reportada no problema 1446.
Você pode digitar o ID do problema (1446) ou algum texto contido na descrição do problema (NullPointerException) no campo Problema. O IDE exibirá uma lista de problemas que correspondam ao texto.
- Selecione a caixa de verificação Resolver como CORRIGIDO.
Ao selecionar Resolver como CORRIGIDO, o status do problema será alterado para Resolvido.
- (Opcional) Selecione Adicionar detalhes para enviar mensagem ou problema para adicionar mais detalhes. É possível clicar em modificar para abrir uma caixa de diálogo que permite a modificação de como os detalhes adicionais são formatados.
- Clique em Confirmar.
Quando você clica em Submeter, o IDE envia as alterações ao repositório e atualiza o problema. Você será solicitado a fornecer um nome de usuário e uma senha se não tiver efetuado logon.
Observação. Neste exemplo, você não poderá enviar as alterações porque não é membros do projeto.
Este tutorial descreveu como você pode usar o IDE para trabalhar com rastreadores de problemas. O suporte integrado a rastreadores de problemas Bugzilla e JIRA permite visualizar, atualizar e reportar problemas a partir do IDE. Em projetos hospedados no Servidor de equipe e associados a um rastreador de problemas que também está hospedado no Servidor de equipe, é possível trabalhar com os problemas do projeto no painel Equipe.
Em outros projetos, é possível registrar os rastreadores de problemas Bugzilla ou JIRA com o IDE e, a seguir, usar os itens do menu Equipe para visualizar e reportar problemas.
Consulte também
Para obter mais informações sobre o uso do NetBeans IDE em um ambiente colaborativo, consulte os seguintes tutoriais:
