Exportação de Funções

O PDE faculta um assistente Exportação de Funções para exportar funções e plug-ins e fragmentos constituintes para um formato adequado para implementação. O assistente protege os scripts de Ant que não poluem o espaço de trabalho com recursos gerados durante a operação de construção. O assistente está disponível sob Abrir o assistente de exportação de funções Ficheiro > Exportar... > Desenvolvimento de Plug-in > Funções implementáveis.

Selecção da função

O assistente apresenta todas as funções não-binárias encontradas no espaço de trabalho.

Selecção de Função

Seleccione as funções que pretende exportar. Se estiver a exportar o mesmo conjunto de funções consecutivamente, pode premir o Conjunto de Trabalhos... para definir um conjunto de trabalhos.

As funções são construídas recursivamente. Por conseguinte, nos casos em que uma função inclui outra função, apenas a função de nível superior necessita de ser seleccionada de modo a exportar ambas as funções.

Destino

Pode optar por exportar as funções e os respectivos plug-ins constituintes para um directório ou para um arquivo ZIP. Também pode escolher exportar as funções num formato executável e instalá-las no sistema central Eclipse actualmente em execução.

Destino

Se optar por exportar para um Directório (a predefinição), as funções serão colocadas num subdirectório features/ e os plug-ins serão colocados num subdirectório plugins/ do directório seleccionado.

Se optar por exportar para um Ficheiro de arquivo, todas as funções e plug-ins serão empacotados num único arquivo ZIP. Além disso, a estrutura de directórios raiz contida no ZIP é iniciada com features/ e plugins/.

Se optar por exportar e Instalar as funções serão exportadas num formato executável e será gerado um repositório p2. Depois de concluída a exportação, uma operação de instalação vai ser executada para instalar as funções. Será solicitado que reinicie o Eclipse quando estiver concluída a instalação. Para desinstalar as funções deve utilizar o botão Detalhes da Instalação no Diálogo Acerca De (disponível em Ajuda > Acerca De Eclipse SDK). Para obter todos os detalhes, consulte Exportar e Instalar no Sistema Central

Opções

Opções

A opção Exportar origem resulta na exportação do código fonte, bem como binários. Existem duas formas de agrupar a origem com a função exportada. A opção Lotes de Origem Gerados vai adicionar os comandos ant para a exportação de forma a criar lotes de origem separados para cada um dos plug-ins exportados. Para mais informações sobre lotes de origem, consulte a entrada de Construção PDE em Lotes de Origem Individuais. A segunda opção é Incluir origem nos plug-ins exportados. esta opção vai agrupar os ficheiros origem numa pasta src/ na raiz de JAR (se exportar num formato JAR). Se um plug-in estiver empacotado como sendo um directório simples, o código fonte será colocado num ZIP de origem no directório do plug-in como equivalente do JAR de bibliotecas.

A opção Empacotar como arquivos de JAR individuais empacota funções e os respectivos constituintes como sendo JARs. Se a opção não estiver seleccionada, as funções são exportadas como directórios simples, enquanto os respectivos plug-ins constituintes são empacotados como sendo específicos na marcação feature.xml. As entradas de plug-ins marcadas com unpack="false" no feature.xml são exportadas como sendo JARs. Caso contrário, são exportadas como directórios.

existem duas opções adicionais disponíveis ao agrupar como JARs individuais. A opção Gerar repositório de metadados também permite gerar metadados p2 juntamente com a função exportada. Vai permitir que o directório ou arquivo para onde está a exportar seja utilizado como um repositório do qual p2 pode instalar e actualizar. Esta opção deverá ser activada ao exportar e instalar para o sistema central em execução. Categorizar repositório permite que o repositório de metadados gerado seja organizado por categoria. Um ficheiro xml de categoria válido que inclui dados para as funções que estão a ser exportadas devem ser especificados para categorias a serem criadas com êxito.

A opção Substituição de qualificador permite substituir um valor de um elemento do qualificador numa versão de plug-in ou numa versão de função. A versão deve estar no seguinte formato: <maior>.<menor>.<micro>.qualificador. Por exemplo: 3.3.0.qualifier. Normalmente, o qualificador representa uma data ou identificador de construção.

A opção Guardar como script de Ant permite-lhe guardar as definições da operação de exportação para que possam ser executadas novamente mais tarde sem ter de utilizar outra vez o assistente. Do mesmo modo que a operação de exportação, a tarefa de Ant é executada como um trabalho assíncrono. Por conseguinte, poderá não ser adequada para a incorporar como sendo parte de um script de Ant maior.

Permitir ciclos binários na plataforma destino é uma opção que controla como a operação de exportação processa os ciclos no gráfico de dependência para um plug-in. A Construção PDE não pode ser compilada se for detectado um ciclo. No entanto, se um ciclo apenas contiver plug-ins binários da plataforma destino, activar esta opção vai permitir que continue a Construção PDE.

Se a opção Utilizar ficheiros de classes compilador no espaço de trabalho estiver activada, em vez de compilar ficheiros como parte da operação de exportação, serão utilizados os ficheiros binários no espaço de trabalho que foram compilados por Eclipse. Deverá melhorar o rendimento uma vez que ignora a fase de compilação, mas o espaço de trabalho tem de ser compilado com êxito

Assinar o JAR

O separador Assinar o JAR é apenas visível quando a opção Empacotar como arquivos de JAR individuais é seleccionada no separador Opções.

Assinatura JAR

Para assinar os JARs, tem de estar a executar o Eclipse com um JDK integral, ao invés de um JRE.

Os campos Localização de Keystore, Keypass, Nome alternativo e Palavra-passe são todos necessários para a operação de assinatura.

Java Web Start

O separador Java Web Start está apenas disponível quando a opção Directório estiver seleccionada no separador Destino e a opção Empacotar como arquivos de JAR individuais estiver seleccionada no separador Opções.

Java Web Start .

Os campos URL do Sítio da Web e Versão do JRE são necessários.

Referência relacionada

Assistentes de Exportação
Assistente de Exportação do Plug-in

Tarefas relacionadas

Exportar e Instalar no Sistema Central em Execução