Empacotando Extensões

  • Slug da revisão: Empacotando_Extensões
  • Título da revisão: Empacotando Extensões
  • ID da revisão: 272566
  • Criado:
  • Autor: fscholz
  • É revisão atual? Não
  • Comentário interwiki error; 78 words removed

Conteúdo da revisão

 

Extensões são uma forma de Installable Bundle (Pacotes Instaláveis) os quais podem ser baixados e instalados por um usuário, ou proporcionado por um pré-pacote com a aplicação ou por um programa externo. Extensões usam uma directory structure (estrutura de diretórios) que podem proporcionar chrome, componentes e outros arquivos para extender a funcionalidade de um programa XUL.

Toda extensão deve proporcionar um arquivo install.rdf que contém metadados sobre a extensão, como IDs únicos, versão, autor e informações sobre compatibilidade.

Depois dos arquivos da extensão e o install.rdf estarem preparados, existem vários caminhos para preparar uma extensão para instalação: comprima o diretório da extensão dentro de um arquivo XPI (XPInstall), desempacote a extensão diretamente dentro da aplicação do usuário ou diretório do perfil, ou registre a extensão no registro do Windows.

Fazendo uma Extensão XPI

Um arquivo XPI (XPInstall) é simplesmente um arquivo ZIP contendo os arquivos da extensão, com o arquivo install.rdf no raiz do ZIP. Usuários podem baixar e instalar os arquivos XPI de um website ou de uma pasta local, abrindo-o ou arrastando-o para uma janela de Gerenciamento de Extensões.

O tipo MIME reconhecido pelo Firefox pelos arquivos XPI é application/x-xpinstall. A maioria dos servidores de HTTP não está configurada por padrão para retornar este tipo MIME para a extensão .xpi, você provavelmente precisará configurar seu servidor HTTP. No Servidor Apache HTTP, isto pode ser feito adicionando as seguintes diretrizes ao arquivo de configuração ou ao .htaccess:

AddType application/x-xpinstall .xpi

Instalar Arquivos de Extensão Diretamente

Se você sabe a localização da aplicativos (se você estiver instalando uma extensão como parte de um instalador de aplicativos, por exemplo), você pode instalar os arquivos da extensão diretamente em <appdir>/extensions/<extensionID>. A extensão será encontrada automaticamente pelo Gerenciador de Extensões da próxima vez que o aplicativo for iniciado.

Quando usando este método você deve verificar se as permissões do arquivo de sistema para os diretórios e arquivos da extensão estejam postas adequadamente. Contrariamente, o Gerenciador de Extensões pode não funcionar adequadamente com a extensão ou ela pode não funcionar adequadamente.

Registrar um Local de Extensão Usando o Registro do Windows

Instaladores externos (como o Java runtime)podem desejar instalar pontos de integração da aplicação como extensão mesmo se o aplicativo ainda não está instalado. Isto pode ser efetuado no Windows usando o registro (Adding Extensions using the Windows Registry).

Extensões Multi-Item XPI

Em alguns casos um simples arquivo XPI podem desejar instalar múltiplas extensões/temas. Um tipo especial de extensão XPI chamado de Multiple Item Package que explica como criar este tipo de pacote. (Firefox 1.5/XULRunner 1.8 é requerido.)

Referências Oficiais para Toolkit API

{{ :pt/Toolkit_API/Official_References() }}

{{ languages( { "en": "en/Extension_Packaging", "fr": "fr/Empaqueter_une_extension", "it": "it/Impacchettare_l\'Estensione", "pl": "pl/Pakowanie_rozszerze\u0144", "ja": "ja/Extension_Packaging", "ko": "ko/Extension_Packaging" } ) }}

Fonte da revisão

