mozilla

Revision 272564 of Empacotando Extensões

  • Slug da revisão: Empacotando_Extensões
  • Título da revisão: Empacotando Extensões
  • ID da revisão: 272564
  • Criado:
  • Autor: Verruckt
  • É revisão atual? Não
  • Comentário

Conteúdo da revisão

Extensões são uma forma de {{mediawiki.interwiki('en', 'Bundle', '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 ({{mediawiki.interwiki('en', 'Adding_Extensions_using_the_Windows_Registry', '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 {{mediawiki.interwiki('en', 'Multiple_Item_Packaging', 'Multiple Item Package')}} que explica como criar este tipo de pacote. (Firefox 1.5/XULRunner 1.8 é requerido.)

Referências Oficiais para Toolkit API

{{wiki.template(':pt/Toolkit_API/Official_References')}}

{{ wiki.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 {{mediawiki.interwiki('en', 'Bundle', '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 <a href="pt/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">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="pt/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 name="Fazendo_uma_Extens.C3.A3o_XPI"> Fazendo uma Extensão XPI </h3>
<p>Um arquivo <a href="pt/XPI">XPI</a> (XPInstall) é simplesmente um arquivo ZIP contendo os arquivos da extensão, com o arquivo <a href="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 é <i>application/x-xpinstall</i>. 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 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 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 ({{mediawiki.interwiki('en', 'Adding_Extensions_using_the_Windows_Registry', 'Adding Extensions using the Windows Registry')}}).
</p>
<h3 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 {{mediawiki.interwiki('en', 'Multiple_Item_Packaging', 'Multiple Item Package')}} que explica como criar este tipo de pacote. (Firefox 1.5/XULRunner 1.8 é requerido.)
</p>
<h3 name="Refer.C3.AAncias_Oficiais_para_Toolkit_API"> Referências Oficiais para <a href="pt/Toolkit_API">Toolkit API</a> </h3>
<p>{{wiki.template(':pt/Toolkit_API/Official_References')}}
</p>{{ wiki.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" } ) }}
Reverter para esta revisão