| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" |
| "http://www.w3.org/TR/html4/loose.dtd"> |
| <html> |
| <head> |
| <meta http-equiv="content-type" content="text/html; charset=UTF-8"> |
| <meta name="author" content="troy.giunipero@sun.com"> |
| <meta name="description" content="A preview of ClearCase Features in NetBeans IDE 6.9 and more recent"> |
| |
| <meta name="keywords" content="NetBeans, IDE, integrated development environment, |
| ClearCase, IBM, versioning, open source, developers, collaborate"> |
| |
| <link rel="stylesheet" type="text/css" href="../../../netbeans.css"> |
| <link rel="stylesheet" type="text/css" href="../../../lytebox.css" media="screen"> |
| <script type="text/javascript" src="../../../images_www/js/lytebox-compressed.js"></script> |
| |
| <title>Usando o Suporte de ClearCase no NetBeans IDE</title> |
| </head> |
| |
| <body> |
| |
| <!-- |
| Copyright (c) 2009 - 2014 Oracle and/or its affiliates. All rights reserved. |
| --> |
| |
| <h1>Usando o Suporte de ClearCase no NetBeans IDE</h1> |
| |
| <p>O suporte a ClearCase do IDE é projetado para ajudá-lo a realizar tarefas de controle de versão diretamente em seu projeto ao trabalhar no IDE.</p> |
| |
| <p>Este documento guia você pelas etapas básicas envolvidas no uso do ClearCase no NetBeans IDE.</p> |
| |
| <p>O Rational ClearCase é um software de controle de versão desenvolvido pela IBM. O ClearCase forma a base do controle de versão para projetos de muitas empresas de grande e médio porte.</p> |
| |
| <p><strong>Conteúdo</strong></p> |
| <img alt="O conteúdo desta página se aplica ao NetBeans IDE 6.9 e mais recente" class="stamp" src="../../../images_www/articles/73/netbeans-stamp-80-74-73.png" title="O conteúdo desta página se aplica ao NetBeans IDE 6.9 e mais recente"> |
| |
| <ul class="toc"> |
| <li><a href="#settingUp">Configurando o ClearCase</a> |
| <ul> |
| <li><a href="#specifying">Especificando o Caminho para o </a>Executável da <tt>cleartool</tt></li> |
| </ul></li> |
| <li><a href="#starting">Começando a Trabalhar com Arquivos com Controle de Versão</a> |
| <ul> |
| <li><a href="#opening">Abrindo um Projeto Existente no IDE</a></li> |
| <li><a href="#addingSourceControl">Criando um Novo Projeto e Colocando-o no Controle de Código-fonte</a></li> |
| </ul></li> |
| <li><a href="#editing">Editando Códigos-fonte</a> |
| <ul> |
| <li><a href="#viewingChanges">Exibindo Alterações no Editor de Código-fonte</a></li> |
| <li><a href="#viewingFileStatus">Exibindo Informações de Status do Arquivo</a></li> |
| <li><a href="#comparing">Comparando Revisões de Arquivos</a></li> |
| </ul></li> |
| <li><a href="#checkingin">Fazendo Check-in de Códigos-fonte</a></li> |
| <li><a href="#seeAlso">Consulte Também</a></li> |
| </ul> |
| |
| <p><strong>Para concluir este tutorial, você precisa dos seguintes recursos e softwares.</strong></p> |
| |
| <table> |
| <tbody> |
| <tr> |
| <th class="tblheader" scope="col">Software ou Recurso</th> |
| <th class="tblheader" scope="col">Versão Necessária</th> |
| </tr> |
| <tr> |
| <td class="tbltd1"><a href="https://netbeans.org/downloads/index.html">NetBeans IDE</a></td> |
| <td class="tbltd1">versão 6.9 e mais recente</td> |
| </tr> |
| <tr> |
| <td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html">JDK (Java Development Kit)</a></td> |
| <td class="tbltd1">versão 6, 7 ou 8</td> |
| </tr> |
| <tr> |
| <td class="tbltd1">Software cliente do ClearCase</td> |
| <td class="tbltd1"> V 7.0 ou posterior</td> |
| </tr> |
| <tr> |
| <td class="tbltd1">Plug-in ClearCase do NetBeans</td> |
| <td class="tbltd1">versão 0.9.x ou posterior</td> |
| </tr> |
| </tbody> |
| </table> |
| |
| <p><strong class="notes">Observação: </strong>Para obter o plug-in ClearCase do NetBeans, vá para o gerenciador de plug-ins no IDE (Ferramentas > Plug-ins no menu principal) e instale o plug-in, como mostrado abaixo:</p> |
| |
| <p class="align-center"> |
| <a href="../../../images_www/articles/74/ide/clearcase/cc-plugin.png" rel="lytebox" title="Plug-in ClearCase do NetBeans está acessível por meio do Gerenciador de Plug-in"> <img alt="Plug-in do ClearCase do Netbeans exibido no Gerenciador de Plug-in" class="margin-around" src="../../../images_www/articles/74/ide/clearcase/cc-plugin-small.png"></a> |
| </p> |
| |
| <a name="settingUp"></a> |
| <h2>Configurando o ClearCase</h2> |
| |
| <p>Para se beneficiar do suporte à ClearCase do IDE, você precisa ter o software cliente do ClearCase instalado e em execução em seu computador.</p> |
| |
| <p>O suporte a ClearCase do NetBeans funciona com as views <em>snapshot</em> e <em>dinâmica</em>. <strong>A views precisam ser configuradas externamente a partir do IDE e uma conexão com um servidor do ClearCase deve ser configurada corretamente.</strong> Não é necessário trabalho adicional para acessar os arquivos nas views de snapshot. Entretanto, se quiser acessar os arquivos de uma view dinâmica, primeiro você precisará iniciá-la com as ferramentas ClearCase nativas instaladas em seu computador.</p> |
| |
| <p><strong class="notes">Observações:</strong></p> |
| |
| <ul> |
| <li>No momento, não é possível conectar a uma ClearCase Web Interface (CCWeb).</li> |
| <li>Uma limitação para sistemas como o *nix é que você precisa iniciar o IDE de um contexto de eviews dinâmicas para poder acessar seus arquivos.</li> |
| </ul> |
| |
| <p>O suporte a ClearCase do IDE trabalha interagindo com o cliente <tt>cleartool</tt> para realizar os comandos de controle de versão. Dependendo do seu sistema, e se você instala o cliente <tt>cleartool</tt> em um local que não seja o default, talvez seja necessário registrar o caminho para o executável da <tt>cleartool</tt> no IDE.</p> |
| |
| <div class="indent"> |
| <a name="specifying"></a> |
| <h3>Especificando o Caminho para o Executável da <tt>cleartool</tt></h3> |
| |
| <p>O NetBeans IDE tenta automaticamente identificar o local do arquivo executável da <tt>cleartool</tt>, usando a variável do sistema <tt>$PATH</tt> em seu computador. Entretanto, dependendo da sua plataforma, ou se você instalou o cliente ClearCase em um local diferente, talvez seja necessário especificar explicitamente o caminho para o arquivo executável. Para definir o caminho para o arquivo executável do ClearCase no IDE:</p> |
| |
| <ol> |
| <li>Escolha Ferramentas > Opções (NetBeans > Preferências no Mac) no menu principal. A caixa de diálogo Opções é aberta.</li> |
| <li>Selecione o ícone Diversos na parte superior da caixa de diálogo e clique na guia Controle de Versão. No painel esquerdo, em Sistemas de Controle de Versão, selecione ClearCase. As opções definidas pelo usuário para o ClearCase são exibidas na janela principal da caixa de diálogo: |
| |
| <p class="align-center"><a name="ccOptions"></a> <a href="../../../images_www/articles/74/ide/clearcase/cc-options.jpg" rel="lytebox" title="Caixa de diálogo Opções do ClearCase que apresentam opções definidas pelo usuário"> <img alt="Caixa de diálogo Opções do ClearCase que apresentam opções definidas pelo usuário" class="margin-around" src="../../../images_www/articles/74/ide/clearcase/cc-options-small.jpg"></a></p></li> |
| |
| <li>No campo de texto Especificar o Caminho do Executável da <tt>cleartool</tt>, digite o caminho do arquivo executável ou clique em Explorar para navegar para ele em seu sistema.</li> |
| <li>Clique em OK, reinicie IDE para permitir que as alterações tenham efeito.</li> |
| </ol> |
| |
| <p><strong class="notes">Observação: </strong>Para obter mais informações, consulte <a href="http://versioncontrol.netbeans.org/clearcase/install.html">Notas da Release e Configuração de Integração de ClearCase do NetBeans</a>.</p> |
| </div> |
| |
| <a name="starting"></a> |
| <h2>Começando a Trabalhar com Arquivos com Controle de Versão</h2> |
| |
| <p>Ao trabalhar com o ClearCase no IDE pela primeira vez, você precisa começar abrindo um projeto com controle de versão existente, ou criando um novo projeto em uma <strong>view do ClearCase</strong> no computador.</p> |
| |
| <ul> |
| <li><a href="#opening">Abrindo um Projeto Existente no IDE</a> </li> |
| <li><a href="#addingSourceControl">Criando um Novo Projeto e Colocando-o no Controle de Código-fonte</a></li> |
| </ul> |
| |
| <div class="indent"> |
| <a name="opening"></a> |
| <h3>Abrindo um Projeto Existente no IDE</h3> |
| |
| <p>Caso já possua um projeto com controle de versão do ClearCase com o qual tem trabalhado, você pode abri-lo no IDE e as funcionalidades de controle de versão se tornam automaticamente disponíveis. O IDE examina os projetos abertos e se eles estiverem localizados em um diretório de view do ClearCase, o status do arquivo e o suporte contextual se tornam automaticamente ativos.</p> |
| |
| <p>Para abrir um projeto com controle de versão do ClearCase:</p> |
| |
| <ol> |
| <li>Escolha Arquivo > Abrir Projeto no menu principal e navegue pelo assistente para Abrir Projeto. Ao especificar a localização do projeto, navegue para o local em um diretório <strong>dentro de uma view do ClearCase</strong> no computador. Quando você concluir o assistente, o projeto será exibido na janela Projetos (Ctrl-1), e o suporte a controle de versão se tornará ativo.</li> |
| </ol> |
| |
| <p><strong class="notes">Observação: </strong>Você também pode abrir um projeto ou diretório na janela Favoritos. Isso pode ser necessário se o seu diretório do ClearCase não for um projeto do NetBeans. Para fazê-lo, clique com o botão direito do mouse na janela Favoritos (Ctrl-3) e escolha Adicionar aos Favoritos. Na caixa de diálogo Adicionar aos Favoritos que é exibida, navegue para o diretório de view de nível superior do ClearCase em seu computador e clique em Adicionar. Uma view em árvore do diretório é adicionada à janela Favoritos.</p> |
| |
| <a name="addingSourceControl"></a> |
| <h3>Criando um Novo Projeto e Colocando-o no Controle de Código-fonte</h3> |
| |
| <p>Como alternativa, você pode criar um novo projeto e colocá-lo no controle de versão do ClearCase, e continuar a trabalhar no IDE. Quando você cria um novo projeto, é necessário especificar sua localização <strong>dentro de uma view do ClearCase</strong>. Isso permite que o IDE reconheça que o suporte a controle de versão é necessário. Quando o projeto é criado, todos os arquivos são inicialmente de <em>view privada</em>). Você pode adicionar o projeto ao servidor do ClearCase usando o comando Adicionar ao Controle de Código-fonte do IDE.</p> |
| |
| <p>Para criar um novo projeto:</p> |
| |
| <ol> |
| <li>Escolha Arquivo > Novo Projeto no menu principal e trabalhe no assistente Novo Projeto.</li> |
| <li>Na Etapa 2, Nome e Localização, selecione um diretório em uma view do ClearCase.</li> |
| <li>Quando você clica em Finalizar, o projeto é criado e uma view em árvore de seu diretório é adicionada à janela Projetos (Ctrl-1).<br> Durante a criação, o IDE reconhece automaticamente que o projeto está em uma view e todas as ações relevantes do ClearCase e as informações de status do arquivo ficam disponíveis.</li> |
| </ol> |
| |
| <p>Quando um projeto com controle de versão é aberto no IDE, todos os nomes de pasta e de arquivo são renderizados em verde, indicando que eles têm o status 'novo'. (Quaisquer arquivos exibidos em cinza possuem o status 'ignorado'. Consulte <a href="#badges">Emblemas e Codificação de Cor</a> abaixo para obter mais informações.) O IDE decide automaticamente para cada arquivo de projeto com controle de versão se ele é um candidato para controle de versão ou não (ou seja, arquivos de códigos-fonte em pacotes são geralmente com controle de versão, enquanto os arquivos privados do projeto são geralmente ignorados).</p> |
| |
| <!-- <p><span class="tips"></span>It is possible to to modify the way IDE handles private file views using the |
| following options:</p> |
| |
| <ul> |
| <li>Schedule View Private Files For checkin option in the <a href="#ccOptions">ClearCase Options dialog</a></li> |
| <li>Ignored Files setting available under Tools > Options (NetBeans > Preferences on Mac) > |
| Advanced Options > IDE Configuration > System > System Settings > Ignored Files</li> |
| </ul> --> |
| |
| <p>Agora que o seu projeto está criado, você pode sincronizá-lo com um servidor do ClearCase usando o comando Adicionar ao Controle de Código-fonte do IDE:</p> |
| |
| <ol> |
| <li>Clique com o botão direito do mouse no nó do projeto na janela Projetos e escolha Adicionar ao controle de código-fonte. A caixa de diálogo Adicionar se abre listando todos os novos arquivos de view privada que não são ignorados automaticamente pelo IDE: |
| |
| <p class="align-center"><a name="addDialog"></a> <a href="../../../images_www/articles/74/ide/clearcase/add-dialog.jpg" rel="lytebox" title="Caixa de diálogo Adicionar do ClearCase lista todos os arquivos a serem adicionados ao controle de código-fonte"> <img alt="Caixa de diálogo Adicionar do ClearCase" class="margin-around" src="../../../images_www/articles/74/ide/clearcase/add-dialog-small.jpg"></a></p></li> |
| |
| <li>Digite uma mensagem na área de texto Descrevendo a Mensagem. Se preferir, clique no ícone de Mensagens Recentes (<img alt="Ícone de mensagens recentes" src="../../../images_www/articles/74/ide/clearcase/recent-msgs.png">) localizado no canto superior direito para ver e selecionar de uma lista de mensagens que você usou anteriormente existente.</li> |
| <li>Depois de especificar ações para arquivos individuais, clique em Adicionar. A barra de status do IDE, localizada na parte inferior direita da interface, é exibida conforme a ação Adicionar acontecer. Com uma adição bem-sucedida, os emblemas de controle de versão desaparecem nas janelas Projetos, Arquivos e Favoritos, e a codificação de cor dos arquivos submetidos a check-in fica em preto.</li> |
| </ol> |
| |
| <p><strong class="notes">Observação: </strong>Na caixa de diálogo Adicionar, é possível especificar se arquivos individuais devem ser excluídos da ação Adicionar. Para fazê-lo, clique na coluna Ação de um arquivo selecionado e escolha Não adicionar, na lista drop-down.</p> |
| </div> |
| |
| <a name="checkingout"></a> |
| <h2>Fazendo Check-out dos Códigos-fonte</h2> |
| |
| <p>Quando tiver um projeto com controle de versão do ClearCase aberto no IDE, você pode começar a fazer alterações nos códigos-fonte. Modificar arquivos com controle de versão do ClearCase requer que eles tenham check-out ou sejam <em>capturados</em> primeiro. O suporte a ClearCase do NetBeans fornece duas formas de fazer isso:</p> |
| |
| <ul> |
| <li><strong>Manualmente</strong>: Simplesmente clique com o botão direito do mouse em um nó de arquivo e escolha ClearCase > Checkout (ou ClearCase > Capturar).</li> |
| <li><strong>Usando a funcionalidade Fazer Check-out sob Demanda</strong>: Toda vez que ocorre uma ação que requer que um arquivo possa ser gravado, o IDE executa automaticamente o comando relevante do ClearCase (ou seja, alterar o conteúdo do arquivo no editor pela primeira vez ou executar uma ação de refatoração).</li> |
| </ul> |
| |
| <p><span class="tips"></span>A funcionalidade Fazer Check-out sob Demanda pode ser ajustada por meio da opção Checkout sob demanda na <a href="#ccOptions">caixa de diálogo Opções do ClearCase</a>.</p> |
| |
| <a name="editing"></a> |
| <h2>Editando Códigos-fonte</h2> |
| |
| <p>Como acontece com qualquer projeto aberto no NetBeans IDE, é possível abrir os arquivos no Editor de Código-fonte clicando duas vezes em seus nós, conforme eles aparecem nas janelas do IDE (ou seja, janelas Projetos (Ctrl-1), Arquivos (Ctrl-2) e Favoritos (Ctrl-3)).</p> |
| |
| <p>Quando você trabalha com códigos-fonte no IDE, há vários componentes de UI à sua disposição, o que ajuda a exibir e usar os comandos de controle de versão:</p> |
| |
| <ul> |
| <li><a href="#viewingChanges">Exibindo Alterações no Editor de Código-fonte</a></li> |
| <li><a href="#viewingFileStatus">Exibindo Informações de Status do Arquivo</a></li> |
| <li><a href="#comparing">Comparando Versões de Arquivo</a></li> |
| </ul> |
| |
| <div class="indent"> |
| <a name="viewingChanges"></a> |
| <h3>Exibindo alterações no Editor de Código-fonte</h3> |
| |
| <p>Quando abre um arquivo com Controle de Versão no Editor de código-fonte do IDE, você pode ver alterações em tempo real acontecendo em seu arquivo, conforme ele é modificado em relação à versão anterior que sofreu check-out no repositório. Conforme você trabalha, o IDE usa a codificação de cor nas margens do Editor de Código-fonte para fornecer as seguintes informações:</p> |
| |
| <table class="cell"> |
| <tr> |
| <td class="align-right cell"><strong>Azul</strong> ( <span style="background-color:#b8cfe5"> </span> )</td> |
| <td>Indica as linhas alteradas desde a versão anterior</td> |
| |
| </tr> |
| <tr> |
| <td class="align-right cell"><strong>Verde</strong> ( <span style="background-color:#b4ffb4"> </span> )</td> |
| <td>Indica as linhas adicionadas desde a versão anterior.</td> |
| </tr> |
| <tr> |
| <td class="align-right cell"><strong>Vermelho</strong> ( <span style="background-color:#ffa0b4"> </span> )</td> |
| |
| <td>Indica as linhas removidas desde a versão anterior.</td> |
| </tr> |
| </table> |
| |
| <p>A margem esquerda do Editor de Código-fonte mostra as alterações que ocorrem linha por linha. Quando você modifica uma determinada linha, as alterações são imediatamente mostradas na margem esquerda.</p> |
| |
| <p>Você pode clicar em um agrupamento de cores na margem para reverter as alterações feitas recentemente. Por exemplo, a captura de tela inferior esquerda mostra os widgets disponíveis quando você clica em um ícone vermelho, indicando que linhas foram removidas do arquivo que sofreu check-out.</p> |
| |
| <p>A margem direita do Editor de Código-fonte fornece uma visão geral que exibe as alterações feitas no arquivo como um todo, do início ao fim. A codificação de cor é gerada imediatamente quando você altera o arquivo.</p> |
| |
| <p>Observe que você pode clicar em um ponto específico na margem para trazer imediatamente o seu cursor in-line para esse local no arquivo. Para exibir o número de linhas afetadas, passe o mouse sobre os ícones coloridos na margem direita:</p> |
| |
| <table class="cell" style="width:500px"> |
| <tr> |
| <td><a href="../../../images_www/articles/74/ide/clearcase/left-ui.png" rel="lytebox" title="A codificação de cor do controle de versão é exibida na margem esquerda do editor"> <img alt="A codificação de cor do controle de versão é exibida na margem esquerda do editor" class="b-all" src="../../../images_www/articles/74/ide/clearcase/left-ui-small.png"></a> <br><strong>Margem esquerda</strong></td> |
| <td><img alt="A codificação de cor do controle de versão é exibida na margem direita do editor" class="b-all" src="../../../images_www/articles/74/ide/clearcase/right-ui.png" title="A codificação de cor do controle de versão é exibida na margem direita do editor"> <br><strong>Margem direita</strong></td> |
| </tr> |
| </table> |
| |
| <a name="viewingFileStatus"></a> |
| <h3>Exibindo Informações de Status do Arquivo</h3> |
| |
| <p>Quando você está trabalhando nas janelas Projetos (Ctrl-1), Arquivos (Ctrl-2), Favoritos (Ctrl-3) ou de Controle de Versão, o IDE fornece várias funcionalidades visuais que ajudam a exibir as informações de status sobre seus arquivos. No exemplo a seguir, observe como o emblema (por exemplo, <img alt="emblema azul" src="../../../images_www/articles/74/ide/clearcase/blue-badge.png">), cor do nome do arquivo, e label de status adjacente, todos coincidem com outros para fornecer a você uma maneira efetiva e simples para controlar informações sobre seus arquivos de controle de versão:</p> |
| |
| <p class="align-center"> |
| <img alt="emblema de controle de versão azul exibido na janela Favoritos" class="b-all margin-around" src="../../../images_www/articles/74/ide/clearcase/badge-example.jpg" title="emblema de controle de versão azul exibido na janela Favoritos"></p> |
| |
| <p>Os emblemas, a codificação de cor, os labels de status do arquivo e, talvez o mais importante, a janela de Controle de Versão ajudam a exibir e gerenciar de forma eficiente as informações de controle de versão no IDE.</p> |
| |
| <ul> |
| <li><a href="#badges">Emblemas e Codificação de Cor</a></li> |
| <li><a href="#fileStatus">Labels de Status do Arquivo</a></li> |
| <li><a href="#versioning">A Janela de Controle de Versão</a></li> |
| </ul> |
| |
| <div class="indent"> |
| <a name="badges"></a> |
| <h4>Emblemas e Codificação de Cor</h4> |
| |
| <p>Os emblemas são aplicados ao projeto, pasta e nós do pacote e informam o status dos arquivos contidos nesse nó:</p> |
| |
| <p>A tabela a seguir exibe o esquema de cores usado nos emblemas:</p> |
| |
| <table> |
| <tr> |
| <th class="tblheader" scope="col" style="width:120px">Componente de IU</th> |
| <th class="tblheader" scope="col">Descrição</th> |
| </tr> |
| <tr> |
| <td class="tbltd1 align-center"><strong>Emblema Azul</strong> (<img alt="emblema azul" src="../../../images_www/articles/74/ide/clearcase/blue-badge.png">)</td> |
| <td class="tbltd1">Indica a presença de arquivos ou pastas que foram submetidos a check-out, capturados ou adicionados. No caso de pacotes, esse emblema se aplica somente ao pacote em si, e não aos seus subpacotes. Para projetos ou pastas, o emblema indica as alterações nesse item, ou em qualquer uma das subpastas contidas.</td> |
| </tr> |
| </table> |
| |
| <br><a name="color-coding-table"></a> |
| <p>A codificação de cor é aplicada aos nomes de arquivo a fim de indicar seu status atual:</p> |
| |
| <table> |
| <tr> |
| <th class="tblheader" scope="col" style="width:40px">Cor</th> |
| <th class="tblheader" scope="col">Exemplo</th> |
| <th class="tblheader" scope="col">Descrição</th> |
| </tr> |
| <tr> |
| <td class="tbltd1 align-center"><strong>Azul</strong></td> |
| <td class="tbltd1"><img alt="texto azul" src="../../../images_www/articles/74/ide/clearcase/blue-text.png"></td> |
| <td class="tbltd1">Indica que o arquivo sofreu check-out.</td> |
| </tr> |
| <tr> |
| <td class="tbltd1 align-center"><strong>Verde</strong></td> |
| <td class="tbltd1"><img alt="texto verde" src="../../../images_www/articles/74/ide/clearcase/green-text.png"></td> |
| <td class="tbltd1">Indica que o arquivo é novo e ainda não foi adicionado ao controle de código-fonte.</td> |
| </tr> |
| <tr> |
| <td class="tbltd1 align-center"><strong>Cinza</strong></td> |
| <td class="tbltd1"><img alt="texto cinza" src="../../../images_www/articles/74/ide/clearcase/gray-text.png"></td> |
| <td class="tbltd1">Indica que o arquivo será ignorado pelo ClearCase e não será incluído em comandos de controle de versão (ou seja, Adicionar ao Controle de Códigos-Fonte ou Check-in). Os arquivos só podem ser ignorados caso ainda não tenham tido controle de versão.</td> |
| </tr> |
| <tr> |
| <td class="tbltd1 align-center" style="width:120px"><strong>Tachado</strong></td> |
| <td class="tbltd1 align-center"><img alt="texto tachado" src="../../../images_www/articles/74/ide/clearcase/strike-through-text.png"></td> |
| <td class="tbltd1">Indica que o arquivo será excluído de check-ins ou de operações Adicionar ao Controle de Código-Fonte. O texto tachado só aparece em locais específicos, tal como a janela de Controle de Versão, a caixa de diálogo Check-in e a caixa de diálogo Adicionar ao Controle de Códigos-fonte, quando você opta por excluir arquivos individuais de uma ação. Tais arquivos ainda são afetados por outros comandos do ClearCase, tais como Atualizar.</td> |
| </tr> |
| </table> |
| |
| <br><a name="fileStatus"></a> |
| <h4>Labels de Status do Arquivo</h4> |
| |
| <p>Os labels de status do arquivo fornecem uma indicação textual do status dos arquivos com controle de versão nas janelas do IDE. Por default, o IDE exibe as informações de status (novo, reservado, não-reservado, ignorado, etc.) em texto cinza à direita dos arquivos, já que eles são listados em janelas. Entretanto, você pode modificar esse formato para que se adeque às suas necessidades. Por exemplo, se você quiser adicionar seletores de versão aos labels de status, faça o seguinte:</p> |
| |
| <ol> |
| <li>Escolha Ferramentas > Opções (NetBeans > Preferências no Mac) no menu principal. A janela Opções é aberta.</li> |
| <li>Selecione o botão Diversos na parte superior da janela e clique na guia Controle de Versão abaixo dela. Garanta que ClearCase está selecionado abaixo de Sistemas de Controle de versão no painel esquerdo. (Consulte a <a href="#ccOptions">captura de tela</a> acima para referência.)</li> |
| <li>Clique no botão Adicionar Variável à direita do campo de texto Formato do label de status. Na caixa de diálogo Adicionar Variável que é exibida, selecione a variável <tt>{version}</tt> e clique em OK. A variável version é adicionada ao campo de texto Formato do label de status.</li> |
| <li>Para reformatar os labels de status de forma que somente o seletor de status e de versão seja exibido à direita dos arquivos, reorganize o conteúdo do campo de texto Formato do Label de Status para o seguinte:<br> |
| |
| <pre class="examplecode">[{status}; {version}]</pre> |
| |
| Clique em OK. Os labels de status agora listam o seletor de status e versão do arquivo (onde aplicável): |
| |
| <p class="align-center"> |
| <img alt="os labels de arquivo são exibidos próximo aos nomes de arquivo" class="b-all margin-around" src="../../../images_www/articles/74/ide/clearcase/file-labels.jpg" title="os labels de arquivo são exibidos próximo aos nomes de arquivo"></p> |
| </li> |
| </ol> |
| |
| <p><span class="tips"></span>Os labels de status do arquivo podem ser ativados e desativados, ao selecionar Exibir > Mostrar Labels de Controle de Versão no menu principal.</p> |
| |
| <a name="versioning"></a> |
| <h4>A Janela de Controle de Versão</h4> |
| |
| <p>A janela de Controle de Versão do ClearCase fornece uma lista em tempo real de todas as alterações feitas nos arquivos em uma pasta selecionada da sua cópia de trabalho local. Ele é aberto por default no painel inferior do IDE, listando arquivos novos, com check-out ou que foram modificados.</p> |
| |
| <p>Para abrir a janela de Controle de Versão, selecione um arquivo ou pasta com controle de versão (ou seja, na janela Projetos, Arquivos ou Favoritos) e escolha ClearCase > Mostrar Alterações no menu de contexto, ou escolha Controle de Versão > Mostrar Alterações no menu principal. A janela seguinte aparece na parte inferior do IDE:</p> |
| |
| <p class="align-center"> |
| <a href="../../../images_www/articles/74/ide/clearcase/versioning-window.jpg" rel="lytebox" title="A janela de controle de versão exibe arquivos modificados localmente"> <img alt="A janela de controle de versão que exibe arquivos modificados localmente" class="b-all margin-around" src="../../../images_www/articles/74/ide/clearcase/versioning-window-small.jpg"></a></p> |
| |
| <p>Por default, a janela de Controle de Versão exibe uma lista de todos os arquivos do pacote ou pasta selecionado que exibem um status relevante (ou seja, novo, reservado, não reservado, etc.). Você pode clicar nos títulos das colunas acima dos arquivos listados para classificá-los por nome, status, localização ou regra.</p> |
| |
| <p>A barra de ferramentas da janela de Controle de Versão também inclui botões que permitem chamar as tarefas mais comuns do ClearCase em todos os arquivos exibidos na lista. A tabela a seguir lista os comandos do ClearCase disponíveis na barra de ferramentas da janela de Controle de Versão:</p> |
| |
| <table> |
| <tr> |
| <th class="tblheader" scope="col">Ícone</th> |
| <th class="tblheader" scope="col" style="width:110px">Nome</th> |
| <th class="tblheader" scope="col">Função</th> |
| </tr> |
| <tr> |
| <td class="tbltd1 align-center"><img alt="ícone status de atualização" src="../../../images_www/articles/74/ide/clearcase/refresh.png"></td> |
| <td class="tbltd1 align-center"><strong>Atualizar Status</strong></td> |
| <td class="tbltd1">Atualiza o status dos arquivos e pastas selecionados. Os arquivos exibidos na janela de Controle de Versão podem ser atualizados para refletir quaisquer alterações feitas externamente.</td> |
| </tr> |
| <tr> |
| <td class="tbltd1 align-center"><img alt="ícone diferenciar tudo" src="../../../images_www/articles/74/ide/clearcase/diff.png"></td> |
| <td class="tbltd1 align-center"><strong>Diferenciar Tudo</strong></td> |
| <td class="tbltd1">Abre o Visualizador de Diferenciação fornecendo uma comparação lado a lado de suas cópias locais e as versões mantidas no repositório.</td> |
| </tr> |
| <tr> |
| <td class="tbltd1 align-center"><img alt="ícone atualizar todos" src="../../../images_www/articles/74/ide/clearcase/update.png"></td> |
| <td class="tbltd1 align-center"><strong>Atualizar Todos</strong></td> |
| <td class="tbltd1">Atualiza todos os arquivos selecionados. (Aplica-se somente à views de snapshot.)</td> |
| </tr> |
| <tr> |
| <td class="tbltd1 align-center"><img alt="ícone confirmar tudo" src="../../../images_www/articles/74/ide/clearcase/commit.png"></td> |
| <td class="tbltd1 align-center"><strong>Fazer Check-in de todos</strong></td> |
| <td class="tbltd1">Permite que você faça check-in das alterações locais.</td> |
| </tr> |
| </table> |
| |
| <br> |
| <p>Você pode acessar outros comandos do ClearCase na janela de Controle de Versão, selecionando uma linha da tabela que corresponde a um arquivo modificado, e escolhendo um comando do menu de contexto:</p> |
| |
| <p class="align-center"> |
| <img alt="Clique com botão direito do mouse no menu exibido no arquivo selecionado na janela de Controle de Versão" class="margin-around" src="../../../images_www/articles/74/ide/clearcase/versioning-right-click.jpg" title="Clicar com o botão direito no menu exibe um arquivo selecionado na janela Controle de Versão"></p> |
| |
| <br> |
| <p>Por exemplo, execute as ações a seguir em um arquivo:</p> |
| |
| <table> |
| <tr> |
| <td style="width:200px"> |
| <ul> |
| <li><strong>Mostrar Anotações</strong>: <br><br> Exibe o autor e as informações do número da revisão na margem esquerda dos arquivos abertos no Editor de Código-fonte.</li></ul></td> |
| <td class="f-page-cell"> |
| <a href="../../../images_www/articles/74/ide/clearcase/annotations.jpg" rel="lytebox" title="Anotações são exibidas na margem esquerda do Editor de Código-fonte"> <img alt="Anotações exibidas na margem esquerda do Editor de Código-fonte" class="b-all" src="../../../images_www/articles/74/ide/clearcase/annotations-small.jpg"></a></td> |
| </tr> |
| <tr> |
| <td style="width:200px"> |
| <ul> |
| <li><strong>Excluir do Check-in</strong>: <br><br> Permite que você marque o arquivo para ser excluído ao realizar um check-in.</li></ul></td> |
| <td class="f-page-cell"> |
| <img alt="Os arquivos são marcados como excluídos na caixa de diálogo de Fazer Check-in" class="b-all" src="../../../images_www/articles/74/ide/clearcase/exclude-from-checkin.jpg" title="Arquivos são marcados como excluídos na caixa de diálogo de Fazer Check-in"></td> |
| </tr> |
| </table> |
| </div> |
| </div> |
| |
| <a name="comparing"></a> |
| <h3>Comparando Versões de Arquivo</h3> |
| |
| <p>Comparar versões de arquivo é uma tarefa comum ao se trabalhar com projetos com controle de versão. O IDE permite que você compare versões, usando o comando Diferenciar, que está disponível no menu de contexto de um item selecionado (ClearCase > Diferenciar), assim como na janela de Controle de Versão. Na janela de Controle de Versão, você pode executar diferenciais clicando duas vezes em um arquivo listado, caso contrário, você pode clicar no ícone Diferenciar Todos (<img alt="ícone diferenciar tudo" src="../../../images_www/articles/74/ide/clearcase/diff.png">) localizado na barra de ferramentas no topo.</p> |
| |
| <p>Quando você executa a diferenciação, um Visualizador de Diferenciação se abre para o(s) arquivo(s) selecionado(s) na janela principal do IDE. O Visualizador de Diferenciação exibe duas cópias nos painéis lado a lado:</p> |
| |
| <p class="align-center"> |
| <a href="../../../images_www/articles/74/ide/clearcase/diff-viewer.jpg" rel="lytebox" title="Visualizador de Diferenciação ClearCase"> <img alt="Visualizador de Diferenciação ClearCase" class="b-all margin-around" src="../../../images_www/articles/74/ide/clearcase/diff-viewer-small.jpg"></a></p> |
| |
| <p>O visualizador de Diferenciação usa a mesma <a href="#viewingChanges">codificação de cor</a> usada para exibir alterações de controle de versão. Na captura de tela exibida acima, o bloco verde indica o conteúdo que foi adicionado à versão mais atual. O bloco vermelho indica que o conteúdo da versão anterior foi removido da última. Azul indica que as alterações ocorreram na(s) linha(s) realçada(s).</p> |
| |
| <p>Além disso, ao executar uma diferenciação em um grupo de arquivos, como em um projeto, pacote ou pasta, ou quando clicar em diferenciar todos (<img alt="ícone diferenciar tudo" src="../../../images_www/articles/74/ide/clearcase/diff.png">), você pode alternar entre diferenciais clicando em arquivos listados na região superior do Visualizador de Diferenciação.</p> |
| |
| <p>A ferramenta Visualizador de Diferenciação fornece a seguinte funcionalidade:</p> |
| |
| <ul> |
| <li><a href="#makeChanges">Fazer Alterações em arquivos submetidos a check-out</a></li> |
| <li><a href="#navigateDifferences">Navegar entre as Diferenças</a></li> |
| </ul> |
| |
| <div class="indent"> |
| <a name="makeChanges"></a> |
| <h4>Fazer Alterações em arquivo submetido a check-out</h4> |
| |
| <p>Se você estiver diferenciando arquivos submetidos a check-out, você poderá fazer alterações diretamente no Visualizador de Diferenciação. Para fazer isso, você pode colocar o cursor no painel direito do Visualizador de Diferenciação e modificar seu arquivo adequadamente, caso contrário, use os ícones in-line exibidos ao lado de cada alteração realçada:</p> |
| |
| <table> |
| <tr> |
| <td class="align-right cell" style="width:120px"><strong>Substituir</strong> (<img alt="ícone substituir" src="../../../images_www/articles/74/ide/clearcase/insert.png">):</td> |
| <td>Insere o texto realçado das versões anteriores na versão submetida a check-out</td> |
| </tr> |
| <tr> |
| <td class="align-right cell" style="width:120px"><strong>Mover Todos</strong> (<img alt="ícone mover tudo" src="../../../images_www/articles/74/ide/clearcase/arrow.png">):</td> |
| <td>Reverte a versão do arquivo check-out para o estado da versão anterior selecionada</td> |
| </tr> |
| <tr> |
| <td class="align-right cell" style="width:120px"><strong>Remover</strong> (<img alt="ícone remover" src="../../../images_www/articles/74/ide/clearcase/remove.png">):</td> |
| <td>Remove o texto realçado da versão atual com check-out para que ela espelhe a versão anterior</td> |
| </tr> |
| </table> |
| |
| <a name="navigateDifferences"></a> |
| <h4>Navegar nas Diferenças entre Arquivos Comparados</h4> |
| |
| <p>Se a sua comparação contém várias diferenças, você pode navegar nelas, usando os ícones de seta exibidos na barra de ferramentas. Os ícones de seta permitem que você exiba as diferenças conforme elas aparecem na parte do início ao fim:</p> |
| |
| <table> |
| <tr> |
| <td class="align-right cell" style="width:120px"><strong>Anterior</strong> (<img alt="botão diferença anterior" src="../../../images_www/articles/74/ide/clearcase/diff-prev.png">):</td> |
| <td>Vai para a diferença anterior exibida na diferenciação</td> |
| </tr> |
| |
| <tr> |
| <td class="align-right cell" style="width:120px"><strong>Próximo</strong> (<img alt="botão próxima diferença" src="../../../images_www/articles/74/ide/clearcase/diff-next.png">):</td> |
| <td>Vai para a próxima diferença exibida na diferenciação</td> |
| </tr> |
| </table> |
| </div> |
| |
| <a name="checkingin"></a> |
| <h2>Fazendo Check-in de Códigos-fonte</h2> |
| |
| <p>Depois de fazer alterações nos códigos-fonte, você faz check-in delas no repositório. O IDE permite que você chame o comando Check-in das seguintes formas:</p> |
| |
| <ul> |
| <li>Nas janelas Projetos, Arquivos ou Favoritos, clique com o botão direito do mouse nos itens novos ou que foram submetidos a check-out e escolha ClearCase > Fazer Check-in.</li> |
| |
| <li>Na janela Visualizador de Controle de Versão ou de Diferenciação, clique no botão Fazer Check-in de Todos (<img alt="ícone fazer check-in de todos" src="../../../images_www/articles/74/ide/clearcase/commit.png">) localizado na barra de ferramentas.</li> |
| </ul> |
| |
| <p>A caixa de diálogo Fazer Check-in é aberta, listando:</p> |
| |
| <ul> |
| <li>todos os arquivos submetidos a check-out</li> |
| <li>todos os novos arquivos, que serão adicionados automaticamente ao controle de versão primeiro (ou seja, arquivos de view privada que ainda não foram passados pelo controle de versão e não são ignorados pelo IDE).</li> |
| </ul> |
| |
| <p class="align-center"> |
| <a href="../../../images_www/articles/74/ide/clearcase/checkin-dialog.png" rel="lytebox" title="A caixa de diálogo Fazer check-in exibe os arquivos prestes a serem submetidos a check-in"> <img alt="Caixa de diálogo Fazer check-in exibindo arquivos prestes a serem submetidos a check-in" class="margin-around" src="../../../images_www/articles/74/ide/clearcase/checkin-dialog-small.png"></a> |
| </p> |
| |
| <p>Na caixa de diálogo Fazer Check-in é possível especificar se devem ser excluídos arquivos individuais do check-in. Para fazer isso, clique na coluna Ação de Check-in de um item selecionado e escolha Excluir do check-in na lista drop-down.</p> |
| |
| <p>Para realizar o check-in:</p> |
| |
| <ol> |
| <li>Digite uma mensagem de check-in na área de texto Mensagem de Check-in. Se preferir, clique no ícone de Mensagens Recentes (<img alt="Ícone de mensagens recentes" src="../../../images_www/articles/74/ide/clearcase/recent-msgs.png">) localizado no canto superior direito para ver e selecionar de uma lista de mensagens que você usou anteriormente existente.</li> |
| |
| <li>Depois de especificar ações para arquivos individuais, clique em Fazer Check-in. O IDE executa o check-in. A barra de status do IDE, localizada na parte inferior direita da interface, é exibida à medida que a ação Fazer Check-in acontece. Com um check-in bem-sucedido, os emblemas de controle de versão desaparecem das janelas Projetos, Arquivos e Favoritos, e a codificação de cor dos arquivos que estão check-in fica em preto.</li> |
| </ol> |
| |
| <div class="feedback-box"> |
| <a href="/about/contact_form.html?to=3&subject=Feedback:%20Using%20ClearCase%20Support%20in%20NetBeans%20IDE">Enviar Feedback neste Tutorial</a></div> |
| |
| <br style="clear:both;"> |
| |
| <a name="seeAlso"></a> |
| <h2>Consulte Também</h2> |
| |
| <p>Isso conclui o Tour Guiado do ClearCase para o NetBeans IDE. Este documento demonstra como executar tarefas de controle de versão básicas no IDE ao guiá-lo por meio do fluxo de trabalho padrão ao usar o suporte ClearCase do IDE.</p> |
| |
| <p>Para documentos relacionados, consulte os seguintes recursos:</p> |
| |
| <ul> |
| <li><a href="http://wiki.netbeans.org/NetBeansUserFAQ#ClearCase">FAQ do Suporte a ClearCase do NetBeans IDE</a></li> |
| <li><a href="git.html">Usando Suporte Git no NetBeans IDE</a></li> |
| <li><a href="mercurial.html">Usando Suporte ao Mercurial no NetBeans IDE</a></li> |
| <li><a href="subversion.html">Usando Suporte ao Subversion no NetBeans IDE</a></li> |
| <li><a href="cvs.html">Usando Suporte ao CVS no NetBeans IDE</a></li> |
| <li><a href="mercurial-queues.html">Usando Suporte para Filas do Mercurial no NetBeans IDE</a></li> |
| <li><a href="http://www.oracle.com/pls/topic/lookup?ctx=nb8000&id=NBDAG234">Aplicando Controle de Versão às Aplicações com Controle de Versão</a> em <i>Desenvolvendo Aplicações com o NetBeans IDE</i></li></a> |
| |
| |
| </ul> |
| |
| </body> |
| </html> |