<p> </p>
<p>Extensões são uma forma de <a href="/en/Bundle">Installable Bundle</a> (Pacotes Instaláveis) os quais podem ser baixados e instalados por um usuário, ou proporcionado por um pré-pacote com a aplicação ou por um programa externo. Extensões usam uma <a href="/en/Bundles">directory structure</a> (estrutura de diretórios) que podem proporcionar chrome, componentes e outros arquivos para extender a funcionalidade de um programa XUL.</p>
<p>Toda extensão deve proporcionar um arquivo <a href="/pt/install.rdf" title="pt/install.rdf">install.rdf</a> que contém metadados sobre a extensão, como IDs únicos, versão, autor e informações sobre compatibilidade.</p>
<p>Depois dos arquivos da extensão e o install.rdf estarem preparados, existem vários caminhos para preparar uma extensão para instalação: comprima o diretório da extensão dentro de um arquivo <a href="/en/XPI">XPI</a> (XPInstall), desempacote a extensão diretamente dentro da aplicação do usuário ou diretório do perfil, ou registre a extensão no registro do Windows.</p>
<h3 id="Fazendo_uma_Extens.C3.A3o_XPI" name="Fazendo_uma_Extens.C3.A3o_XPI">Fazendo uma Extensão XPI</h3>
<p>Um arquivo <a href="/en/XPI">XPI</a> (XPInstall) é simplesmente um arquivo ZIP contendo os arquivos da extensão, com o arquivo <a href="/pt/install.rdf" title="pt/install.rdf">install.rdf</a> no raiz do ZIP. Usuários podem baixar e instalar os arquivos XPI de um website ou de uma pasta local, abrindo-o ou arrastando-o para uma janela de Gerenciamento de Extensões.</p>
<p>O tipo MIME reconhecido pelo Firefox pelos arquivos XPI é <em>application/x-xpinstall</em>. A maioria dos servidores de HTTP não está configurada por padrão para retornar este tipo MIME para a extensão .xpi, você provavelmente precisará configurar seu servidor HTTP. No Servidor Apache HTTP, isto pode ser feito adicionando as seguintes diretrizes ao arquivo de configuração ou ao .htaccess:</p>
<pre class="eval">AddType application/x-xpinstall .xpi
</pre>
<h3 id="Instalar_Arquivos_de_Extens.C3.A3o_Diretamente" name="Instalar_Arquivos_de_Extens.C3.A3o_Diretamente">Instalar Arquivos de Extensão Diretamente</h3>
<p>Se você sabe a localização da aplicativos (se você estiver instalando uma extensão como parte de um instalador de aplicativos, por exemplo), você pode instalar os arquivos da extensão diretamente em &lt;appdir&gt;/extensions/&lt;extensionID&gt;. A extensão será encontrada automaticamente pelo Gerenciador de Extensões da próxima vez que o aplicativo for iniciado.</p>
<p>Quando usando este método você deve verificar se as permissões do arquivo de sistema para os diretórios e arquivos da extensão estejam postas adequadamente. Contrariamente, o Gerenciador de Extensões pode não funcionar adequadamente com a extensão ou ela pode não funcionar adequadamente.</p>
<h3 id="Registrar_um_Local_de_Extens.C3.A3o_Usando_o_Registro_do_Windows" name="Registrar_um_Local_de_Extens.C3.A3o_Usando_o_Registro_do_Windows">Registrar um Local de Extensão Usando o Registro do Windows</h3>
<p>Instaladores externos (como o Java runtime)podem desejar instalar pontos de integração da aplicação como extensão mesmo se o aplicativo ainda não está instalado. Isto pode ser efetuado no Windows usando o registro (<a href="/en/Adding_Extensions_using_the_Windows_Registry">Adding Extensions using the Windows Registry</a>).</p>
<h3 id="Extens.C3.B5es_Multi-Item_XPI" name="Extens.C3.B5es_Multi-Item_XPI">Extensões Multi-Item XPI</h3>
<p>Em alguns casos um simples arquivo XPI podem desejar instalar múltiplas extensões/temas. Um tipo especial de extensão XPI chamado de <a href="/en/Multiple_Item_Packaging">Multiple Item Package</a> que explica como criar este tipo de pacote. (Firefox 1.5/XULRunner 1.8 é requerido.)</p>
<h3 id="Refer.C3.AAncias_Oficiais_para_Toolkit_API" name="Refer.C3.AAncias_Oficiais_para_Toolkit_API">Referências Oficiais para <a href="/pt/Toolkit_API" title="pt/Toolkit_API">Toolkit API</a></h3>
<p>{{ :pt/Toolkit_API/Official_References() }}</p>
<p>{{ languages( { "en": "en/Extension_Packaging", "fr": "fr/Empaqueter_une_extension", "it": "it/Impacchettare_l\'Estensione", "pl": "pl/Pakowanie_rozszerze\u0144", "ja": "ja/Extension_Packaging", "ko": "ko/Extension_Packaging" } ) }}</p>
Reverter para esta revisão