netbeans.apache.org/src/content/kb/docs/java/native_pkg_pt_BR.asciidoc - netbeans-website - Git at Google

 //
 //     Licensed to the Apache Software Foundation (ASF) under one
 //     or more contributor license agreements.  See the NOTICE file
 //     distributed with this work for additional information
 //     regarding copyright ownership.  The ASF licenses this file
 //     to you under the Apache License, Version 2.0 (the
 //     "License"); you may not use this file except in compliance
 //     with the License.  You may obtain a copy of the License at
 //
 //       http://www.apache.org/licenses/LICENSE-2.0
 //
 //     Unless required by applicable law or agreed to in writing,
 //     software distributed under the License is distributed on an
 //     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 //     KIND, either express or implied.  See the License for the
 //     specific language governing permissions and limitations
 //     under the License.
 //

 = Encapsulamento Nativo no NetBeans IDE
 :jbake-type: tutorial
 :jbake-tags: tutorials
 :jbake-status: published
 :icons: font
 :syntax: true
 :source-highlighter: pygments
 :toc: left
 :toc-title:
 :description: Encapsulamento Nativo no NetBeans IDE - Apache NetBeans
 :keywords: Apache NetBeans, Tutorials, Encapsulamento Nativo no NetBeans IDE

 Escrito por Petr Somol e Alyona Stashkova

 O encapsulamento nativo foi apresentado pela primeira vez como parte do JavaFX 2.2 SDK, permitindo que você encapsule uma aplicação como um _encapsulamento nativo_ e, em seguida, instale e execute a aplicação sem nenhuma dependência em um sistema JRE ou JavaFX SDK. Em seguida, ele se tornará utilizável também para projetos Java SE.

 O encapsulamento nativo não altera o modelo de implantação de sua aplicação: ele usa a aplicação como está, encapsula com runtime de Java e produz um instalador que é comum para o sistema operacional que você está usando. O ponto principal é criar uma única ação não importando o runtime de Java que os usuários têm na máquina-alvo. Você pode usar um instalador e executá-lo em uma máquina na qual não há rastreamento de Java. Isso instalará a aplicação e os bits de runtime Java necessários. O tamanho desses instaladores é bem grande porque mesmo uma aplicação "Hello world" transportará uma parte grande de artefatos de runtime Java.

 Neste tutorial, você criará um instalador  ``EXE``  de uma aplicação Java SE e um instalador  ``MSI``  para uma aplicação JavaFX para o sistema operacional Windows, com base nas aplicações de amostra encapsuladas com o IDE.

 *Observação:*

 * Os instaladores  ``EXE``  e  ``MSI``  que você obtém são específicos da plataforma; eles só serão executados em um sistema compatível com a plataforma Java de destino cujos pacotes  ``EXE`` / ``MSI``  instaláveis foram criados. (Por exemplo, se um instalador  ``EXE``  ou  ``MSI``  foi criado em uma máquina com um JDK de 64 bits instalado, ele deverá ser executado em uma máquina com Windows de 64 bits instalado).
 * No Windows, ambas as aplicações são instaladas no diretório  ``C:\Users\<username>\AppData\Local\``  e estão disponíveis no menu Iniciar.


 image::images/netbeans-stamp-80-74.png[title="O conteúdo desta página se aplica ao NetBeans IDE 7.4 ou 8.0"]


 *Para seguir este tutorial, são necessários os recursos e o software a seguir.*

 |===
 |Software ou Recurso |Versão Necessária

 |link:http://netbeans.org/downloads/index.html[+NetBeans IDE+] |7.4 ou 8.0

 |link:http://www.oracle.com/technetwork/java/javafx/downloads/index.html[+JDK (Java Development Kit)+] |7 atualização 25 (ou mais recente) ou 8

 |link:http://www.jrsoftware.org/[+Inno Setup+] |5.5 ou versão mais recente

 |link:http://wixtoolset.org/[+WiX+] |3.7 ou versão mais recente
 |===


 == Instalando e Adicionando as Ferramentas Necessárias ao Caminho

 Para usar o suporte do IDE para encapsulamento nativo, as seguintes ferramentas adicionais precisam ser instaladas:

 * O link:http://www.jrsoftware.org/[+Inno Setup 5.5+] (ou uma versão mais recente) para produzir instaladores EXE no Windows é obrigatório.
 * O link:http://wixtoolset.org/[+WiX 3.7+] (ou uma versão mais recente) para produzir instaladores MSI no Windows é obrigatório.

 *Observação:* para obter uma lista de ferramentas obrigatórias para criar instaladores para diferentes plataformas, consulte "link:http://www.oracle.com/pls/topic/lookup?ctx=nb7400&id=NBDAG2508[+Encapsulando uma Aplicação como um Instalador Nativo+]" em _Desenvolvendo Aplicações com o NetBeans IDE_.

 *Para instalar o Inno Setup:*

 1. Faça Download do  ``ispack-5.5.3.exe``  na página link:http://www.jrsoftware.org/isdl.php[+Downloads do Inno Setup+]
 2. Clique duas vezes no arquivo para iniciar o instalador.
 3. Aceite o contrato de licença do Inno Setup e clique em Próximo.
 4. Siga as instruções do assistente de instalação para instalar o Inno Setup.

 *Para instalar o WiX:*

 1. Faça download do  ``wix37.exe``  na página link:http://wix.codeplex.com/releases/view/99514[+WiX Toolset - Download+].
 2. Clique duas vezes no arquivo para iniciar o instalador.
 3. Siga as instruções do assistente de instalação para instalar o WiX.

 *Para adicionar o Inno Setup e/ou WiX à variável Path do sistema:*

 1. No Windows 7, selecione Iniciar > Computador > Propriedades do Sistema > Configurações avançadas do sistema.
 2. Selecione a guia Avançado e clique no botão Variáveis de Ambiente.
 3. No painel Variáveis do Sistema, clique duas vezes na variável Path.
 4. Na caixa de diálogo Editar Variável do Sistema, adicione um ponto-e-vírgula seguido de um novo caminho ao campo Valor da variável (por exemplo,  ``C:\Arquivos de Programa (x86)\Inno Setup 5 ``  ou  ``C:\Arquivos de Programa (x86)\WiX Toolset v3.6\bin`` ).
 5. Clique em OK para fechar todas as caixas de diálogo abertas.

 *Observações:*

 * Para verificar se a ferramenta instalada está no Path, abra a janela Prompt de Comando e digite  ``iscc.exe``  para Inno Setup ou  ``candle.exe``  para WiX. (Se o Prompt de Comando for fechado instantaneamente, tente especificar  ``cmd.exe /c cmd.exe /k iscc.exe``  ou  ``cmd.exe /c cmd.exe /k candle.exe``  respectivamente.)
 A figura a seguir mostra o que o Prompt de Comando deve exibir, caso o Inno Setup seja adicionado à variável Path do sistema.

 [.feature]
 --
 image::images/cmd_small.png[role="left", link="images/cmd.png"]
 --

 * Certifique-se de que o IDE tenha sido reiniciado após as ferramentas serem adicionadas à variável Path do sistema.


 == Encapsulamento Nativo nos Projetos Java SE

 Para utilizar o suporte de encapsulamento nativo no IDE, é necessário concluir o seguinte:

 * <<createse,criar um projeto IDE>>
 * <<enable,ativar as ações de encapsulamento nativo no projeto>>
 * <<buildse,limpar e construir o projeto>>
 * <<instse,encapsular uma aplicação em um instalador>>


 === Configurando um Projeto Java SE

 Antes de encapsular uma aplicação em um instalador, é necessário criar uma aplicação.

 Você criará um novo projeto Java SE com o exemplo do jogo de Anagramas que é enviado com o NetBeans IDE.

 *Para criar um projeto do IDE:*

 1. No IDE, escolha Arquivo > Novo Projeto.
 2. No assistente Novo Projeto, expanda a categoria Amostras e selecione Java.
 3. Escolha o Jogo de Anagramas na lista Projetos. Em seguida, clique em Próximo.

 [.feature]
 --
 image::images/new_javase_prj_small.png[role="left", link="images/new_javase_prj.png"]
 --


 . No painel Nome e Local, deixe os valores default para os campos Nome do Projeto e Localização do Projeto.


 . Clique em Finalizar.
 O IDE cria e abre o projeto Java SE.

 Para testar se o projeto criado funciona, execute-o escolhendo Executar > Executar Projeto no menu principal.
 A aplicação Anagramas deve ser iniciada e exibida em sua máquina.

 image::images/anagrams.png[]


 === Ativando Encapsulamento Nativo no IDE

 As ações do encapsulamento nativo são desativadas no IDE, por default.

 Clique com o botão direito do mouse no projeto AnagramGame na janela Projetos, para verificar as ações disponíveis para o projeto Java SE criado no IDE: não há ações relacionadas ao pacote no menu de contexto do projeto.

 image::images/context_wo_pkg.png[]

 *Para ativar as ações de encapsulamento nativo do projeto:*

 1. Clique com o botão direito do mouse no nó do projeto na janela Projetos e selecione as Propriedades no menu de contexto.
 2. Na caixa de diálogo Propriedades do Projeto, escolha a categoria Implantação e selecione Ativar Ações de Encapsulamento Nativo na opção Menu do Projeto.

 [.feature]
 --
 image::images/enable_native_pkg_small.png[role="left", link="images/enable_native_pkg.png"]
 --


 . Clique em OK.
 Um comando Encapsular como é adicionado ao menu de contexto do projeto.

 image::images/pkg_enabled.png[]


 === Construindo uma Aplicação

 É hora de limpar e construir sua aplicação para implantação.

 *Para limpar e construir seu projeto:*

 * Escolha Executar > Limpar e Construir Projeto do menu principal.
 O IDE exibe os resultados na janela de Saída.

 [.feature]
 --
 image::images/output_small.png[role="left", link="images/output.png"]
 --

 Uma pasta  ``dist``  que contém um arquivo  ``jar``  é criada na pasta do projeto.


 === Criando um Instalador  ``EXE``

 A aplicação agora pode ser encapsulada em um instalador para Windows.

 *Para construir um instalador  ``EXE`` :*

 * Clique com o botão direito do mouse no projeto AnagramGame e escolha Encapsular como > Instalador EXE do menu de contexto.

 *Observação:* o IDE só criará um instalador  ``EXE``  se o Inno Setup for <<tool,instalado e adicionado à variável Path do sistema>>.

 O IDE exibe o andamento e o resultado do processo de encapsulamento na janela de Saída.

 [.feature]
 --
 image::images/output_se_exe_small.png[role="left", link="images/output_se_exe.png"]
 --

 *Observação:* o IDE primeiro registra o progresso e, em seguida, durante um período verifica como se nada estivesse acontecendo - é exatamente neste momento em que o Inno Setup está trabalhando em segundo plano. Demora um pouco para o encapsulamento ser concluído.

 Quando o instalador  ``EXE``  estiver pronto, ele será colocado no diretório  ``AnagramGame/dist/bundles/`` .

 image::images/anagram_exe.png[]


 == Encapsulamento de Aplicação Autocontida nos Projetos JavaFX

 Para criar uma aplicação JavaFX instalável usando o suporte ao encapsulamento nativo no IDE, é necessário concluir o seguinte:

 * <<createfx,criar um projeto JavaFX no IDE>>
 * <<enablefx,ativar o suporte ao encapsulamento nativo para o projeto>>
 * <<buildfx,limpar e construir uma aplicação JavaFX>>
 * <<instfx,construir uma aplicação JavaFX instalável>>


 === Criando um Projeto JavaFX

 Você começa a criação de um projeto JavaFX usando o projeto de amostra BrickBreaker encapsulado com o IDE.

 *Para criar um projeto JavaFX no IDE:*

 1. No IDE, escolha Arquivo > Novo Projeto.
 2. No assistente Novo Projeto, expanda a categoria Amostras e selecione JavaFX.
 3. Escolha BrickBreaker na lista Projetos. Em seguida, clique em Próximo.
 4. No painel Nome e Local, deixe os valores default para os campos Nome do Projeto, Localização do Projeto e Plataforma JavaFX.

 [.feature]
 --
 image::images/new_javafx_prj_small.png[role="left", link="images/new_javafx_prj.png"]
 --


 . Clique em Finalizar.
 O projeto JavaFX do BrickBreaker é exibido na janela Projetos no IDE.

 Para testar se o projeto criado funciona, execute-o escolhendo Executar > Executar Projeto (BrickBreaker) no menu principal.
 A aplicação Brick Breaker deve ser iniciada e exibida em sua máquina.

 [.feature]
 --
 image::images/brickbreaker_small.png[role="left", link="images/brickbreaker.png"]
 --


 === Ativando Encapsulamento Nativo no Projeto

 Para usar o suporte ao encapsulamento nativo no IDE para seu projeto, é necessário ativá-lo primeiro.

 Se clicar com o botão direito no mouse no projeto Brick Breaker, você não verá nele ações relacionadas a encapsulamento nativo.

 image::images/javafx_wo_pkg.png[]

 *Para ativar as ações de encapsulamento nativo no menu de contexto do projeto:*

 1. Clique com o botão direito do mouse no nó do projeto na janela Projetos e selecione as Propriedades no menu de contexto.
 2. Na caixa de diálogo Propriedades do Projeto, escolha a categoria Construir e selecione a opção Ativar Encapsulamento Nativo.

 [.feature]
 --
 image::images/enable_native_pkg_fx_small.png[role="left", link="images/enable_native_pkg_fx.png"]
 --


 . Clique em OK.
 A opção Encapsular como item é adicionada ao menu de contexto do projeto.

 image::images/pkg_fx_enabled.png[]


 === Construindo uma Aplicação

 Sua aplicação JavaFX agora está pronta para ser limpa e construída.

 *Para limpar e construir seu projeto:*

 * Escolha Executar > Limpar e Construir Projeto do menu principal.
 O IDE exibe os resultados na janela de Saída.

 *Observação:* se a construção for bem-sucedida, mas o IDE exibir  ``advertência: [opções] caminho de classe de bootstrap não definido com -código-fonte 1.6``  na janela de Saída, o formato de Código-fonte/Binário precisará ser definido como JDK 8 nas propriedades do projeto e o projeto precisa ser limpo e construído novamente, como segue:

 1. Clique com o botão direito do mouse no projeto BrickBreaker na janela Projetos e escolha Propriedades.
 2. Na caixa de diálogo Propriedades do projeto, selecione a categoria Executar Códigos-fontes.
 3. Defina o formato Código-fonte/Binário para JDK 8 e clique em OK.
 4. Clique com o botão direito do mose na janela Projetos e escolha Limpar e Construir no menu de contexto.


 === Criando um Instalador  ``MSI``

 A aplicação agora pode ser encapsulada em um pacote instalável específico do Windows.

 *Para construir um instalador  ``MSI`` :*

 * Clique com o botão direito do mouse no projeto BrickBreaker e escolha Encapsular como > Instalador MSI do menu de contexto.

 *Observação:* o IDE cria um instalador  ``MSI``  somente se WiX for <<tool,instalada e adicionada à variável Path do sistema>>.

 O IDE exibe o andamento e o resultado do processo de encapsulamento na janela de Saída.

 [.feature]
 --
 image::images/output_fx_msi_small.png[role="left", link="images/output_fx_msi.png"]
 --

 *Observação:* o IDE primeiro registra o progresso e, em seguida, durante um período verifica como se nada estivesse acontecendo - é exatamente neste momento em que a WiX está trabalhando em segundo plano. Demora um pouco para o encapsulamento ser concluído.

 A aplicação JavaFX instalável está localizada no diretório  ``BrickBreaker/dist/bundles/`` .

 image::images/brickbreaker_msi.png[]


 == [[Verificando as Aplicações Instaláveis]]

 Quando os instaladores de  ``AnagramGame-1.0.exe``  e  ``BrickBreaker-1.0.msi``  forem concluídos, você precisará em qual diretório as aplicações Anagram e BrickBreaker foram instaladas.

 *Para verificar os instaladores:*

 1. Procure o arquivo do instalador ( ``AnagramGame-1.0.exe``  ou  ``BrickBreaker-1.0.msi`` ) em seu disco rígido.
 2. Clique duas vezes para executar o instalador.

 As duas aplicações devem ser instaladas no diretório  ``C:\Users\<username>\AppData\Local\``  e devem estar disponíveis no menu Iniciar.


 == Consulte Também

 * link:http://www.oracle.com/pls/topic/lookup?ctx=nb8000&id=NBDAG2508[+Encapsulando uma Aplicação como um Instalador Nativo+] em _Desenvolvendo Aplicações com o NetBeans IDE_
 * link:http://docs.oracle.com/javafx/2/deployment/self-contained-packaging.htm[+Implantando Aplicações JavaFX: Encapsulamento da Aplicação Autocontida+]
 * link:http://docs.oracle.com/javase/7/docs/technotes/guides/jweb/packagingAppsForMac.html[+Encapsulando uma Aplicação Java para Distribuição em uma Máquina+]
 link:/about/contact_form.html?to=3&subject=Feedback:%20Native%20Packaging%20In%20NetBeans%20IDE[+Enviar Feedback neste Tutorial+]


 link:../../trails/matisse.html[+Voltar à Trilha do Aprendizado+]
	//
	// Licensed to the Apache Software Foundation (ASF) under one
	// or more contributor license agreements. See the NOTICE file
	// distributed with this work for additional information
	// regarding copyright ownership. The ASF licenses this file
	// to you under the Apache License, Version 2.0 (the
	// "License"); you may not use this file except in compliance
	// with the License. You may obtain a copy of the License at
	//
	// http://www.apache.org/licenses/LICENSE-2.0
	//
	// Unless required by applicable law or agreed to in writing,
	// software distributed under the License is distributed on an
	// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
	// KIND, either express or implied. See the License for the
	// specific language governing permissions and limitations
	// under the License.
	//

	= Encapsulamento Nativo no NetBeans IDE
	:jbake-type: tutorial
	:jbake-tags: tutorials
	:jbake-status: published
	:icons: font
	:syntax: true
	:source-highlighter: pygments
	:toc: left
	:toc-title:
	:description: Encapsulamento Nativo no NetBeans IDE - Apache NetBeans
	:keywords: Apache NetBeans, Tutorials, Encapsulamento Nativo no NetBeans IDE

	Escrito por Petr Somol e Alyona Stashkova

	O encapsulamento nativo foi apresentado pela primeira vez como parte do JavaFX 2.2 SDK, permitindo que você encapsule uma aplicação como um _encapsulamento nativo_ e, em seguida, instale e execute a aplicação sem nenhuma dependência em um sistema JRE ou JavaFX SDK. Em seguida, ele se tornará utilizável também para projetos Java SE.

	O encapsulamento nativo não altera o modelo de implantação de sua aplicação: ele usa a aplicação como está, encapsula com runtime de Java e produz um instalador que é comum para o sistema operacional que você está usando. O ponto principal é criar uma única ação não importando o runtime de Java que os usuários têm na máquina-alvo. Você pode usar um instalador e executá-lo em uma máquina na qual não há rastreamento de Java. Isso instalará a aplicação e os bits de runtime Java necessários. O tamanho desses instaladores é bem grande porque mesmo uma aplicação "Hello world" transportará uma parte grande de artefatos de runtime Java.

	Neste tutorial, você criará um instalador ``EXE`` de uma aplicação Java SE e um instalador ``MSI`` para uma aplicação JavaFX para o sistema operacional Windows, com base nas aplicações de amostra encapsuladas com o IDE.

	Observação:

	* Os instaladores ``EXE`` e ``MSI`` que você obtém são específicos da plataforma; eles só serão executados em um sistema compatível com a plataforma Java de destino cujos pacotes ``EXE`` / ``MSI`` instaláveis foram criados. (Por exemplo, se um instalador ``EXE`` ou ``MSI`` foi criado em uma máquina com um JDK de 64 bits instalado, ele deverá ser executado em uma máquina com Windows de 64 bits instalado).
	* No Windows, ambas as aplicações são instaladas no diretório ``C:\Users\<username>\AppData\Local\`` e estão disponíveis no menu Iniciar.


	image::images/netbeans-stamp-80-74.png[title="O conteúdo desta página se aplica ao NetBeans IDE 7.4 ou 8.0"]


	Para seguir este tutorial, são necessários os recursos e o software a seguir.

	\|===
	\|Software ou Recurso \|Versão Necessária

	\|link:http://netbeans.org/downloads/index.html[+NetBeans IDE+] \|7.4 ou 8.0

	\|link:http://www.oracle.com/technetwork/java/javafx/downloads/index.html[+JDK (Java Development Kit)+] \|7 atualização 25 (ou mais recente) ou 8

	\|link:http://www.jrsoftware.org/[+Inno Setup+] \|5.5 ou versão mais recente

	\|link:http://wixtoolset.org/[+WiX+] \|3.7 ou versão mais recente
	\|===


	== Instalando e Adicionando as Ferramentas Necessárias ao Caminho

	Para usar o suporte do IDE para encapsulamento nativo, as seguintes ferramentas adicionais precisam ser instaladas:

	* O link:http://www.jrsoftware.org/[+Inno Setup 5.5+] (ou uma versão mais recente) para produzir instaladores EXE no Windows é obrigatório.
	* O link:http://wixtoolset.org/[+WiX 3.7+] (ou uma versão mais recente) para produzir instaladores MSI no Windows é obrigatório.

	Observação: para obter uma lista de ferramentas obrigatórias para criar instaladores para diferentes plataformas, consulte "link:http://www.oracle.com/pls/topic/lookup?ctx=nb7400&id=NBDAG2508[+Encapsulando uma Aplicação como um Instalador Nativo+]" em _Desenvolvendo Aplicações com o NetBeans IDE_.

	Para instalar o Inno Setup:

	1. Faça Download do ``ispack-5.5.3.exe`` na página link:http://www.jrsoftware.org/isdl.php[+Downloads do Inno Setup+]
	2. Clique duas vezes no arquivo para iniciar o instalador.
	3. Aceite o contrato de licença do Inno Setup e clique em Próximo.
	4. Siga as instruções do assistente de instalação para instalar o Inno Setup.

	Para instalar o WiX:

	1. Faça download do ``wix37.exe`` na página link:http://wix.codeplex.com/releases/view/99514[+WiX Toolset - Download+].
	2. Clique duas vezes no arquivo para iniciar o instalador.
	3. Siga as instruções do assistente de instalação para instalar o WiX.

	Para adicionar o Inno Setup e/ou WiX à variável Path do sistema:

	1. No Windows 7, selecione Iniciar > Computador > Propriedades do Sistema > Configurações avançadas do sistema.
	2. Selecione a guia Avançado e clique no botão Variáveis de Ambiente.
	3. No painel Variáveis do Sistema, clique duas vezes na variável Path.
	4. Na caixa de diálogo Editar Variável do Sistema, adicione um ponto-e-vírgula seguido de um novo caminho ao campo Valor da variável (por exemplo, ``C:\Arquivos de Programa (x86)\Inno Setup 5 `` ou ``C:\Arquivos de Programa (x86)\WiX Toolset v3.6\bin`` ).
	5. Clique em OK para fechar todas as caixas de diálogo abertas.

	Observações:

	* Para verificar se a ferramenta instalada está no Path, abra a janela Prompt de Comando e digite ``iscc.exe`` para Inno Setup ou ``candle.exe`` para WiX. (Se o Prompt de Comando for fechado instantaneamente, tente especificar ``cmd.exe /c cmd.exe /k iscc.exe`` ou ``cmd.exe /c cmd.exe /k candle.exe`` respectivamente.)
	A figura a seguir mostra o que o Prompt de Comando deve exibir, caso o Inno Setup seja adicionado à variável Path do sistema.

	[.feature]
	--
	image::images/cmd_small.png[role="left", link="images/cmd.png"]
	--

	* Certifique-se de que o IDE tenha sido reiniciado após as ferramentas serem adicionadas à variável Path do sistema.


	== Encapsulamento Nativo nos Projetos Java SE

	Para utilizar o suporte de encapsulamento nativo no IDE, é necessário concluir o seguinte:

	* <<createse,criar um projeto IDE>>
	* <<enable,ativar as ações de encapsulamento nativo no projeto>>
	* <<buildse,limpar e construir o projeto>>
	* <<instse,encapsular uma aplicação em um instalador>>


	=== Configurando um Projeto Java SE

	Antes de encapsular uma aplicação em um instalador, é necessário criar uma aplicação.

	Você criará um novo projeto Java SE com o exemplo do jogo de Anagramas que é enviado com o NetBeans IDE.

	Para criar um projeto do IDE:

	1. No IDE, escolha Arquivo > Novo Projeto.
	2. No assistente Novo Projeto, expanda a categoria Amostras e selecione Java.
	3. Escolha o Jogo de Anagramas na lista Projetos. Em seguida, clique em Próximo.

	[.feature]
	--
	image::images/new_javase_prj_small.png[role="left", link="images/new_javase_prj.png"]
	--



	. No painel Nome e Local, deixe os valores default para os campos Nome do Projeto e Localização do Projeto.


	. Clique em Finalizar.
	O IDE cria e abre o projeto Java SE.

	Para testar se o projeto criado funciona, execute-o escolhendo Executar > Executar Projeto no menu principal.
	A aplicação Anagramas deve ser iniciada e exibida em sua máquina.

	image::images/anagrams.png[]


	=== Ativando Encapsulamento Nativo no IDE

	As ações do encapsulamento nativo são desativadas no IDE, por default.

	Clique com o botão direito do mouse no projeto AnagramGame na janela Projetos, para verificar as ações disponíveis para o projeto Java SE criado no IDE: não há ações relacionadas ao pacote no menu de contexto do projeto.

	image::images/context_wo_pkg.png[]

	Para ativar as ações de encapsulamento nativo do projeto:

	1. Clique com o botão direito do mouse no nó do projeto na janela Projetos e selecione as Propriedades no menu de contexto.
	2. Na caixa de diálogo Propriedades do Projeto, escolha a categoria Implantação e selecione Ativar Ações de Encapsulamento Nativo na opção Menu do Projeto.

	[.feature]
	--
	image::images/enable_native_pkg_small.png[role="left", link="images/enable_native_pkg.png"]
	--



	. Clique em OK.
	Um comando Encapsular como é adicionado ao menu de contexto do projeto.

	image::images/pkg_enabled.png[]


	=== Construindo uma Aplicação

	É hora de limpar e construir sua aplicação para implantação.

	Para limpar e construir seu projeto:

	* Escolha Executar > Limpar e Construir Projeto do menu principal.
	O IDE exibe os resultados na janela de Saída.

	[.feature]
	--
	image::images/output_small.png[role="left", link="images/output.png"]
	--

	Uma pasta ``dist`` que contém um arquivo ``jar`` é criada na pasta do projeto.


	=== Criando um Instalador ``EXE``

	A aplicação agora pode ser encapsulada em um instalador para Windows.

	Para construir um instalador ``EXE`` :

	* Clique com o botão direito do mouse no projeto AnagramGame e escolha Encapsular como > Instalador EXE do menu de contexto.

	Observação: o IDE só criará um instalador ``EXE`` se o Inno Setup for <<tool,instalado e adicionado à variável Path do sistema>>.

	O IDE exibe o andamento e o resultado do processo de encapsulamento na janela de Saída.

	[.feature]
	--
	image::images/output_se_exe_small.png[role="left", link="images/output_se_exe.png"]
	--

	Observação: o IDE primeiro registra o progresso e, em seguida, durante um período verifica como se nada estivesse acontecendo - é exatamente neste momento em que o Inno Setup está trabalhando em segundo plano. Demora um pouco para o encapsulamento ser concluído.

	Quando o instalador ``EXE`` estiver pronto, ele será colocado no diretório ``AnagramGame/dist/bundles/`` .

	image::images/anagram_exe.png[]


	== Encapsulamento de Aplicação Autocontida nos Projetos JavaFX

	Para criar uma aplicação JavaFX instalável usando o suporte ao encapsulamento nativo no IDE, é necessário concluir o seguinte:

	* <<createfx,criar um projeto JavaFX no IDE>>
	* <<enablefx,ativar o suporte ao encapsulamento nativo para o projeto>>
	* <<buildfx,limpar e construir uma aplicação JavaFX>>
	* <<instfx,construir uma aplicação JavaFX instalável>>


	=== Criando um Projeto JavaFX

	Você começa a criação de um projeto JavaFX usando o projeto de amostra BrickBreaker encapsulado com o IDE.

	Para criar um projeto JavaFX no IDE:

	1. No IDE, escolha Arquivo > Novo Projeto.
	2. No assistente Novo Projeto, expanda a categoria Amostras e selecione JavaFX.
	3. Escolha BrickBreaker na lista Projetos. Em seguida, clique em Próximo.
	4. No painel Nome e Local, deixe os valores default para os campos Nome do Projeto, Localização do Projeto e Plataforma JavaFX.

	[.feature]
	--
	image::images/new_javafx_prj_small.png[role="left", link="images/new_javafx_prj.png"]
	--



	. Clique em Finalizar.
	O projeto JavaFX do BrickBreaker é exibido na janela Projetos no IDE.

	Para testar se o projeto criado funciona, execute-o escolhendo Executar > Executar Projeto (BrickBreaker) no menu principal.
	A aplicação Brick Breaker deve ser iniciada e exibida em sua máquina.

	[.feature]
	--
	image::images/brickbreaker_small.png[role="left", link="images/brickbreaker.png"]
	--


	=== Ativando Encapsulamento Nativo no Projeto

	Para usar o suporte ao encapsulamento nativo no IDE para seu projeto, é necessário ativá-lo primeiro.

	Se clicar com o botão direito no mouse no projeto Brick Breaker, você não verá nele ações relacionadas a encapsulamento nativo.

	image::images/javafx_wo_pkg.png[]

	Para ativar as ações de encapsulamento nativo no menu de contexto do projeto:

	1. Clique com o botão direito do mouse no nó do projeto na janela Projetos e selecione as Propriedades no menu de contexto.
	2. Na caixa de diálogo Propriedades do Projeto, escolha a categoria Construir e selecione a opção Ativar Encapsulamento Nativo.

	[.feature]
	--
	image::images/enable_native_pkg_fx_small.png[role="left", link="images/enable_native_pkg_fx.png"]
	--



	. Clique em OK.
	A opção Encapsular como item é adicionada ao menu de contexto do projeto.

	image::images/pkg_fx_enabled.png[]


	=== Construindo uma Aplicação

	Sua aplicação JavaFX agora está pronta para ser limpa e construída.

	Para limpar e construir seu projeto:

	* Escolha Executar > Limpar e Construir Projeto do menu principal.
	O IDE exibe os resultados na janela de Saída.

	Observação: se a construção for bem-sucedida, mas o IDE exibir ``advertência: [opções] caminho de classe de bootstrap não definido com -código-fonte 1.6`` na janela de Saída, o formato de Código-fonte/Binário precisará ser definido como JDK 8 nas propriedades do projeto e o projeto precisa ser limpo e construído novamente, como segue:

	1. Clique com o botão direito do mouse no projeto BrickBreaker na janela Projetos e escolha Propriedades.
	2. Na caixa de diálogo Propriedades do projeto, selecione a categoria Executar Códigos-fontes.
	3. Defina o formato Código-fonte/Binário para JDK 8 e clique em OK.
	4. Clique com o botão direito do mose na janela Projetos e escolha Limpar e Construir no menu de contexto.


	=== Criando um Instalador ``MSI``

	A aplicação agora pode ser encapsulada em um pacote instalável específico do Windows.

	Para construir um instalador ``MSI`` :

	* Clique com o botão direito do mouse no projeto BrickBreaker e escolha Encapsular como > Instalador MSI do menu de contexto.

	Observação: o IDE cria um instalador ``MSI`` somente se WiX for <<tool,instalada e adicionada à variável Path do sistema>>.

	O IDE exibe o andamento e o resultado do processo de encapsulamento na janela de Saída.

	[.feature]
	--
	image::images/output_fx_msi_small.png[role="left", link="images/output_fx_msi.png"]
	--

	Observação: o IDE primeiro registra o progresso e, em seguida, durante um período verifica como se nada estivesse acontecendo - é exatamente neste momento em que a WiX está trabalhando em segundo plano. Demora um pouco para o encapsulamento ser concluído.

	A aplicação JavaFX instalável está localizada no diretório ``BrickBreaker/dist/bundles/`` .

	image::images/brickbreaker_msi.png[]


	== [[Verificando as Aplicações Instaláveis]]

	Quando os instaladores de ``AnagramGame-1.0.exe`` e ``BrickBreaker-1.0.msi`` forem concluídos, você precisará em qual diretório as aplicações Anagram e BrickBreaker foram instaladas.

	Para verificar os instaladores:

	1. Procure o arquivo do instalador ( ``AnagramGame-1.0.exe`` ou ``BrickBreaker-1.0.msi`` ) em seu disco rígido.
	2. Clique duas vezes para executar o instalador.

	As duas aplicações devem ser instaladas no diretório ``C:\Users\<username>\AppData\Local\`` e devem estar disponíveis no menu Iniciar.


	== Consulte Também

	* link:http://www.oracle.com/pls/topic/lookup?ctx=nb8000&id=NBDAG2508[+Encapsulando uma Aplicação como um Instalador Nativo+] em _Desenvolvendo Aplicações com o NetBeans IDE_
	* link:http://docs.oracle.com/javafx/2/deployment/self-contained-packaging.htm[+Implantando Aplicações JavaFX: Encapsulamento da Aplicação Autocontida+]
	* link:http://docs.oracle.com/javase/7/docs/technotes/guides/jweb/packagingAppsForMac.html[+Encapsulando uma Aplicação Java para Distribuição em uma Máquina+]
	link:/about/contact_form.html?to=3&subject=Feedback:%20Native%20Packaging%20In%20NetBeans%20IDE[+Enviar Feedback neste Tutorial+]


	link:../../trails/matisse.html[+Voltar à Trilha do Aprendizado+]