| <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> | |
| <html xmlns="http://www.w3.org/1999/xhtml"> | |
| <head> | |
| <meta http-equiv="content-type" content="text/html; charset=UTF-8"> | |
| <!-- -*- xhtml -*- --> | |
| <title>Início rápido da Plataforma NetBeans para Plataformas NetBeans 6.1</title> | |
| <link rel="stylesheet" type="text/css" href="../../../netbeans.css"> | |
| <meta name="AUDIENCE" content="NBUSER"> | |
| <meta name="TYPE" content="ARTICLE"> | |
| <meta name="EXPIRES" content="N"> | |
| <meta name="developer" content="jtulach@netbeans.org"> | |
| <meta name="indexed" content="y"> | |
| <meta name="description" | |
| content="A short guide to using the Nodes API."> | |
| <!-- Copyright (c) 2009, 2010, Oracle and/or its affiliates. All rights reserved. --> | |
| <!-- Use is subject to license terms.--> | |
| </head> | |
| <body> | |
| <h1>Início rápido da Plataforma NetBeans</h1> | |
| <p>Bem-vindo à Plataforma NetBeans! | |
| </p><p>Este tutorial oferece uma introdução simples e rápida ao fluxo de trabalho da Plataforma NetBeans, orientando você na criação de um editor HTML simples. Embora simples, o Editor de HTML criado será muito desenvolvido porque reutilizará a infra-estrutura fornecida pela Plataforma NetBeans. Por exemplo, sem qualquer código, o Editor de HTML terá um sistema de janela desenvolvido. Após concluir este tutorial, você terá adquirido um conhecimento geral sobre como criar, construir e executar aplicativos da Plataforma IDE. | |
| </p><p>Após concluir este tutorial, você pode passar para a <a href="https://netbeans.org/kb/trails/platform.html">trilha do aprendizado da plataforma NetBeans</a> A trilha do aprendizado fornece tutoriais abrangentes que destacam uma ampla gama de APIs do NetBeans para uma variedade de tipos de aplicativos. Se não desejar criar um aplicativo "Hello world", ignore este tutorial e vá direito para a trilha do aprendizado. | |
| </p><p><b>Conteúdo</b></p> | |
| <img src="../../images/articles/61/netbeans-stamp.gif" class="stamp" width="114" height="114" alt="O conteúdo desta página se aplica ao IDE NetBeans 6.1 " title="O conteúdo desta página se aplica ao IDE NetBeans 6.1"> </p> | |
| <ul class="toc"> | |
| <li><a href="#generating">Gerando a aplicação de esqueleto</a></li> | |
| <li><a href="#tweakingthemenuitems">Otimizando a interface do usuário</a> | |
| </li><li><a href="#tweakingthewindowlayout">Otimizando o layout da janela</a></li> | |
| <li><a href="#tweakingthefavorites">Otimizando a janela Favoritos</a></li> | |
| <li><a href="#runningtheapplication">Executando a aplicação</a></li> | |
| <li><a href="#distributingtheapplication">Distribuindo a aplicação</a> | |
| <ul> | |
| <li><a href="#zip">Distribuindo o Editor de HTML através de um arquivo ZIP</a></li> | |
| <li><a href="#webstart">Distribuindo o editor HTML por meio do Repositório Web Start compartilhado do NetBeans</a></li> | |
| </ul> | |
| </li> | |
| </ul> | |
| <p><b>Para seguir este tutorial, você preciso dos softwares e recursos listados na tabela seguinte.</b></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">NetBeans IDE</td> | |
| <td class="tbltd1">versão <a href="http://download.netbeans.org/netbeans/6.1/final/">versão 6.1</a></td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1">Java Developer Kit (JDK)</td> | |
| <td class="tbltd1"><a href="http://java.sun.com/javase/downloads/index.jsp">versão 6</a> ou<br> | |
| versão 5</td> | |
| </tr> | |
| </tbody> | |
| </table> | |
| <p class="tips">Opcionalmente, para fins de solução de problemas, você pode <a href="http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=6635">baixar a amostra completa</a> e inspecionar os códigos-fonte. | |
| </p><p>No fim deste tutorial, você terá um Editor HTML que se parece com este:</p> | |
| <img src="../../images/tutorials/htmleditor/html_editor_final-61.png" border="1" alt="Editor de HTML final "> | |
| <p><b class="notes">Observação:</b> Embora seja um aplicativo demonstrativo muito simples, ele não é um brinquedo! É um programa <i>real</i> que dá suporte a edição fácil de páginas HTML, com recursos como auto-completar de código, validação e fragmentos de código HTML predefinidos. | |
| </p><p>O Editor HTML que você cria neste tutorial é uma aplicação rich-client concluída "sobre a Plataforma NetBeans". O que isso significa é que o núcleo do IDE, que <i><u>é</u></i> a Plataforma NetBeans, será a base da sua aplicação. Sobre a Plataforma NetBeans, você adiciona os módulos necessários e exclui aqueles de que o IDE precisa mas que a sua aplicação não. Aqui você vê alguns dos módulos do IDE, adicionados à Plataforma NetBeans, que é a sua base:</p> | |
| <img src="../../images/tutorials/htmleditor/diagram.png" alt="Estrutura dos aplicativos da Plataforma NetBeans"> | |
| <p>Criar esse Editor HTML significa gerar um esqueleto de aplicação, excluindo os módulos e os itens de interface do usuário de que você não precisa e, em seguida, definir a janela Favoritos como a janela que será aberta por padrão quando o IDE se iniciar. Todas essas atividades são suportadas pelos elementos de interface do usuário no IDE. </p> | |
| <p>Você verá por si mesmo como é simples e fácil construir, ou para ser mais preciso, <em>montar</em> uma aplicação completa sobre a Plataforma NetBeans. No fim, é mostrado como tornar o produto final facilmente baixável e iniciável usando o WebStart. | |
| </p> | |
| <p><b class="notes">Observação:</b> embora seja um produto separado, não é necessário baixar a Plataforma NetBeans separadamente por causa deste tutorial. Você desenvolverá a aplicação rich-client no IDE e, em seguida, excluirá os módulos que são específicos do IDE, mas que são supérfluos para a sua aplicação. | |
| <!-- ===================================================================================== --> | |
| </p><h2 class="tutorial"><a name="generating"></a>Gerando a aplicação de esqueleto</h2> | |
| <p>Ao criar um aplicativo na Plataforma NetBeans, o primeiro passo é criar um projeto de aplicativo da Plataforma NetBeans. | |
| O projeto de conjunto de aplicativo da Plataforma NetBeans padrão inclui <i>todos</i> os módulos incluídos na Plataforma NetBeans, assim como <i>todos</i> os módulos incluídos no NetBeans IDE. Já que não precisamos de todos esses módulos, excluiremos os que não são necessários. | |
| </p><ol><li>Usando o assistente para Novo projeto (Ctrl-Shift-N), crie um projeto de aplicativo da Plataforma NetBeans a partir do modelo na categoria de módulos do NetBeans, como mostrado abaixo:</p> | |
| <p><img border="1" src="../../images/tutorials/htmleditor/netbeans-platform-app-1.png" border="1" alt="New Project wizard"> | |
| </p><p>Clique em Próximo e nomeie o projeto de aplicativo da Plataforma NetBeans como "NetBeansHTMLEditor". Clique em Terminar.</p> | |
| </li><li>Clique com o botão direito do mouse no nó do projeto, escolha Propriedades e, em seguida, faça algumas alterações na caixa de diálogo Propriedades do projeto de aplicativo da Plataforma NetBeans: | |
| <ul><p></p><li>No painel Construir, clique em "Criar aplicação independente" para especificar que vai ser uma aplicação rich-client sobre a Plataforma NetBeans. </p> | |
| <p>Verifique se você gosta do nome da marca do executável e do título do aplicativo da barra de título, como mostrado abaixo:</p> | |
| <p><img border="1" src="../../images/tutorials/htmleditor/application_panel-61.png" border="1" alt="Painel do aplicativo"> | |
| </p></li><li>No painel Tela de splash, observe que você pode fornecer a tela de splash do aplicativo e as identificações de marca da barra de progresso, como mostrado abaixo: | |
| </p> | |
| <p><img border="1" src="../../images/tutorials/htmleditor/splash_screen_panel-61.png" border="1" alt="Painel da tela de abertura"> | |
| </p><p><b class="notes">Observação:</b> Se você não tiver uma tela de abertura, use <a href="../../images/tutorials/htmleditor/splash.gif">esta</a>. | |
| </p></li> | |
| <li><p>No painel Bibliotecas da caixa de diálogo Propriedades do projeto, você vê uma lista de "clusters". Um cluster é uma coleção de módulos relacionados. Os únicos clusters que precisam ser selecionados são <tt>gsf1</tt>, <tt>ide9</tt> e <tt>platform8</tt>. Desmarque todos os outros clusters. Agora, você precisa habilitar e desabilitar vários módulos, porque somente os especificamente relevantes ao Editor de HTML devem ser selecionados. Sempre que você marca ou desmarca a seleção de um módulo no painel Bibliotecas, uma entrada é adicionada ao arquivo de configuração da Plataforma NetBeans do aplicativo. Para agilizar este processo, nós simplesmente colaremos as entradas neste arquivo. Feche a caixa de diálogo Propriedades do projeto.</p> | |
| <p></p><p>Expanda o nó Arquivos importantes e abra o arquivo de configuração da Plataforma NetBeans. Cole as seguintes entradas: | |
| </p><p></p><pre>disabled.clusters=\ | |
| apisupport1,\ | |
| harness,\ | |
| java2,\ | |
| nb6.1,\ | |
| profiler3 | |
| disabled.modules=\ | |
| org.mozilla.rhino.patched,\ | |
| org.netbeans.api.debugger,\ | |
| org.netbeans.api.visual,\ | |
| org.netbeans.core.ide,\ | |
| org.netbeans.core.multiview,\ | |
| org.netbeans.core.nativeaccess,\ | |
| org.netbeans.insane,\ | |
| org.netbeans.lib.cvsclient,\ | |
| org.netbeans.libs.commons_logging,\ | |
| org.netbeans.libs.ini4j,\ | |
| org.netbeans.libs.jna,\ | |
| org.netbeans.libs.svnClientAdapter,\ | |
| org.netbeans.libs.xerces,\ | |
| org.netbeans.modules.autoupdate.services,\ | |
| org.netbeans.modules.autoupdate.ui,\ | |
| org.netbeans.modules.classfile,\ | |
| org.netbeans.modules.core.kit,\ | |
| org.netbeans.modules.css.editor,\ | |
| org.netbeans.modules.css.visual,\ | |
| org.netbeans.modules.db,\ | |
| org.netbeans.modules.db.core,\ | |
| org.netbeans.modules.db.drivers,\ | |
| org.netbeans.modules.db.kit,\ | |
| org.netbeans.modules.db.mysql,\ | |
| org.netbeans.modules.db.sql.editor,\ | |
| org.netbeans.modules.db.sql.visualeditor,\ | |
| org.netbeans.modules.dbapi,\ | |
| org.netbeans.modules.editor.bookmarks,\ | |
| org.netbeans.modules.editor.kit,\ | |
| org.netbeans.modules.extbrowser,\ | |
| org.netbeans.modules.gototest,\ | |
| org.netbeans.modules.httpserver,\ | |
| org.netbeans.modules.ide.kit,\ | |
| org.netbeans.modules.javascript.editing,\ | |
| org.netbeans.modules.javascript.hints,\ | |
| org.netbeans.modules.javascript.kit,\ | |
| org.netbeans.modules.javascript.refactoring,\ | |
| org.netbeans.modules.languages,\ | |
| org.netbeans.modules.languages.bat,\ | |
| org.netbeans.modules.languages.diff,\ | |
| org.netbeans.modules.languages.manifest,\ | |
| org.netbeans.modules.languages.sh,\ | |
| org.netbeans.modules.localhistory,\ | |
| org.netbeans.modules.mercurial,\ | |
| org.netbeans.modules.project.ant,\ | |
| org.netbeans.modules.project.libraries,\ | |
| org.netbeans.modules.properties,\ | |
| org.netbeans.modules.properties.syntax,\ | |
| org.netbeans.modules.schema2beans,\ | |
| org.netbeans.modules.sendopts,\ | |
| org.netbeans.modules.server,\ | |
| org.netbeans.modules.servletapi,\ | |
| org.netbeans.modules.subversion,\ | |
| org.netbeans.modules.tasklist.kit,\ | |
| org.netbeans.modules.tasklist.projectint,\ | |
| org.netbeans.modules.tasklist.todo,\ | |
| org.netbeans.modules.tasklist.ui,\ | |
| org.netbeans.modules.timers,\ | |
| org.netbeans.modules.usersguide,\ | |
| org.netbeans.modules.utilities,\ | |
| org.netbeans.modules.utilities.project,\ | |
| org.netbeans.modules.versioning,\ | |
| org.netbeans.modules.versioning.system.cvss,\ | |
| org.netbeans.modules.versioning.util,\ | |
| org.netbeans.modules.web.flyingsaucer,\ | |
| org.netbeans.modules.xml,\ | |
| org.netbeans.modules.xml.axi,\ | |
| org.netbeans.modules.xml.core,\ | |
| org.netbeans.modules.xml.lexer,\ | |
| org.netbeans.modules.xml.multiview,\ | |
| org.netbeans.modules.xml.retriever,\ | |
| org.netbeans.modules.xml.schema.completion,\ | |
| org.netbeans.modules.xml.schema.model,\ | |
| org.netbeans.modules.xml.tax,\ | |
| org.netbeans.modules.xml.text,\ | |
| org.netbeans.modules.xml.tools,\ | |
| org.netbeans.modules.xml.wsdl.model,\ | |
| org.netbeans.modules.xml.xam,\ | |
| org.netbeans.modules.xml.xdm,\ | |
| org.netbeans.modules.xsl,\ | |
| org.netbeans.spi.debugger.ui,\ | |
| org.netbeans.spi.viewmodel,\ | |
| org.netbeans.swing.dirchooser,\ | |
| org.openide.compat,\ | |
| org.openide.util.enumerations | |
| enabled.clusters=\ | |
| gsf1,\ | |
| ide9,\ | |
| platform8 | |
| nbplatform.active=default</pre> | |
| </li></ul></li> | |
| <p>Agora, você possui o subconjunto de módulos do NetBeans que são relevantes ao Editor de HTML. Entretanto, embora você precise dos módulos que possui agora, provavelmente não precisa de todos os elementos de interface de usuário que esses módulos fornecem. Nas próximas seções, você irá ajustar a interface do usuário e personalizar o layout da janela especificamente para o Editor de HTML que está criando. | |
| <!-- ===================================================================================== --> | |
| </p><h2 class="tutorial"><a name="tweakingthemenuitems"></a>Otimizando a interface de usuário</h2> | |
| <p>Você pode manter ou rejeitar o quanto desejar da interface do usuário que os módulos selecionados fornecerem. Por exemplo, seu editor HTML provavelmente não precisa de um ou todos os itens do menu Ferramentas. Semelhantemente, talvez haja barras de ferramentas ou botões da barra de ferramentas que não sejam necessários. Nesta seção, você remove a interface de usuário do IDE até que haja um subconjunto que seja útil para o seu aplicativo rich-client. | |
| </p><ol><li>Expanda o projeto de aplicativo da Plataforma Netbeans, clique com o botão direito do mouse no nó Módulos e escolha Adicionar novo, como mostrado abaixo:</p> | |
| <p><img border="1" src="../../images/tutorials/htmleditor/add-module-61.png" alt="Esta camada no contexto"> | |
| </p><p>O assistente para Novo projeto (Ctrl+Shift+N) aparece. | |
| Nomeie o projeto como <tt>BrandingModule</tt>, clique em Próximo. | |
| </p></li><li>No campo Nome de base de código, digite <tt>org.netbeans.brandingmodule</tt>. | |
| </li><li>No campo Camada XML, digite o nome do seu pacote, anexado de "layer.xml", como "org/netbeans/brandingmodule/layer.xml" e clique em Terminar. | |
| <p><b class="notes">Observação:</b> se você não digitar o local do arquivo layer.xml neste campo, o arquivo não será criado. Neste caso, crie um arquivo chamado "layer.xml" no pacote principal e registre-o manualmente no Manifesto do módulo da seguinte maneira: | |
| </p><p></p><pre>OpenIDE-Module-Layer: org/netbeans/brandingmodule/layer.xml</pre> | |
| </li><li>No módulo de identificação de marca, expanda o nó <tt>layer.xml</tt>. Dois subnós são expostos:</p> | |
| <p><img border="1" src="../../images/tutorials/htmleditor/expanded-xml-layer-61.png" alt="Arquivo de camada XML expandido"> | |
| </p><p><b class="notes">Observação:</b> caso você tenha adicionado manualmente o arquivo layer.xml, precisará expandir o nó Arquivos importantes para poder expandir o nó Camada XML encontrado nele. | |
| </p></li><li>No nó <tt><esta camada em contexto></tt>, o IDE mostra uma visualização mesclada de todas as pastas e arquivo que todos os módulos registram em suas camadas. Para excluir os itens, você pode clicar com o botão direito do mouse neles e escolher 'Excluir', como mostrado abaixo:</p> | |
| <p><img border="1" src="../../images/tutorials/htmleditor/this-layer-in-context-61.png" alt="Esta camada no contexto"> | |
| </p><p>O IDE adiciona marcas ao arquivo <tt>layer.xml</tt> do módulo que, quando o módulo é instalado, oculta os itens que você excluiu. Por exemplo, clicando com o botão direito do mouse em <tt>Barra de menus/Editar</tt>, você pode remover itens de menu do menu Editar que não são necessários para o Editor HTML. | |
| Fazendo isso, você gera trechos de código como o seguinte no arquivo <tt>layer.xml</tt>: | |
| </p><pre class="examplecode"><folder name="Menu"> | |
| <folder name="Edit"> | |
| <file name="org-netbeans-modules-editor-MainMenuAction$StartMacroRecordingAction.instance_hidden"/> | |
| <file name="org-netbeans-modules-editor-MainMenuAction$StopMacroRecordingAction.instance_hidden"/> | |
| </folder> | |
| </folder></pre> | |
| <p> | |
| O resultado do trecho de código acima é que as ações <tt>Iniciar gravação de macro</tt> e <tt>Parar gravação de macro</tt> fornecidas por outro módulo são removidas do menu por seu módulo de marca. Para exibi-las novamente, simplesmente exclua as marcas acima do arquivo <tt>layer.xml</tt>. | |
| </p></li><li><p>Use a abordagem descrita na etapa anterior para ocultar as barras de ferramentas, os botões da barra de ferramentas, os menus e os itens de menu que você desejar.</p> | |
| <p>Quando tiver concluído este estágio, observe o arquivo <tt>layer.xml</tt>. Quando fizer isso, verá algo similar ao seguinte, dependendo dos itens que tenha excluído:</p> | |
| <p></p><pre><?xml version="1.0" encoding="UTF-8"?> | |
| <!DOCTYPE filesystem PUBLIC "-//NetBeans//DTD Filesystem 1.1//EN" "https://netbeans.org/dtds/filesystem-1_1.dtd"> | |
| <filesystem> | |
| <folder name="Menu"> | |
| <file name="BuildProject_hidden"/> | |
| <folder name="File"> | |
| <file name="Separator2.instance_hidden"/> | |
| <file name="SeparatorNew.instance_hidden"/> | |
| <file name="SeparatorOpen.instance_hidden"/> | |
| <file name="org-netbeans-modules-project-ui-CloseProject.shadow_hidden"/> | |
| <file name="org-netbeans-modules-project-ui-CustomizeProject.shadow_hidden"/> | |
| <file name="org-netbeans-modules-project-ui-NewFile.shadow_hidden"/> | |
| <file name="org-netbeans-modules-project-ui-NewProject.shadow_hidden"/> | |
| <file name="org-netbeans-modules-project-ui-OpenProject.shadow_hidden"/> | |
| <file name="org-netbeans-modules-project-ui-RecentProjects.shadow_hidden"/> | |
| <file name="org-netbeans-modules-project-ui-SetMainProject.shadow_hidden"/> | |
| <file name="org-netbeans-modules-project-ui-groups-GroupsMenu.shadow_hidden"/> | |
| </folder> | |
| <file name="Refactoring_hidden"/> | |
| <file name="RunProject_hidden"/> | |
| <folder name="Window"> | |
| <file name="ViewRuntimeTabAction.shadow_hidden"/> | |
| <file name="org-netbeans-modules-project-ui-logical-tab-action.shadow_hidden"/> | |
| <file name="org-netbeans-modules-project-ui-physical-tab-action.shadow_hidden"/> | |
| </folder> | |
| </folder> | |
| </filesystem></pre> | |
| </li></ol> | |
| <!-- ===================================================================================== --> | |
| <h2 class="tutorial"><a name="tweakingthewindowlayout"></a>Otimizando o layout da janela</h2> | |
| <p> | |
| Usando o nó <tt><esta camada em contexto></tt>, você pode não somente excluir itens existentes, mas também pode alterar o conteúdo deles. Por exemplo, o Editor HTML trabalha em arquivos HTML, sendo assim, ao contrário do IDE regular, que trabalha com arquivos-fonte Java e projetos, faz sentido mostrar a janela <tt>Favoritos</tt> no layout inicial. | |
| </p> | |
| <p> | |
| A definição do layout da janela também é descrita como arquivos em camadas, tudo armazenado na pasta <tt>Janelas2</tt>. Os arquivos na pasta <tt>Janelas2</tt> são arquivos XML pseudo-legíveis por humanos definidos pelas <a href="http://bits.netbeans.org/dev/javadoc/org-openide-windows/org/openide/windows/doc-files/api.html">APIs do sistema de janelas</a>. Eles são complexos mas a boa notícia é que, para fins do nosso Editor HTML, não é necessário compreendê-los completamente, como mostrado abaixo. | |
| </p> | |
| <ol><li>Em seu nó <tt><esta camada em contexto></tt> do módulo de marca, clique com o botão direito do mouse no nó <tt>Janelas2</tt> e escolha Localizar, como mostrado abaixo:</p> | |
| <p><img border="1" src="../../images/tutorials/htmleditor/find-favorites-61.png" alt="Chamando o menu Localizar"> | |
| </p></li><li>Procure por um objeto chamado <tt>Favoritos</tt>, ignorando o uso de maiúsculas/minúsculas. Você encontrará dois arquivos: | |
| </p> | |
| <p><img border="1" src="../../images/tutorials/htmleditor/find-favorites2-61.png" alt="Localizando a janela Favoritos"> | |
| </p><p> | |
| O primeiro arquivo define a aparência do componente e como ele é criado. Como o componente não precisa ser alterado, não é necessário modificar o arquivo. O segundo é mais interessante para os seus propósitos, ele contém o seguinte: | |
| </p> | |
| <pre class="examplecode"> | |
| <tc-ref version="2.0"> | |
| <module name="org.netbeans.modules.favorites/1" spec="1.1" /> | |
| <tc-id id="favorites" /> | |
| <state opened="false" /> | |
| </tc-ref></pre> | |
| <p> | |
| </p></li><li>Embora a maior parte do XML seja criptografada, existe uma linha que parece promissora — sem precisar ler nenhum tipo de documentação, é provável que alterar <tt>false</tt> para <tt>true</tt> tornará o componente aberto por padrão. Faça isso agora. | |
| </li><li> | |
| De forma similar, você pode alterar as janelas a seguir do seu estado aberto padrão para o estado que você deseja que elas se comportem no Editor de HTML: | |
| <ul> | |
| <li><tt>CommonPalette.wstcref</tt>. O estado aberto da Paleta de componentes é <tt>false</tt>. Trocar para <tt>true</tt>. | |
| </li><li><tt>navigatorTC.wstcref</tt>. O estado aberto do Navegador é <tt>true</tt>. Trocar para <tt>false</tt>. | |
| </li><li><tt>projectTabLogical_tc.wstcref</tt>. O estado aberto da janela Projetos é <tt>true</tt>. Trocar para <tt>false</tt>. | |
| </li><li><tt>projectTab_tc.wstcref</tt>. O estado aberto da janela Arquivos é <tt>true</tt>. Trocar para <tt>false</tt>. | |
| </li><li><tt>runtime.wstcref</tt>. O estado aberto da janela Serviços é <tt>true</tt>. Trocar para <tt>false</tt>. | |
| </li></ul> | |
| </li></ol> | |
| <p>Agora você deve ver que o seu módulo de marca contém alguns novos arquivos, um para cada um dos arquivos que você alterou. Na verdade, esses arquivos substituem aqueles que você encontrou nas etapas anteriores, sendo que agora você forneceu as informações necessárias para substituir o layout da janela:</p> | |
| <p><img border="1" src="../../images/tutorials/htmleditor/wstcrefs-overridden-61.png" alt="Layout substituído em Favoritos"> | |
| </p><p>Verifique se o arquivo <tt>layer.xml</tt> agora contém o conteúdo a seguir. Caso não contenha, copie e cole o conteúdo abaixo no arquivo <tt>layer.xml</tt>. | |
| </p><pre><?xml version="1.0" encoding="UTF-8"?> | |
| <!DOCTYPE filesystem PUBLIC "-//NetBeans//DTD Filesystem 1.1//EN" "https://netbeans.org/dtds/filesystem-1_1.dtd"> | |
| <filesystem> | |
| <folder name="Menu"> | |
| <file name="BuildProject_hidden"/> | |
| <folder name="File"> | |
| <file name="Separator2.instance_hidden"/> | |
| <file name="SeparatorNew.instance_hidden"/> | |
| <file name="SeparatorOpen.instance_hidden"/> | |
| <file name="org-netbeans-modules-project-ui-CloseProject.shadow_hidden"/> | |
| <file name="org-netbeans-modules-project-ui-CustomizeProject.shadow_hidden"/> | |
| <file name="org-netbeans-modules-project-ui-NewFile.shadow_hidden"/> | |
| <file name="org-netbeans-modules-project-ui-NewProject.shadow_hidden"/> | |
| <file name="org-netbeans-modules-project-ui-OpenProject.shadow_hidden"/> | |
| <file name="org-netbeans-modules-project-ui-RecentProjects.shadow_hidden"/> | |
| <file name="org-netbeans-modules-project-ui-SetMainProject.shadow_hidden"/> | |
| <file name="org-netbeans-modules-project-ui-groups-GroupsMenu.shadow_hidden"/> | |
| </folder> | |
| <file name="Refactoring_hidden"/> | |
| <file name="RunProject_hidden"/> | |
| <folder name="Window"> | |
| <file name="ViewRuntimeTabAction.shadow_hidden"/> | |
| <file name="org-netbeans-modules-project-ui-logical-tab-action.shadow_hidden"/> | |
| <file name="org-netbeans-modules-project-ui-physical-tab-action.shadow_hidden"/> | |
| </folder> | |
| </folder> | |
| <folder name="Windows2"> | |
| <folder name="Modes"> | |
| <folder name="commonpalette"> | |
| <file name="CommonPalette.wstcref" url="CommonPaletteWstcref.xml"/> | |
| </folder> | |
| <folder name="explorer"> | |
| <file name="favorites.wstcref" url="favoritesWstcref.xml"/> | |
| <file name="projectTabLogical_tc.wstcref" url="projectTabLogical_tcWstcref.xml"/> | |
| <file name="projectTab_tc.wstcref" url="projectTab_tcWstcref.xml"/> | |
| <file name="runtime.wstcref" url="runtimeWstcref.xml"/> | |
| </folder> | |
| <folder name="navigator"> | |
| <file name="navigatorTC.wstcref" url="navigatorTCWstcref.xml"/> | |
| </folder> | |
| </folder> | |
| </folder> | |
| </filesystem></pre> | |
| <!-- ===================================================================================== --> | |
| <h2 class="tutorial"><a name="tweakingthefavorites"></a>Otimizando a janela Favoritos</h2> | |
| <p> | |
| Na subpasta de uma pasta de <tt>marca</tt> projeto de aplicativo da Plataforma NetBeans, que esteja visível na janela Arquivos, você pode substituir as strings definidas nos códigos-fonte do NetBeans. Nesta seção, você substituirá as strings que definem os rótulos usados na janela Favoritos. Por exemplo, alteraremos o rótulo "Favoritos" para "Arquivos HTML", pois usaremos essa janela especificamente para arquivos HTML. | |
| </p> | |
| <ol><li>Abra a janela Arquivos e expanda a pasta de <tt>marca</tt> do projeto de aplicativo da Plataforma NetBeans. | |
| </li><li>Crie uma nova estrutura de pastas em <tt>marca/módulos</tt>. | |
| A nova pasta deve se chamar <tt>org-netbeans-modules-favorites.jar</tt>. | |
| Dentro dessa pasta, crie uma hierarquia de pastas <tt>org/netbeans/módulos/favoritos</tt>. Dentro da pasta final, ou seja, <tt>favoritos</tt>, crie um novo arquivo <tt>Bundle.properties</tt>. | |
| <p><img border="1" src="../../images/tutorials/htmleditor/favorites-branding-61a.png" alt="Marcando a janela Favoritos"> | |
| </p><p>Essa estrutura de pastas e arquivo de propriedades correspondem à | |
| estrutura de pastas nos códigos-fonte do NetBeans relacionados à janela Favoritos. | |
| </p></li><li>Adicione as strings mostradas na captura de tela abaixo para substituir as mesmas strings definidas no arquivo de propriedades correspondentes nos códigos-fonte da janela Favoritos:</p> | |
| <p><img border="1" src="../../images/tutorials/htmleditor/favorites-branding-61b.png" alt="Marcando a janela Favoritos"> | |
| </p><p>Para simplificar esta etapa, copie e cole as strings definidas acima: | |
| </p><pre>Favorites=HTML Files | |
| ACT_AddOnFavoritesNode=&Find HTML Files... | |
| ACT_Remove=&Remove from HTML Files List | |
| ACT_View=HTML Files | |
| ACT_Select=HTML Files | |
| ACT_Select_Main_Menu=Select in HTML Files List | |
| # JFileChooser | |
| CTL_DialogTitle=Add to HTML Files List | |
| CTL_ApproveButtonText=Add | |
| ERR_FileDoesNotExist={0} does not exist. | |
| ERR_FileDoesNotExistDlgTitle=Add to HTML Files List | |
| MSG_NodeNotFound=The document node could not be found in the HTML Files List.</pre> | |
| </li></ol> | |
| <!-- ===================================================================================== --> | |
| <h2 class="tutorial"><a name="runningtheapplication"></a>Executando o aplicativo</h2> | |
| <p> | |
| Executar o seu aplicativo é tão simples quando clicar com o botão direito do mouse no nó do projeto e escolher um item de menu. | |
| </p> | |
| <ol> | |
| <li>Clique com o botão direito do mouse no nó do projeto do aplicativo e escolha Limpar e construir tudo. | |
| </li><li>Clique com o botão direito do mouse no nó do projeto de aplicativo e escolha Executar: | |
| </li><li>Depois que a aplicação é implantada, você pode clicar com o botão direito do mouse dentro da janela Favoritos e escolher uma pasta contendo arquivos HTML e, em seguida, abrir um arquivo HTML, como mostrado abaixo:</p> | |
| <img src="../../images/tutorials/htmleditor/html_editor_final-61.png" border="1" alt="Abrir arquivo HTML"> | |
| </li></ol> | |
| <!-- ===================================================================================== --> | |
| <!-- ===================================================================================== --> | |
| <h2 class="tutorial"><a name="distributingtheapplication"></a>Distribuindo o aplicativo</h2> | |
| <p> | |
| Escolha uma das duas abordagens para distribuir o aplicativo. Se você desejar manter o máximo possível de controle sobre o aplicativo, use o web start para distribuir o aplicativo na web. Neste cenário, sempre que você desejar atualizar o aplicativo, irá fazer isso localmente e permitir que os usuários finais saibam sobre a atualização, que estará disponível automaticamente para eles na próxima vez que iniciarem o aplicativo na web. Como alternativa, distribua um arquivo ZIP contendo seu aplicativo. Os usuários finais terão, assim, o aplicativo completo localmente disponível. Distribua então as atualizações e os novos recursos através do mecanismo de atualização, descrito abaixo. | |
| </p><h3 class="tutorial"><a name="zip"></a>Distribuindo o aplicativo através de um arquivo ZIP</h3> | |
| <p> Para estender seu aplicativo, você deve permitir que os usuários instalem módulos para aprimorar a funcionalidade do aplicativo. Para fazer isso, você precisa simplesmente ativar alguns módulos extras, que empacotarão o gerenciador de plug-ins com o seu Editor HTML. | |
| </p> | |
| <ol><li>Clique com o botão direito do mouse no projeto de aplicativo da Plataforma NetBeans e escolha Propriedades. Na caixa de diálogo Propriedades do projeto, use o painel Bibliotecas e marque as caixas de verificação <tt>Centrais de atualização</tt>, <tt>Serviços de atualização automática</tt> e <tt>UI de atualização automática</tt> realçadas abaixo:</p> | |
| <p><img border="1" src="../../images/tutorials/htmleditor/auto-update-61.png" alt="Atualização automática de módulos"> | |
| </p></li><li>Clique com o botão direito do mouse no nó do projeto do aplicativo e escolha Limpar e construir tudo. | |
| </li><li>Execute o aplicativo e observe que agora você tem um novo item de menu, chamado "Plug-ins", no menu Ferramentas:</p> | |
| <img src="../../images/tutorials/htmleditor/auto-update2-61.png" border="1" alt="Mostrando o gerenciador de plug-ins"> | |
| </li><li>Escolha o nome item de menu Plug-ins e instale alguns plug-ins que sejam úteis para seu Editor HTML. | |
| Navegue no <a href="http://plugins.netbeans.org/PluginPortal/">Portal Plug-in</a> para localizar alguns que sejam adequados. É desta mesma forma que os usuários finais atualizarão sua instalação local do aplicativo. | |
| </li><li><p>Clique com o botão direito do mouse no nó do conjunto de aplicativo e escolha Build ZIP Distribution.</p> | |
| </li><li>Na pasta <tt>dist</tt> (visível na janela Arquivos), você agora deve ser capaz de ver um arquivo ZIP que pode ser expandido, para exibição de seu conteúdo:</p> | |
| <p><img border="1" src="../../images/tutorials/htmleditor/unzipped-app-61.png" alt="Arquivo ZIP gerado"> | |
| </p><p><b class="notes">Observação:</b> o iniciador do aplicativo é criado na pasta <tt>bin</tt>, como mostrado acima. | |
| </p></li> | |
| <br /> | |
| <!-- ======================================================================================== --> | |
| <h3><a name="webstart"></a>Distribuindo o editor HTML por meio do Repositório Web Start compartilhado do NetBeans</h3> | |
| <p> | |
| Em vez de distribuir um arquivo ZIP, vamos preparar para uma distribuição webstart fazendo ajustes finos no arquivo <tt>master.jnlp</tt> que é gerado na primeira vez que o aplicativo é iniciado. Embora ele faça o trabalho, ele não está pronto para distribuição. Pelo menos, você precisa alterar a seção de informações para fornecer melhores descrições e ícones. | |
| </p><p> | |
| Outra alteração na infra-estrutura JNLP padrão é o uso de um repositório JNLP compartilhado em www.netbeans.org. Por padrão, a aplicação JNLP gerada para um conjunto sempre contém todos os seus módulos, assim como os módulos do qual ela depende. | |
| Isso pode ser útil para uso de intranet, mas é um pouco menos prático para uso amplo na internet. Na internet, é muito melhor se todos os aplicativos construídos na Plataforma NetBeans se referirem a um repositório de módulos do NetBeans, o que significa que tais módulos são compartilhados e não precisam ser baixados mais de uma vez. | |
| </p> | |
| <p> | |
| Existe um repositório como tal para NetBeans 6.1. Ele não contém todos os módulos que o NetBeans IDE possui, mas ele contém o suficiente para criar aplicativos não-IDE como o nosso editor HTML. Para usar o repositório, você só precisa modificar <tt>platform.properties</tt> adicionando a URL correta: | |
| </p> | |
| <pre class="examplecode"> | |
| # share the libraries from common repository on netbeans.org | |
| # this URL is for release60 JNLP files: | |
| jnlp.platform.codebase=https://netbeans.org/download/6_0/jnlp/ | |
| </pre> | |
| <p> | |
| Assim que o aplicativo é iniciado como um aplicativo JNLP, todos os seus módulos de plug-in compartilhados são carregados a partir de netbeans.org e compartilhados com os aplicativos que fazem o mesmo.</p> | |
| <br /> | |
| <!-- ======================================================================================== --> | |
| <br> | |
| <div class="feedback-box"><a href="https://netbeans.org/about/contact_form.html?to=3&subject=Feedback:%20NetBeans%20Platform%206.1%20Quick%20Start%20Tutorial">Envie-nos seus comentários</a></div> | |
| <br style="clear:both;" /> | |
| <!-- ======================================================================================== --> | |
| <h2><a name="nextsteps"></a>Veja também</h2> | |
| <p>Isto conclui o Início rápido da Plataforma NetBeans. Este documento descreveu como criar um plug-in que adiciona uma barra de ferramentas do Google Search ao IDE. | |
| Para obter mais informações sobre a criação e o desenvolvimento de aplicativos na Plataforma NetBeans, consulte os seguintes recursos: | |
| </p><ul> | |
| <p></p><li><a href="https://netbeans.org/kb/trails/platform.html">Outros tutoriais relacionados</a></li> | |
| <p></p><li><a href="https://netbeans.org/download/dev/javadoc/">Javadoc da API da NetBeans </a></li> | |
| </ul> | |
| <hr> | |
| <!-- ======================================================================================== --> | |
| </ol></ol></body> | |
| </html> |