files/pt-br/mozilla/add-ons/webextensions/empacotando_e_instalando/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

---
title: Empacotando e Instalando
slug: Mozilla/Add-ons/WebExtensions/Empacotando_e_instalando
translation_of: Mozilla/Add-ons/WebExtensions/Temporary_Installation_in_Firefox
---
<h2 id="Packaging_your_extension">Packaging your extension</h2>

<div class="note">
<p>Nós estamos trabalhando em uma GUI  para empacotar e carregar extensões. Veja <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1185460">Bug 1185460</a> para mais informações. Enquanto isso, siga as etapas abaixo.</p>
</div>

<p>Firefox extensões são empacotados como arquivos XPI, que nada mais são arquivos ZIP mas com extensão ".xpi".</p>

<p>Uma dica para empacotar o arquivo você precisa "zipar" todos os arquivos que está na root do seu diretório.</p>

<h3 id="Windows">Windows</h3>

<ol>
 <li>Abra a pasta com seus arquivos da extensão.</li>
 <li>Selecione todos os arquivos.</li>
 <li>Clique com o direito e escolha Enviar para → Pasta Compactada.</li>
 <li>Renomeie o arquivo de "something.zip" para "something.xpi".</li>
</ol>

<p><img alt="" src="https://mdn.mozillademos.org/files/11949/install-windows.png" style="display: block; height: 576px; margin-left: auto; margin-right: auto; width: 800px;"></p>

<h3 id="Mac_OS_X">Mac OS X</h3>

<ol>
 <li>Abra a pasta com seus arquivos da extensão.</li>
 <li>Selecione todos os arquivos.</li>
 <li>Clique com o direito e escolha Compress <em>n</em> Items.</li>
 <li>Renomeie o arquivo de<code> Archive.zip</code> para <code>something.xpi</code>.</li>
</ol>

<p><img alt="" src="https://mdn.mozillademos.org/files/11951/install-osx.png" style="display: block; height: 449px; margin-left: auto; margin-right: auto; width: 800px;"></p>

<h3 id="Linux_Mac_OS_X_Terminal">Linux / Mac OS X Terminal</h3>

<ol>
 <li><code>cd path/to/my-extension/</code></li>
 <li><code>zip -r ../my-extension.xpi *</code></li>
</ol>

<h2 id="Installing_your_extension">Installing your extension</h2>

<ol>
 <li>Digite no caminho de URL <code>about:addons</code></li>
 <li>Clique e araste o arquivo XPI para dentro da página, ou abra o menu de ferramentas e escolha "Install Add-On From File..."</li>
 <li>Clique instalar no dialog que irá aparecer</li>
</ol>

<h2 id="Instalando_suas_extensões_no_Firefox_OS">Instalando suas extensões no Firefox OS</h2>

<p>You can install your extension from <a href="/en-US/docs/Tools/WebIDE">WebIDE</a> running on a Desktop connected via USB or Wifi. Open "path/to/my-extension/" as a Packaged App in WebIDE.</p>

<p>When the manifest.json validation status is valid you will be able to Install and Run your extension on the attached Firefox OS device running a nightly build of Firefox OS.</p>

<p>The extension will first have to be enabled in Settings-&gt;Add-ons on the Firefox OS device.</p>

<h2 id="Soluções_de_problemas">Soluções de problemas</h2>

<p>There are a few common problems that you might run into:</p>

<h3 id="Este_add-on_não_poderá_ser_instalado_porque_não_pode_ser_verificado.">"Este add-on não poderá ser instalado porque não pode ser verificado."</h3>

<ul>
 <li>Make sure you're using <a href="https://nightly.mozilla.org/">Nightly</a> and that <code>xpinstall.signatures.required</code> is <code>false</code> in <code>about:config</code>.</li>
 <li>Learn more about <a href="/en-US/docs/Mozilla/Add-ons/Distribution">add-on signing and distribution</a>.</li>
</ul>

<h3 id="Este_add-on_não_pode_ser_instalado_porque_pode_está_corrompido.">"Este add-on não pode ser instalado porque pode está corrompido."</h3>

<ul>
 <li>Make sure you zipped your add-ons files directly, <em>not</em> the folder <em>containing</em> your add-ons files. Your manifest.json must be at the root of the zip file.</li>
 <li>Make sure you are using a <a href="https://nightly.mozilla.org/">Nightly</a> build of Firefox.</li>
</ul>

<h3 id="Nada_aconteceu">Nada aconteceu</h3>

<ul>
 <li>Make sure your file name actually ends in <code>.xpi</code>, since some operating systems <em>really</em> like to hide file extensions.

  <ul>
   <li>On Windows, check with View → Show / Hide: File Name Extensions.</li>
   <li>On Mac OS X, check with File → Get Info → Name and Extension.</li>
  </ul>
 </li>
 <li>It's possible you misclicked and dismissed the installation prompt. Look for a puzzle piece icon next to the Back button in Nightly. Click that to bring the popup back.</li>
</ul>

<h3 id="Observe_o_console">Observe o console</h3>

<p>Some additional error information relating to how your extension was extracted and loaded might be available in the <a href="/en-US/docs/Tools/Browser_Console">Browser Console</a>.</p>