| <!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 Subversion Features in NetBeans IDE 6.9 and higher"> |
| |
| <meta name="keywords" content="NetBeans, IDE, integrated development environment, Subversion, |
| CVS, versioning software, 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 Suporte ao Subversion no NetBeans IDE</title> |
| </head> |
| |
| <body> |
| |
| <!-- |
| Copyright (c) 2009 - 2014, Oracle and/or its affiliates. All rights reserved. |
| --> |
| |
| <h1>Usando Suporte ao Subversion no NetBeans IDE</h1> |
| |
| <p>O NetBeans IDE fornece uma grande integração com as versões de cliente do Subversion 1.6.x e superior. O suporte do Subversion do IDE foi projetado para ajudar a racionalizar o processo de desenvolvimento para grupos trabalhando de um repositório compartilhado, permitindo executar tarefas de controle de versão diretamente de seu sistema de projetos dentro do IDE.</p> |
| |
| <p>Este documento demonstra como executar tarefas básicas de controle de versão no IDE orientando você pelo fluxo de trabalho padrão ao usar o software de controle de versão.</p> |
| |
| <p>Observe que o suporte ao Subversion do NetBeans <em>não</em> funciona quando usado com Cygwin.</p> |
| |
| <p><a href="http://subversion.tigris.org/">Subversion</a> é um sistema de controle de versão de código aberto que está se tornando a próxima geração substituta do CVS. Ele fornece diversas funcionalidades melhoradas, por exemplo:</p> |
| |
| <ul> |
| <li>Um histórico de versão completo é fornecido para arquivos renomeados, movidos ou removidos.</li> |
| <li>Operações de confirmação são atômicas, o que significa que uma coleção de modificações entra completamente no repositório ou, caso ocorra uma falha na conexão, não entram.</li> |
| <li>O controle de versão de metadados do projeto fornecido.</li> |
| </ul> |
| |
| <p><strong>Conteúdo</strong></p> |
| |
| <img alt="O conteúdo desta página aplica-se 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 aplica-se ao o NetBeans IDE 6.9 e mais recente"> |
| |
| <ul class="toc"> |
| <li><a href="#settingUp">Configurando o Subversion</a> |
| <ul> |
| <li><a href="#getting">Obtendo o Software</a></li> |
| <li><a href="#specifying">Especificando o Caminho para o Executável do Subversion</a></li> |
| <li><a href="#ensuring">Certificando-se de que você tenha um Repositório ao qual se Conectar</a></li> |
| </ul></li> |
| <li><a href="#synchronizing">Sincronizando Arquivos Locais com um Repositório</a> |
| <ul> |
| <li><a href="#opening">Abrindo um Projeto Subversion no IDE</a></li> |
| <li><a href="#checking">Fazendo Check-out de Arquivos de um Repositório</a></li> |
| <li><a href="#importing">Importando Arquivos para um Repositório</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> |
| <li><a href="#merging">Mesclando Revisões de Arquivos</a></li> |
| </ul></li> |
| <li><a href="#committing">Confirmando Códigos-fonte em um Repositório</a> |
| <ul> |
| <li><a href="#updating">Atualizando Cópias Locais</a></li> |
| <li><a href="#resolving">Resolvendo Conflitos</a></li> |
| <li><a href="#performing">Executando a Confirmação</a></li> |
| </ul></li> |
| <li><a href="#summary">Resumo</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, 7.0, 7.1, 7.2, 7.3, 7.4 ou 8.0 </td> |
| </tr> |
| <tr> |
| <td class="tbltd1"><a href="http://java.sun.com/javase/downloads/index.jsp">JDK (Java Development Kit)</a></td> |
| <td class="tbltd1">versão 6, 7 ou 8 </td> |
| </tr> |
| <tr> |
| <td class="tbltd1"><a href="http://www.open.collab.net/downloads/netbeans/">Software cliente do Subversion</a></td> |
| <td class="tbltd1">versão 1.6.x ou uma versão mais recente</td> |
| </tr> |
| </tbody> |
| </table> |
| |
| <p class="notes"><strong>Observação para usuários do Windows: </strong>você pode instalar um cliente Subversion incluído no pacote como um plug-in do NetBeans IDE. Vá para Ferramentas > Plug-ins, abra a guia Plug-ins Disponíveis e instale o Cliente Subversion Incluído no Pacote para Windows.</p> |
| |
| <a name="settingUp"></a> |
| <h2>Configurando o Subversion</h2> |
| |
| <p>Para poder tirar vantagem do suporte ao Subversion do IDE, você precisa ter um software cliente do Subversion instalado em seu computador. O suporte ao Subversion do IDE trabalha interagindo com o cliente do Subversion para realizar os comandos de controle de versão. Dependendo do seu sistema, e se você instala o cliente Subversion em um local que não seja o default, talvez seja necessário registrar o caminho para o executável do Subversion no IDE. Por fim, é necessário garantir que exista um repositório Subversion para se conectar.</p> |
| |
| <ul> |
| <li><a href="#getting">Obtendo o Software</a></li> |
| <li><a href="#specifying">Especificando o Caminho para o Executável do Subversion</a></li> |
| <li><a href="#ensuring">Certificando-se de que você tenha um Repositório ao qual se Conectar</a></li> |
| </ul> |
| |
| <div class="indent"> |
| <a name="getting"></a> |
| <h3>Obtendo o Software</h3> |
| |
| <p>Certifique-se de que tenha instalado no computador os seguintes softwares:</p> |
| |
| <ul> |
| <li>NetBeans IDE (<a href="https://netbeans.org/downloads/index.html">download</a>)</li> |
| <li>Java SE Development Kit (<a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html">download</a>)</li> |
| <li>Software cliente do Subversion (<a href="http://www.open.collab.net/downloads/netbeans/">download</a>)</li> |
| |
| </ul> |
| |
| |
| |
| <a name="specifying"></a> |
| <h3>Especificando o Caminho para o Executável do Subversion</h3> |
| |
| <p>O NetBeans IDE tenta automaticamente identificar o local do arquivo executável do Subversion usando a variável do sistema <code>$PATH</code> em seu computador. Entretanto, dependendo da sua plataforma, ou se você instalou o cliente Subversion em um local diferente, talvez seja necessário especificar explicitamente o caminho para o arquivo executável.</p> |
| |
| |
| <p>Por default, o arquivo executável do Subversion é instalado na pasta <code>/usr/bin</code> ou <code>/usr/local/bin/</code> nos computadores UNIX e OS X, e na pasta <code>C:\Program Files\Subversion\bin\</code> (ou <code>C:\Program Files\CollabNet Subversion\bin\</code>) do Windows.</p> |
| |
| <p class="tips">Em computadores *Unix, é possível verificar o local do executável Subversion ao digitar <code>which svn</code> em uma janela do terminal. Em computadores Windows, é possível executar uma pesquisa por todo o sistema de <code>svn.exe</code>.</p> |
| |
| <p>Para definir o caminho para o arquivo executável do Subversion no IDE:</p> |
| |
| <ol> |
| <li>Escolha Ferramentas > Opções(NetBeans > Preferências no OS X) a partir do 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 Subversion. As opções definidas pelo usuário para o Subversion são exibidas na janela principal da caixa de diálogo: |
| |
| <p class="align-center"><a name="svnOptions"></a> <a href="../../../images_www/articles/73/ide/subversion/svn-options.png" rel="lytebox" title="Caixa de diálogo Opções do Subversion com as opções definidas pelo usuário"> <img alt="Caixa de diálogo Opções do Subversion com as opções definidas pelo usuário" class="margin-around" src="../../../images_www/articles/73/ide/subversion/svn-options-small.png"></a></p></li> |
| |
| <li>No campo de texto Especificar a Pasta Home do SVN, digite o caminho do arquivo executável ou clique em Procurar para navegar até ele em seu sistema. Observe que não é necessário <em>incluir</em>o arquivo executável Subversion no caminho.</li> |
| <li>Clique em OK, reinicie IDE para permitir que as alterações tenham efeito.</li> |
| </ol> |
| |
| <a name="ensuring"></a> |
| <h3>Certificando-se de que você tenha um Repositório ao qual se Conectar</h3> |
| |
| <p>Antes de chamar uma ação do Subversion do IDE, certifique-se de que tenha acesso ao repositório do Subversion. O IDE<em>não</em> fornece suporte para criar repositórios do Subversion, uma vez que isso não é uma ação frequentemente usada (em um ambiente de produção um repositório só é criado uma vez após o projeto do layout do repositório ter sido determinado) além disso ele requer comandos administrativos.</p> |
| |
| <p>Se quiser experimentar o suporte do IDE usando um repositório local, é possível criar um usando a <a href="http://svnbook.red-bean.com/en/1.1/ch09s02.html">svnadmin tool</a>, que faz parte do cliente do software do Subversion.</p> |
| |
| <p>Para criar um repositório do Subversion no computador, use <code>svnadmin create</code>. Em um prompt de linha de comandos, digite o seguinte:</p> |
| |
| <pre class="examplecode">svnadmin create /path/to/your/repository</pre> |
| |
| <p>Para obter mais informações, consulte <a href="http://svnbook.red-bean.com/en/1.1/ch05s02.html">http://svnbook.red-bean.com/en/1.1/ch05s02.html</a>.</p> |
| |
| </div> |
| <p class="align-center"><a href="#top">início</a></p> |
| <a name="synchronizing"></a> |
| <h2>Sincronizando Arquivos Locais com um Repositório</h2> |
| |
| <p>Ao usar um sistema de controle de versão, você trabalha sincronizando arquivos locais com um repositório, fazendo alterações na cópia local e, a seguir, confirmando-as no repositório. A lista a seguir descreve diversas maneiras de sincronizar um projeto no NetBeans IDE, dependendo de sua situação específica:</p> |
| |
| <ul> |
| <li><a href="#opening">Abrindo um Projeto Subversion no IDE</a> </li> |
| <li><a href="#checking">Fazendo Check-out de Arquivos de um Repositório</a></li> |
| <li><a href="#importing">Importando Arquivos para um Repositório</a></li> |
| </ul> |
| |
| <div class="indent"> |
| <a name="opening"></a> |
| <h3>Abrindo um Projeto Subversion no IDE</h3> |
| |
| <p>Caso já possua um projeto com controle de versão do Subversion com o qual tem trabalhado fora do IDE, você pode abri-lo no IDE e as funcionalidades de controle de versão se tornam automaticamente disponíveis. O IDE varre seus projetos abertos e se eles contiverem diretórios <code>.svn</code> , o status do arquivo e o suporte contextual se ativam automaticamente para os projetos Subversion com controle de versão.</p> |
| |
| <a name="checking"></a> |
| <h3>Fazendo Check-out de Arquivos de um Repositório</h3> |
| |
| <p>Caso deseje estabelecer conexão com um repositório remoto a partir do IDE, fazer check-out dos arquivos e começar a trabalhar imediatamente com eles, faça o seguinte:</p> |
| |
| <ol> |
| <li>No NetBeans IDE, selecione Equipe > Subversion > Check-out no menu principal. O assistente de Check-out é aberto. <br> <br> <strong class="notes">Observação: </strong>os menus drop-down do IDE se adaptam ao contexto, ou seja, as opções disponíveis dependem do item atualmente selecionado. Portanto, se você já estiver trabalhando dentro de um projeto Subversion, poderá escolher Controle de Versão > Check-out no menu principal.</li> |
| <li>No primeiro painel do assistente, insira um URL que contenha o protocolo e o local de conexão do repositório que deseja se conectar. <br><br> <a name="protocolTypes"></a>O IDE suporta os seguintes tipos de protocolo: <br><br> |
| <table > |
| <tr> |
| <th class="tblheader" scope="col">Protocolo</th> |
| <th class="tblheader" scope="col" >Método de Acesso</th> |
| <th class="tblheader" scope="col">Exemplo</th> |
| </tr> |
| <tr> |
| <td class="tbltd1"><strong>arquivo</strong></td> |
| <td class="tbltd1">Acesso direto ao repositório (no disco local)</td> |
| <td class="tbltd1"><code>file:///repository_path</code></td> |
| </tr> |
| <tr> |
| <td class="tbltd1"><strong>http</strong></td> |
| <td class="tbltd1">Acesso por meio do protocolo WebDAV a um servidor compatível com Subversion</td> |
| <td class="tbltd1"><code>http://hostname/repository_path</code></td> |
| </tr> |
| <tr> |
| <td class="tbltd1"><strong>https</strong></td> |
| <td class="tbltd1">Acesso por meio do protocolo HTTP com criptografia SSL</td> |
| <td class="tbltd1"><code>https://hostname/repository_path</code></td> |
| </tr> |
| <tr> |
| <td class="tbltd1"><strong>svn</strong></td> |
| <td class="tbltd1">Acesso por meio de protocolo personalizado a um servidor <code>svnserve</code></td> |
| <td class="tbltd1"><code>svn://hostname/repository_path</code></td> |
| </tr> |
| <tr> |
| <td class="tbltd1"><strong>svn+ssh</strong></td> |
| <td class="tbltd1">Acesso por meio do protocolo SVN por meio de um túnel SSH externo</td> |
| <td class="tbltd1"><code>svn+ssh://hostname/repository_path</code></td> |
| </tr> |
| </table> |
| |
| <br> Dependendo do protocolo que estiver usando, pode ser necessário inserir outras informações, como nome de usuário e senha (e.g. para <code>http://</code>, <code>https://</code>, ou <code>svn://</code>), ou no caso de <code>svn+ssh://</code>, é necessário fornecer o comando para estabelecer o túnel externo. <br><br> <strong class="notes">Observação: </strong>se estiver tentando implementar uma autenticação certificada com <code>https</code>, consulte: <a href="http://wiki.netbeans.org/wiki/view/FaqSslUserCert">Como conectar-se a um repositório do Subversion usando uma autenticação certificada por usuário?</a> <br><br> Para mais ajuda com <code>svn+ssh</code>, consulte: <a href="http://wiki.netbeans.org/wiki/view/FaqSubversionSSH">Como ajustar o SSH com o Subversion?</a></li> |
| |
| <li>Caso esteja usando um proxy, certifique-se de clicar no botão Configuração de Proxy e insira quaisquer informações solicitadas. Quando tiver certeza de que suas definições de conexão estão corretas, clique em Próximo.</li> |
| <li>No painel Pastas para Check-out do assistente, especifique a pasta para a qual deseja fazer check-out no campo Pasta(s) do Repositório. Caso não saiba o nome da pasta para a qual deseja fazer check-out, clique no botão Procurar para exibir todas as pastas mantidas atualmente no repositório. Na caixa de diálogo Procurar nas Pastas do Repositório, selecione quaisquer uma das pastas listadas e clique em OK. A pasta selecionada é adicionada ao campo Pastas do Repositório ('MyProject' inserido na captura de tela abaixo): |
| |
| <p class="align-center"> |
| <a href="../../../images_www/articles/73/ide/subversion/checkout.png" rel="lytebox" title="Assistente de Check-out do Subversion: painel Pastas para Check-out"> <img alt="Assistente de Check-out do Subversion: painel Pastas para Check-out" class="margin-around" src="../../../images_www/articles/73/ide/subversion/checkout-small.png"></a></p></li> |
| |
| <li>Insira um número de Revisão no campo Revisão do Repositório ou deixe-o em branco, para indicar que deseja fazer check-out da pasta <em>HEAD</em>, ou insira a revisão mais recente.</li> |
| <li>No campo Pasta Local, insira um local em seu computador para onde deseja fazer check-out dos arquivos. Deixe selecionada a opção Procurar por Projetos do NetBeans após Check-out e, em seguida, clique em Finalizar para iniciar a ação de check-out. O IDE faz check-out dos códigos-fonte especificados e a barra de status do IDE indica o andamento do download dos arquivos do repositório para seu diretório de trabalho local. Você também pode exibir os arquivos que estão tendo check-out na janela de Saída (Ctrl-4 no Windows/Cmd-4 no OS X). <br> <br> <strong class="notes">Observação: </strong>caso os códigos-fonte com check-out contenham projetos NetBeans, uma caixa de diálogo será exibida solicitando a abertura deles no IDE. Se os códigos-fonte não contiverem um projeto, aparecerá uma caixa de diálogo solicitando que você crie um novo projeto a partir dos códigos-fonte e, a seguir, que o abra no IDE. Caso você crie um novo projeto para tal código-fonte, selecione a categoria de projeto apropriada (ou seja no assistente Novo projeto), e a seguir use a opção Com Códigos-fonte Existente dentro daquela categoria.</li> |
| </ol> |
| |
| <a name="importing"></a> |
| <h3>Importando Arquivos para um Repositório</h3> |
| |
| <p>Alternativamente, você pode importar um projeto no qual estava trabalhando no IDE para um repositório remoto e, a seguir, continuar a trabalhar nele no IDE após ele ter sido sincronizado.</p> |
| |
| <p><strong class="notes">Observação: </strong>apesar de que de fato você está <em>exportando</em> arquivos do sistema, o termo 'importar" é usado nos sistemas de controle de versão para indicar que os arquivos estão sendo <em>importados em </em>um repositório.</p> |
| |
| <p>Para importar um projeto para um repositório:</p> |
| |
| <ol> |
| <li>Na janela Projetos (Ctrl-1 no Windows/Cmd-1 no OS X), selecione um projeto sem controle de versão e escolha Controle de Versão > Importar para o Repositório do Subversion ao clicar com o botão direito do mouse no nó. O Assistente para Importação do Subversion é aberto.</li> |
| <li>No painel do Repositório do Subversion do assistente para Importação, especifique o <a href="#protocolTypes">protocolo</a> e a localização do repositório do Subversion conforme definido pelo URL do Subversion. Dependendo da sua seleção, talvez você precise da especificação de mais definições, tais como nome de usuário e senha do repositório, ou, no caso de <code>svn+ssh://</code>, você deve especificar o comando Túnel para estabelecer o túnel externo. Consulte o <a href="http://wiki.netbeans.org/wiki/view/NetBeansUserFAQ#section-NetBeansUserFAQ-VersionControlSystems">FAQ do Usuário do Subversion</a> para obter mais detalhes. Clique em Próximo.</li> |
| <li>No painel Pasta do Repositório, especifique a pasta de repositório na qual você deseja colocar o projeto no repositório. Uma pasta que contém o nome do seu projeto é sugerida para você por default no campo de texto Pasta do Repositório, por default.</li> |
| <li>Na área de texto abaixo de Especificar a Mensagem, indique uma descrição do projeto que você está importando para o repositório.</li> |
| <li>Clique em Finalizar para iniciar a importação, ou opcionalmente, clique em Próximo para continuar no terceiro painel que permite que você exiba todos os arquivos que estão preparados para importação. Neste painel, você pode optar por excluir arquivos individuais da importação (como indicado abaixo), ou identificar os tipos de MIME dos arquivos antes da importação. |
| |
| <p class="align-center"> |
| <a href="../../../images_www/articles/73/ide/subversion/import.png" rel="lytebox" title="Assistente de Importação do Subversion: painel Arquivos a Importar"> <img alt="Assistente de Importação do Subversion: painel Arquivos a Importar" class="margin-around" src="../../../images_www/articles/73/ide/subversion/import-small.png"></a></p> |
| |
| |
| Quando você clicar em Finalizar, o IDE fará upload dos arquivos do projeto para o repositório e a janela de Saída será aberta e exibirá o andamento.</li> |
| </ol> |
| </div> |
| <p class="align-center"><a href="#top">início</a></p> |
| <a name="editing"></a> |
| <h2>Editando Códigos-fonte</h2> |
| |
| <p>Quando tiver um projeto com controle de versão do Subversion aberto no IDE, você pode começar a fazer alterações nos códigos-fonte. 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 (por exemplo, janelas Projetos (Ctrl-1 no Windows/Cmd-1 no OS X), Arquivos (Ctrl-2 no Windows/Cmd-2 no OS X) e Favoritos (Ctrl-3 no Windows/Cmd-3 no OS X)).</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 Revisões de Arquivos</a></li> |
| <li><a href="#merging">Mesclando Revisões de Arquivos</a></li> |
| </ul> |
| |
| <div class="indent"> |
| <a name="viewingChanges"></a> |
| <h3>Exibindo alterações no Editor de Código-fonte</h3> |
| |
| <p>Ao abrir um arquivo com controle de versão no Editor de Código-fonte do IDE, você pode ver as alterações em tempo real acontecendo no seu arquivo à medida que ele é modificado em relação à versão anterior cujo check-out do repositório foi efeito. 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 revisã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 revisã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 revisão anterior.</td> |
| </tr> |
| </table> |
| |
| <br> |
| <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>É possível clicar em um agrupamento colorido na margem para chamar os comandos de controle de versão. 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 de sua cópia local.</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/73/ide/subversion/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/73/ide/subversion/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/73/ide/subversion/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 no Windows/Cmd-1 no OS X), Arquivos (Ctrl-2 no Windows/Cmd-2 no OS X), Favoritos (Ctrl-3 no Windows/Cmd-3 no OS X) 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/73/ide/subversion/blue-badge.png">), cor do nome do arquivo, e label de status adjacente, todos coincidem com outros para fornecer a você uma maneira efetiva, mas simples de controlar informações sobre seus arquivos de controle de versão: <br> <br> <img alt="Emblema azul exibido na janela Favoritos" class="b-all" src="../../../images_www/articles/73/ide/subversion/badge-example.png"></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:110px">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/73/ide/subversion/blue-badge.png">)</td> |
| <td class="tbltd1">Indica a presença de arquivos que foram localmente modificados, adicionados ou deletados. 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> |
| <tr> |
| <td class="tbltd1 align-center"><strong>Emblema Vermelho</strong> (<img alt="Emblema vermelho" src="../../../images_www/articles/73/ide/subversion/red-badge.png">)</td> |
| <td class="tbltd1">Marca os projetos, as pastas ou os pacotes que tenham arquivos <em>conflitantes</em> (i.e., versões locais que apresentam conflito com as versões do repositório). 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 os conflitos nesse item ou em qualquer uma das subpastas contidas.</td> |
| </tr> |
| </table> |
| |
| <br><br><a name="color-coding-table"></a> |
| <p>A codificação de cor é aplicada aos nomes de arquivo para indicar seu status atual em relação ao repositório:</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/73/ide/subversion/blue-text.png"></td> |
| <td class="tbltd1">Indica que o arquivo foi modificado localmente.</td> |
| </tr> |
| <tr> |
| <td class="tbltd1 align-center"><strong>Verde</strong></td> |
| <td class="tbltd1"><img alt="Texto verde" src="../../../images_www/articles/73/ide/subversion/green-text.png"></td> |
| <td class="tbltd1">Indica que o arquivo foi adicionado localmente.</td> |
| </tr> |
| <tr> |
| <td class="tbltd1 align-center"><strong>Vermelho</strong></td> |
| <td class="tbltd1"><img alt="Texto vermelho" src="../../../images_www/articles/73/ide/subversion/red-text.png"></td> |
| <td class="tbltd1">Indica que o arquivo contém conflitos entre sua cópia local de trabalho e a versão no repositório.</td> |
| </tr> |
| <tr> |
| <td class="tbltd1 align-center"><strong>Cinza</strong></td> |
| <td class="tbltd1"><img alt="Texto cinza" src="../../../images_www/articles/73/ide/subversion/gray-text.png"></td> |
| <td class="tbltd1">Indica que os arquivo é ignorado pelo Subversion e não será incluído nos comandos de controle de versão (ou seja, Atualizar e Confirmar). 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/73/ide/subversion/strike-through-text.png"></td> |
| <td class="tbltd1">Indica que o arquivo foi excluído das operações de confirmação. O texto tachado aparece somente em locais específicos, como na janela de Controle de Versão ou na caixa de diálogo Confirmar, quando você decide excluir arquivos individuais de uma ação de confirmação. Tais arquivos ainda são afetados por outros comandos do Subversion, 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, modificado, ignorado etc.) e de pastas em texto cinza à direita dos arquivos, à medida 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 números de revisão aos labels de status, faça o seguinte:</p> |
| |
| <ol> |
| <li>Escolha Ferramentas > Opções(NetBeans > Preferências no OS X) a partir do 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 Subversion está selecionado abaixo de Sistemas de Controle de Versão no painel esquerdo. (Consulte a <a href="#svnOptions">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 <code>{revision}</code> e clique em OK. A variável revision é 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: |
| |
| <pre class="examplecode">[{status}; {revision}]</pre> |
| |
| Clique em OK. Os labels de status agora listam o status e os números de revisão do arquivo (onde aplicável): <br> |
| <p class="tips">Os labels de status do arquivo podem ser ativados e desativados, selecionando Exibir > Mostrar Labels de Controle de Versão no menu principal.</p> |
| <br> <img alt="Os labels de arquivo são exibidos próximo aos nomes de arquivo" class="b-all margin-around" src="../../../images_www/articles/73/ide/subversion/file-labels.png"></li> |
| </ol> |
| |
| <p class="tips">Os labels de status do arquivo podem ser ativados e desativados, selecionando 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 Subversion 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. Ela é aberta por default no painel inferior do IDE, listando os arquivos adicionados, deletados ou 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 Subversion > Mostrar Alterações no menu de clique direito, ou escolha Equipe > 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/73/ide/subversion/versioning-window.png" rel="lytebox" title="A janela de controle de versão que exibe os arquivos novos localmente"> <img alt="A janela de controle de versão que exibe os arquivos novos localmente" class="b-all" src="../../../images_www/articles/73/ide/subversion/versioning-window-small.png"></a></p> |
| |
| |
| <p>Por default, a janela Controle de Versão exibe uma lista de todos os arquivos modificados dentro do pacote ou pasta selecionado. Usando os botões na barra de ferramentas, é possível optar por exibir todas as alterações ou limitar a lista de arquivos exibidos a arquivos modificados local ou remotamente. É possível clicar nos cabeçalhos das colunas acima dos arquivos listados para classificá-los por nome, status ou local.</p> |
| <p class="notes"><b>Observações:</b></p> |
| <ul><li> Para ser notificado quando um arquivo de código-fonte de um de seus projetos abertos tiver sido modificado, escolha Equipe > Mostrar Alterações no menu principal. Como alternativa, se a janela Controle de Versão estiver aberta, clique no botão Atualizar Status.</li> |
| <li>As operações na janela Projetos só funcionam nos próprios projetos e não são repetidas. Para mostrar modificações em projetos aninhados/filhos, você pode usar a janela Arquivos ou Favoritos.</li></ul> |
| |
| <p>A barra de ferramentas da janela Controle de Versão também inclui botões que permitem chamar as tarefas mais comuns do Subversion em todos os arquivos exibidos na lista. A tabela a seguir lista os comandos do Subversion disponíveis na barra de ferramentas da janela 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/73/ide/subversion/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/73/ide/subversion/diff.png"></td> |
| <td class="tbltd1 align-center"><strong>Diferenciar Tudo</strong></td> |
| <td class="tbltd1">Abre o Visualizador de Diferenciação que fornece uma comparação lado a lado de suas cópias locais e das versões mantidas no repositório.</td> |
| </tr> |
| <tr> |
| <td class="tbltd1 align-center"><img alt="ícone atualizar todos" src="../../../images_www/articles/73/ide/subversion/update.png"></td> |
| <td class="tbltd1 align-center"><strong>Atualizar Todos</strong></td> |
| <td class="tbltd1">Atualiza todos os arquivos selecionados no repositório.</td> |
| </tr> |
| <tr> |
| <td class="tbltd1 align-center"><img alt="Ícone Confirmar tudo" src="../../../images_www/articles/73/ide/subversion/commit.png"></td> |
| <td class="tbltd1 align-center"><strong>Confirmar Tudo</strong></td> |
| <td class="tbltd1">Permite que você confirme todas as atualizações locais no repositório.</td> |
| </tr> |
| </table> |
| |
| <br> |
| <p>Você pode acessar outros comandos do Subversion na janela Controle de Versão, selecionando uma linha da tabela que corresponde a um arquivo modificado, e escolhendo um comando do menu do botão direito do mouse:</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="b-none margin-around" src="../../../images_www/articles/73/ide/subversion/versioning-right-click.png"></p> |
| |
| |
| <p>Por exemplo, execute as ações a seguir em um arquivo:</p> |
| |
| <table> |
| <tr> |
| <td> |
| <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"> |
| <img alt="Anotações exibidas na margem esquerda do Editor de Código-fonte" class="b-all" src="../../../images_www/articles/73/ide/subversion/annotations.png"></td> |
| </tr> |
| <tr> |
| <td> |
| <ul> |
| <li><strong>Pesquisar Histórico</strong>: <br><br> permite que você procure e compare várias revisões do arquivo selecionado no Visualizador de Histórico do IDE. No Visualizador de Históricos também é possível executar uma <a href="#comparing">comparação</a> ou restaurar sua cópia local para a revisão selecionada.</li> |
| </ul></td> |
| |
| <td class="f-page-cell"> |
| <a href="../../../images_www/articles/73/ide/subversion/history-viewer.png" rel="lytebox" title="O Visualizador de Históricos do Subversion que exibe várias revisões de um arquivo"> <img alt="O Visualizador de Históricos do Subversion que exibe várias revisões de um arquivo" class="b-all" src="../../../images_www/articles/73/ide/subversion/history-viewer-small.png"></a></td> |
| </tr> |
| <tr> |
| <td> |
| <ul> |
| <li><strong>Excluir da Confirmação</strong>: <br><br> Permite que você marque o arquivo para ser excluído ao executar uma confirmação.</li> |
| </ul></td> |
| |
| <td class="f-page-cell"> |
| <a href="../../../images_www/articles/73/ide/subversion/exclude-from-commit.png" rel="lytebox" title="arquivos marcados como excluídos na caixa de diálogo Confirmar"> <img alt="Arquivos marcados como excluídos na caixa de diálogo Confirmar" class="b-all" src="../../../images_www/articles/73/ide/subversion/exclude-from-commit-small.png"></a></td> |
| </tr> |
| <tr> |
| <td> |
| <ul> |
| <li><strong>Reverter Exclusão</strong>: <br><br> abre a caixa de diálogo Reverter Modificações, permitindo que você reverta quaisquer ações de exclusão que tenham sido confirmadas em arquivos de sua cópia de trabalho local. O(s) arquivo(s) especificado(s) será(ão) recuperado(s) do arquivo compactado de histórico local do IDE e restaurados na sua cópia de trabalho local.</li> |
| </ul></td> |
| |
| <td class="f-page-cell"> |
| <a href="../../../images_www/articles/73/ide/subversion/revert-mods.png" rel="lytebox" title="Caixa de diálogo Reverter Modificações"> <img alt="Caixa de diálogo Reverter Modificações" class="b-right b-bottom" src="../../../images_www/articles/73/ide/subversion/revert-mods-small.png"></a></td> |
| </tr> |
| <tr> |
| <td> |
| <ul> |
| <li><strong>Reverter Modificações</strong>: <br><br> abre a caixa de diálogo Reverter Modificações que pode ser usada para especificar parâmetros para reverter quaisquer mudanças locais em revisões mantidas no repositório. <br><br> Ao especificar revisões, você pode clicar em Pesquisar para abrir a caixa de diálogo Pesquisar Revisões. Isso varre o repositório e lista todos os arquivos com base na data inserida.</li> |
| </ul></td> |
| |
| <td class="f-page-cell"> |
| <a href="../../../images_www/articles/73/ide/subversion/search-rev.png" rel="lytebox" title="A caixa de diálogo Pesquisar Revisões lista as revisões de acordo com a data"> <img alt="Caixa de diálogo Pesquisar Revisões que lista as revisões do arquivo de acordo com a data" class="b-right b-bottom" src="../../../images_www/articles/73/ide/subversion/search-rev-small.png"></a></td> |
| </tr> |
| </table> |
| </div> |
| |
| <a name="comparing"></a> |
| <h3>Comparando Revisões de Arquivos</h3> |
| |
| <p>Comparar revisões de arquivos é uma tarefa comum ao se trabalhar com projetos com controle de versão. O IDE permite que você compare versões, usando o comando Diff, que está disponível no menu de contexto de um item selecionado (Subversion> Diff), 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/73/ide/subversion/diff.png">) localizado na barra de ferramentas no topo.</p> |
| |
| <p>Quando você faz uma diferenciação, um Visualizador de Diferenciação gráfico é aberto para os arquivos e revisões selecionados na janela principal do IDE. O Visualizador de Diferenciação exibe duas cópias nos painéis lado a lado. A cópia mais atual aparece no lado direito, portanto, se você estiver comparando uma revisão do repositório com sua cópia de trabalho, a cópia de trabalho é exibida no painel direito:</p> |
| |
| <p class="align-center"> |
| <a href="../../../images_www/articles/73/ide/subversion/diff-viewer.png" rel="lytebox" title="Visualizador de Diferenciação do Subversion"> <img alt="Visualizador de Diferenciação do Subversion" class="b-all margin-around" src="../../../images_www/articles/73/ide/subversion/diff-viewer-small.png"></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 à revisão mais atual. O bloco vermelho indica que o conteúdo da revisão anterior foi removido da última revisão. 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/73/ide/subversion/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 sua Cópia de Trabalho Local</a></li> |
| <li><a href="#navigateDifferences">Navegar entre as Diferenças</a></li> |
| <li><a href="#changeViewCriteria">Alterar os Critérios de Exibição</a></li> |
| </ul> |
| |
| <div class="indent"> |
| <a name="makeChanges"></a> |
| <h4>Fazer Alterações em sua Cópia de Trabalho Local</h4> |
| |
| <p>Se você estiver executando uma diferenciação em sua cópia de trabalho local, o IDE permite 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/73/ide/subversion/insert.png">):</td> |
| <td>Insere o texto realçado da revisão anterior na revisão atual</td> |
| </tr> |
| <tr> |
| <td class="align-right cell" style="width:120px"><strong>Mover Todos</strong> (<img alt="Ícone Mover tudo" src="../../../images_www/articles/73/ide/subversion/arrow.png">):</td> |
| <td>Reverte a revisão atual do arquivo para o estado da revisã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/73/ide/subversion/remove.png">):</td> |
| <td>Remove o texto realçado da revisão atual para que ela espelhe a revisã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/73/ide/subversion/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/73/ide/subversion/diff-next.png">):</td> |
| <td>Vai para a próxima diferença exibida na diferenciação</td> |
| </tr> |
| </table> |
| |
| <a name="changeViewCriteria"></a> |
| <h4>Alterar os Critérios de Exibição</h4> |
| |
| <p>Você pode optar por exibir os arquivos que contêm alterações na cópia de trabalho local, no repositório ou em ambos simultaneamente:</p> |
| |
| <table> |
| <tr> |
| <td class="align-right cell" style="width:120px"><strong>Local</strong> ( <img alt="Ícone modificado localmente" src="../../../images_www/articles/73/ide/subversion/locally-mod.png"> ):</td> |
| <td>Exibe apenas os arquivos modificados localmente</td> |
| </tr> |
| <tr> |
| <td class="align-right cell" style="width:120px"><strong>Remoto</strong> ( <img alt="Ícone modificado remotamente" src="../../../images_www/articles/73/ide/subversion/remotely-mod.png"> ):</td> |
| <td>Exibe apenas os arquivos modificados remotamente</td> |
| </tr> |
| <tr> |
| <td class="align-right cell" style="width:120px"><strong>Ambos</strong> ( <img alt="Ícone modificado localmente e remotamente" src="../../../images_www/articles/73/ide/subversion/both-mod.png"> ):</td> |
| <td>Exibe os arquivos modificados local e remotamente</td> |
| </tr> |
| </table> |
| <p class="notes"><b>Observação:</b> o esquema de cores descrito na seção <a href="#badges"> Emblemas e Codificação de Cor</a> é desconsiderado com relação aos ícones mencionados anteriormente. </p> |
| </div> |
| |
| <a name="merging"></a> |
| <h3>Mesclando Revisões de Arquivos</h3> |
| |
| <p>O NetBeans IDE permite mesclar as alterações entre as revisões no repositório e na sua cópia de trabalho local. É possível especificar uma faixa de revisões para mesclar. É possível mesclar uma faixa de revisões de duas pastas separadas de um repositório.</p> |
| |
| <p>O cenário a seguir descreve um caso comum: você fez check-out da versão trunk de um arquivo chamado <code>JavaApp</code> e agora deseja mesclar sua cópia com a ramificação. Para motivos de demonstração o layout do repositório contém uma pasta <code>ramificação</code> usada para conter todos os arquivos ramificados:</p> |
| |
| <ol> |
| <li>Na janela Projetos, Arquivos ou Favoritos, clique com o botão direito do mouse nos arquivos ou pastas em que deseja realizar a operação de mesclagem e escolha Subversion > Mesclar Alterações. A caixa de diálogo Mesclar é exibida.</li> |
| <li>Na lista drop-down Mesclar, selecione Uma Pasta do Repositório desde sua Origem. Todas as mudanças feitas em uma ramificação são transferidas no momento em que são criadas.</li> |
| <li>No campo de texto da Pasta do Repositório, insira o caminho na pasta para a qual você deseja transportar as alterações (<code>branches/JavaApp</code>). Deixe o campo Revisão Final vazio para indicar que deseja incluir todas as revisões até o <em>HEAD</em> (isto é, estado atual). |
| |
| <p class="align-center"> |
| <a href="../../../images_www/articles/73/ide/subversion/svn-merge.png" rel="lytebox" title="Caixa de diálogo Mesclagem do Subversion"> <img alt="Caixa de diálogo Mesclagem do Subversion" class="margin-around b-none" src="../../../images_www/articles/73/ide/subversion/svn-merge-small.png"></a></p></li> |
| |
| <li>Clique em Mesclar. O IDE incorpora quaisquer diferenças constatadas entre a versão de revisão da ramificação e a cópia local do arquivo. Se ocorrerem conflitos de mesclagem, o status do arquivo será atualizado em <a href="#resolving">Conflito de Mesclagem</a> para indicar o fato.</li> |
| </ol> |
| |
| <p><strong class="notes">Observação:</strong> depois de mesclar as alterações do arquivo com o diretório de trabalho local, ainda é necessário confirmar as alterações usando o comando Confirmar para poder adicionar as alterações ao repositório.</p> |
| </div> |
| <p class="align-center"><a href="#top">início</a></p> |
| <a name="committing"></a> |
| <h2>Confirmando Códigos-fonte em um Repositório</h2> |
| |
| <p>Depois de fazer alterações no código-fonte, você as confirma no repositório. Normalmente, é recomendado atualizar todas as cópias que você tenha no repositório antes de executar a confirmação para garantir que não surjam conflitos. No entanto, podem ocorrer conflitos, que devem ser considerados como um evento natural quando vários desenvolvedores trabalham simultaneamente em um projeto. O IDE fornece um suporte flexível que permite executar todas essas funções. Ele também fornece um Resolvedor de Conflitos que permite tratar com segurança quaisquer conflitos à medida que ocorrerem.</p> |
| |
| <ul> |
| <li><a href="#updating">Atualizando Cópias Locais</a></li> |
| <li><a href="#resolving">Resolvendo Conflitos</a></li> |
| <li><a href="#performing">Executando a Confirmação</a></li> |
| </ul> |
| |
| <div class="indent"> |
| <a name="updating"></a> |
| <h3>Atualizando Cópias Locais</h3> |
| |
| <p>Você pode executar atualizações ao escolher Subversion > Atualizar ao clicar com o botão direito do mouse em qualquer item com controle de versão nas janela Projetos, Arquivo ou Favoritos. Ao trabalhar diretamente na janela Controle de Versão, basta clicar com o botão direito do mouse em um arquivo listado e escolher Atualizar.</p> |
| |
| <p>Para executar uma atualização em todos os arquivos de código-fonte, você pode clicar no ícone Atualizar Todos (<img alt="Ícone Atualizar tudo" src="../../../images_www/articles/73/ide/subversion/update.png">), que exibe as barras de ferramentas localizadas na parte superior da <a href="#versioning">Janela Controle de Versão</a> e no </a>Visualizador de Diferenciação<a href="#comparing">. Quaisquer alterações que possam ter ocorrido no repositório são exibidas na janela de Saída de Controle de Versão.</p> |
| |
| <a name="resolving"></a> |
| <h3>Resolvendo Conflitos</h3> |
| |
| <p>Quando você executa uma atualização ou confirmação, o suporte ao Subversion do IDE compara seus arquivos com os códigos-fonte no repositório para assegurar que outras alterações já não ocorreram nos mesmos locais. Quando seu check-out (ou atualização) anterior não coincidir mais com o <em>HEAD</em> do repositório (ou seja, a versão mais atual) <em>e</em> as alterações aplicadas à sua cópia local de trabalho coincidirem com áreas no HEAD que também mudaram, sua atualização ou confirmação resultará em um <em>conflito</em>.</p> |
| |
| <p>Conforme indicado em <a href="#badges">Emblemas e Codificação de Cor</a>, os conflitos são exibidos no IDE com texto vermelho e são acompanhado por um emblema vermelho (<img alt="Emblema vermelho" src="../../../images_www/articles/73/ide/subversion/red-badge.png">) quando visualizada nas janelas Projetos, Arquivos ou Favoritos. Quando você trabalha na janela Controle de Versão, os conflitos também são indicados por um status de arquivo:</p> |
| |
| <p class="align-center"> |
| <img alt="Conflito de arquivo exibido na janela Controle de Versão" class="b-right margin-around" src="../../../images_www/articles/73/ide/subversion/conflict-versioning-win.png"></p> |
| |
| <p>Quaisquer conflitos que surjam precisam ser resolvidos antes de confirmar os arquivos no repositório. Você pode resolver os conflitos no IDE usando o Resolvedor de Conflitos de Mesclagem O Resolvedor de Conflitos de Mesclagem fornece uma interface intuitiva que permite endereçar conflitos individuais sequencialmente enquanto exibe a saída mesclada ao efetuar alterações. Você pode acessar o Resolvedor de Conflitos de Mesclagem em um arquivo que esteja em conflito ao clicar com o botão direito do mouse naquele arquivo e escolher Subversion > Solucionar Conflitos.</p> |
| |
| <p>O Resolvedor de Conflitos de Mesclagem exibe as duas revisões em conflito lado a lado no painel superior, com as áreas conflitantes realçadas. O painel inferior mostra o arquivo da forma como aparece durante mesclagens de conflitos entre as duas revisões:</p> |
| |
| <p class="align-center"> |
| <a href="../../../images_www/articles/73/ide/subversion/conflict-resolver.png" rel="lytebox" title="Resolvedor de Conflitos ao exibir um arquivo em conflito"> <img alt="Resolvedor de Conflitos ao exibir um arquivo em conflito" class="margin-around b-all" src="../../../images_www/articles/73/ide/subversion/conflict-resolver-small.png"></a></p> |
| |
| <p> |
| Você resolver um conflito ao aceitar uma das duas revisões exibidas no painel superior. Clique no botão Aceitar da revisão que deseja aceitar. O IDE mescla a revisão aceita com o arquivo de origem e você pode imediatamente ver os resultados da mesclagem no painel inferior do Resolvedor de Conflitos de Mesclagem. Depois de resolver todos os conflitos, clique em OK para sair do Resolvedor de Conflitos de Mesclagem e salvar o arquivo modificado. O emblema de conflito é removido e agora é possível confirmar o arquivo modificado no repositório.</p> |
| |
| <a name="performing"></a> |
| <h3>Executando a Confirmação</h3> |
| |
| <p>Após editar os arquivos de origem, executar uma atualização e resolver quaisquer conflitos, você confirma os arquivos de sua cópia local de trabalho no repositório. O IDE permite que você chame o comando de confirmação das seguintes formas:</p> |
| |
| <ul> |
| <li>Nas janelas Projetos, Arquivos ou Favoritos, clique com o botão direito do mouse nos itens novos ou modificados e escolha Subversion > Confirmar.</li> |
| <li>Na janela Visualizador de Controle de Versão ou de Diferenciação, clique no botão Confirmar Tudo (<img alt="Ícone Confirmar tudo" src="../../../images_www/articles/73/ide/subversion/commit.png">) localizado na barra de ferramentas.</li> |
| </ul> |
| |
| <p>A caixa de diálogo Confirmar é aberta, exibindo os arquivos que estão prestes a serem confirmados no repositório:</p> |
| |
| <p class="align-center"> |
| <a href="../../../images_www/articles/73/ide/subversion/commit-dialog.png" rel="lytebox" title="Caixa de diálogo Confirmar exibindo arquivos prestes a serem confirmados"> <img alt="Caixa de diálogo Confirmar exibindo arquivos prestes a serem confirmados" class="b-none margin-around" src="../../../images_www/articles/73/ide/subversion/commit-dialog-small.png"></a></p> |
| |
| <p>A caixa de diálogo Confirmar lista:</p> |
| |
| <ul> |
| <li>todos os arquivos modificados localmente</li> |
| <li>todos os arquivos deletados localmente</li> |
| <li>todos os arquivos novos (ou seja, arquivos que ainda não existem no repositório)</li> |
| <li>todos os arquivos que você renomeou. O Subversion trata os arquivos renomeados deletando o arquivo original e criando uma cópia com o novo nome.</li> |
| </ul> |
| |
| <p>Na caixa de diálogo Confirmar, é possível especificar se arquivos individuais devem ser excluídos da confirmação. Para fazer isso, clique na coluna Ação de Confirmação de um arquivo selecionado e escolha Excluir da confirmação na lista drop-down. De forma similar, quando novos arquivos são incluídos, é possível especificar o tipo MIME ao escolher Adicionar como binário ou Adicionar como Texto na lista drop-down.</p> |
| |
| <p>Para executar a confirmação:</p> |
| |
| <ol> |
| <li>Digite uma mensagem de confirmação na área de texto Mensagem de Confirmação. Se preferir, clique no ícone de Mensagens Recentes (<img alt="Ícone de Mensagens recentes" src="../../../images_www/articles/73/ide/subversion/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 Confirmar. O IDE executa a confirmação e envia suas alterações locais para o repositório. A barra de status do IDE, localizada na parte inferior direita da interface, é exibida conforme a ação de confirmação ocorre. Com uma confirmação bem-sucedida, as identificações de controle de versão desaparecem nas janelas Projetos, Arquivos e Favoritos e a codificação de cor dos arquivos confirmados volta a ser preta.</li> |
| </ol> |
| </div> |
| <p class="align-center"><a href="#top">início</a></p> |
| <a name="summary"></a> |
| <h2>Resumo</h2> |
| <p>Isso conclui o tour guiado do Subversion para NetBeans IDE 6.x e versões posteriores. Este documento demonstrou como executar tarefas de controle de versão básicas no IDE, guiando você pelo fluxo de trabalho padrão ao usar o suporte Subversion do IDE. Ele mostrou como configurar um projeto com controle de versão e como executar tarefas básicas em arquivos com controle de versão e apresentando-o algumas das novas funcionalidades do Subversion incluídas no IDE.</p> |
| |
| <div class="feedback-box"> |
| <a href="/about/contact_form.html?to=3&subject=Feedback:%20Using%20Subversion%20Support%20in%20NetBeans%20IDE">Enviar Feedback neste Tutorial</a></div> |
| |
| <br style="clear:both;"> |
| <p class="align-center"><a href="#top">início</a></p> |
| <a name="seeAlso"></a> |
| <h2>Consulte Também</h2> |
| |
| |
| |
| <p>Para documentos relacionados, consulte os seguintes recursos:</p> |
| |
| <ul> |
| <li><a href="http://wiki.netbeans.org/wiki/view/NetBeansUserFAQ#section-NetBeansUserFAQ-VersionControlSystems">FAQ do Suporte Subversion para o NetBeans IDE</a></li> |
| <li><a href="http://wiki.netbeans.org/FaqSubversionClients">Perguntas Frequentes sobre Clientes do Subversion</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="mercurial-queues.html">Usando Suporte para Filas do Mercurial no NetBeans IDE</a></li> |
| <li><a href="cvs.html">Usando Suporte ao CVS no NetBeans IDE</a></li> |
| <li><a href="clearcase.html">Usando o Suporte de ClearCase 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> |
| |
| </ul> |
| <p class="align-center"><a href="#top">início</a></p> |
| </body> |
| </html> |
