path: root/files/pl/manifesty_instalacji/index.html

---
title: Manifesty Instalacji
slug: Manifesty_Instalacji
tags:
  - Rozszerzenia
  - Strony_wymagające_dopracowania
  - Toolkit API
translation_of: Archive/Add-ons/Install_Manifests
---
<h2 id="Wprowadzenie" name="Wprowadzenie">Wprowadzenie</h2>

<p>Manifest Instalacji to plik, dzięki któremu Menedżer Dodatków określa szczegółowe informacje na temat dodatku, który jest instalowany. Zawiera on dane identyfikujące dodatek oraz informacje takie, jak: kto go stworzył, gdzie można znaleźć więcej informacji na jego temat, z jakimi wersjami aplikacji jest on zgodny, jak powinien przebiegać proces aktualizacji i tym podobne.</p>

<p>Manifest Instalacji jest zapisany w formacie RDF/XML.</p>

<p>Plik musi mieć nazwę <code>install.rdf</code>. Należy go umieścić na najwyższym poziomie pliku XPI.</p>

<h2 id="Budowa" name="Budowa">Budowa</h2>

<p>Podstawowy Manifest Instalacji ma budowę:</p>

<pre class="eval">&lt;?xml version="1.0"?&gt;

&lt;RDF xmlns="<span class="nowiki">http://www.w3.org/1999/02/22-rdf-syntax-ns#</span>"
     xmlns:em="<span class="nowiki">http://www.mozilla.org/2004/em-rdf#</span>"&gt;
  &lt;Description about="urn:mozilla:install-manifest"&gt;
    &lt;!-- własności --&gt;
  &lt;/Description&gt;
&lt;/RDF&gt;
</pre>

<p>Niektóre własności są wymagane, inne nie. Jedne to proste łańcuchy tekstu, drugie to złożone zasoby.</p>

<h2 id="Wymagane_w.C5.82asno.C5.9Bci" name="Wymagane_w.C5.82asno.C5.9Bci">Wymagane własności</h2>

<p>Manifest Instalacji musi określać te własności, inaczej Twój dodatek nie zostanie zainstalowany.</p>

<h3 id="id" name="id">id</h3>

<p>id rozszerzenia to:</p>

<ul>
 <li>GUID (wygenerowany przy pomocy guidgen w Windows lub uuidgen na systemach Uniksowych) (Firefox 1.0)</li>
 <li>{{ Fx_minversion_inline(1.5) }} Łańcuch tekstu w postaci: <code><a class="link-mailto" href="mailto:nazwawtyczki@organizacja.org" rel="freelink">nazwawtyczki@organizacja.org</a></code></li>
</ul>

<p>Ostatni format jest łatwiejszy do stworzenia i korzystania. Firefox 1.5 upewni się, że w twoim manifeście znajduje się id w jednym z podanych formatów, jeśli natrafi na źle sformułowany id, nie zainstaluje dodatku.</p>

<p><strong>Przykłady</strong></p>

<pre class="eval">&lt;em:id&gt;<a class="link-mailto" href="mailto:mojawtyczka@mojastrona.pl" rel="freelink">mojawtyczka@mojastrona.pl</a>&lt;/em:id&gt;

&lt;em:id&gt;{daf44bf7-a45e-4450-979c-91cf07434c3d}&lt;/em:id&gt;
</pre>

<h3 id="version" name="version">version</h3>

<p>Numer wersji odpowiedni dla instalowanego dodatku.</p>

<p>Dla Firefoksa/Thundebirda 1.0, format wersji musi spełniać warunki podane w artykule <a href="/pl/Extension_Versioning,_Update_and_Compatibility" title="pl/Extension_Versioning,_Update_and_Compatibility">Extension Versioning, Update and Compatibility</a>. Dla Firefoksa/Thundebirda 1.5, zobacz <a href="/pl/Toolkit_version_format" title="pl/Toolkit_version_format">Toolkit version format</a>.</p>

<p><strong>Przykłady</strong></p>

<pre class="eval">&lt;em:version&gt;2.0&lt;/em:version&gt;

&lt;em:version&gt;1.0.2&lt;/em:version&gt;

&lt;em:version&gt;0.4.1.2005090112&lt;/em:version&gt;

</pre>

<p><strong>Firefox 1.5</strong> - dodatki, które nie mają poprawnie określonego numeru wersji nie będą instalowane.</p>

<p><strong>Dodatki hostowane na addons.mozilla.org</strong> - strona z aktualizacjami Mozilli może przepakować i naprawić lub odrzucić dodatek ze źle określonym numerem wersji.</p>

<h3 id="type" name="type">type</h3>

<p>Liczba całkowita określająca typ dodatku.</p>

<table>
 <tbody>
  <tr>
   <td>2</td>
   <td>Rozszerzenia</td>
  </tr>
  <tr>
   <td>4</td>
   <td>Motywy</td>
  </tr>
  <tr>
   <td>8</td>
   <td>Lokalizacje</td>
  </tr>
  <tr>
   <td>16</td>
   <td>Wtyczki</td>
  </tr>
  <tr>
   <td>32</td>
   <td><a href="/pl/Multiple_Item_Packaging" title="pl/Multiple_Item_Packaging">Multiple Item Package</a></td>
  </tr>
 </tbody>
</table>

<p><strong>Przykłady</strong></p>

<pre class="eval">&lt;em:type&gt;2&lt;/em:type&gt;
</pre>

<p>{{ Fx_minversion_inline(1.5) }} Tę własność dodano w Firefoksie 1.5 i jest ona wymagana tylko dla dodatków innych niż Rozszerzenia i Motywy.</p>

<h2 id="targetApplication" name="targetApplication">targetApplication</h2>

<p>Obiekt określający aplikację bazową dodatku. Oznacza to, że dodatek będzie działać z aplikacją identyfikowaną poprzez określoną własność (<code>&lt;em:id&gt;</code>)(zobacz pełną listę ID aplikacji na stronie <a class="link-https" href="https://addons.mozilla.org/en-US/firefox/pages/appversions">Poprawne wersje aplikacji dla programistów dodatków</a>), od minimalnej wersji (<code>&lt;em:minVersion&gt;</code>) do i włącznie z maksymalną wersją (<code>&lt;em:maxVersion&gt;</code>). Numery wersji określamy w ten sam sposób jak przy własności <a href="#version"><code>version</code></a> będzie porównywany z wersją aplikacji; pozwala to autorowi rozszerzenia na określenie wersji Firefoksa, na których było ono testowane.</p>

<p>Uwaga: Firefoks 1.0-1.0.6 posiada wersję aplikacji <code>1.0</code>. Uaktualnienia bezpieczeństwa oraz stabilności Firefoksa 1.5 posiadają wersje aplikacji 1.5.0.1, 1.5.0.2, itd. Rozszerzenia kompatybilne z Firefoksem lub Thunderbirdem 1.5 powinny określać maxVersion na 1.5.0.*, tak by były automatycznie zgodne z aktualizacjami bezpieczeństwa i stabilności.</p>

<p>Rozszerzenia kompatybilne z Firefoksem 2 powinny mieć określoną własność <code>maxVersion</code> jako <code>2.0.0.*</code></p>

<p>Manifest Instalacji musi określać przynajmniej jeden taki obiekt, a może więcej, jeżeli dodatek ma współpracować z wieloma aplikacjami, które posiadają Menedżera Dodatków (np. Firefox i Thunderbird)</p>

<p><strong>Przykłady</strong></p>

<pre class="eval">&lt;em:targetApplication&gt;
 &lt;Description&gt;
  &lt;em:id&gt;{ec8030f7-c20a-464f-9b0e-13a3a9e97384}&lt;/em:id&gt; <span class="comment">Firefox</span>
  &lt;em:minVersion&gt;1.5&lt;/em:minVersion&gt;
  &lt;em:maxVersion&gt;2.0.0.*&lt;/em:maxVersion&gt;
 &lt;/Description&gt;
&lt;/em:targetApplication&gt;
</pre>

<h3 id="name" name="name">name</h3>

<p>Nazwa dodatku wyświetlana w interfejsie użytkownika (UI).</p>

<p><strong>Przykłady </strong></p>

<pre class="eval">&lt;em:name&gt;Moje Rozszerzenie&lt;/em:name&gt;
</pre>

<h2 id="Opcjonalne_w.C5.82asno.C5.9Bci" name="Opcjonalne_w.C5.82asno.C5.9Bci">Opcjonalne własności</h2>

<p>Będziesz mógł określić te własności w zależności od możliwości Twojego dodatku.</p>

<h3 id="localized" name="localized">localized</h3>

<p>Allows you to localize the add-on's name, description, contributors and other metadata. The localized description must specify at least one <code>em:locale</code> which indicates which locales to use this information for.</p>

<p><strong>Przykłady</strong></p>

<p>This declares a set of add-on metadata to be displayed when the application is running in the de-DE locale.</p>

<pre>&lt;em:localized&gt;
  &lt;Description&gt;
    &lt;em:locale&gt;de-DE&lt;/em:locale&gt;
    &lt;em:name&gt;Tab Sidebar&lt;/em:name&gt;
    &lt;em:description&gt;Zeigt in einer Sidebar Vorschaubilder der Inhalte aller offenen Tabs an.&lt;/em:description&gt;
  &lt;/Description&gt;
&lt;/em:localized&gt;
</pre>

<p>The following properties which are described elsewhere in this page can be included in the localized property:</p>

<ul>
 <li>name</li>
 <li>description</li>
 <li>creator</li>
 <li>homepageURL</li>
 <li>developer</li>
 <li>translator</li>
 <li>contributor</li>
</ul>

<p>Więcej dokumentacji można znaleźć na stronie <a href="/pl/Lokalizacja_opisu_rozszerzenia" title="pl/Lokalizacja_opisu_rozszerzenia">Lokalizacja opisu rozszerzenia</a>.</p>

<p>{{ Fx_minversion_inline(3) }} Ta własność została dodana dla Firefoksa 3.</p>

<h3 id="description" name="description">description</h3>

<p>Krótki opis dodatku wyświetlany w interfejsie użytkownika. Opis powinien mieścić się w krótkiej linijce tekstu.</p>

<p><strong>Przykłady</strong></p>

<pre class="eval">&lt;em:description&gt;Zaawansowana wtyczka.&lt;/em:description&gt;
</pre>

<h3 id="creator" name="creator">creator</h3>

<p>Imię twórcy/głównego developera wyświetlane w interfejsie użytkownika.</p>

<p><strong>Przykłady</strong></p>

<pre class="eval">&lt;em:creator&gt;Jan Kowalski&lt;/em:creator&gt;
</pre>

<p>lub</p>

<pre class="eval">&lt;em:creator&gt;CoolExtension Team&lt;/em:creator&gt;
</pre>

<h3 id="developer" name="developer">developer</h3>

<p>Imię i nazwisko (imiona i nazwiska) <strong>co-developers</strong>. Można określić więcej niż jednego programistę. {{ Fx_minversion_inline(2) }}</p>

<p><strong>Przykłady</strong></p>

<pre class="eval">&lt;em:developer&gt;Jane Doe&lt;/em:developer&gt;
&lt;em:developer&gt;Koos van der Merwe&lt;/em:developer&gt;
</pre>

<h3 id="translator" name="translator">translator</h3>

<p>Imię i nazwisko (imiona i nazwiska) osób tłumaczących. Można określić więcej niż jednego tłumacza. {{ Fx_minversion_inline(2) }}</p>

<p><strong>Przykłady</strong></p>

<pre class="eval">&lt;em:translator&gt;Jan Kowalski&lt;/em:translator&gt;
&lt;em:translator&gt;Jan Nowak&lt;/em:translator&gt;
</pre>

<h3 id="contributor" name="contributor">contributor</h3>

<p>Imiona i nazwiska dodatkowych współpracowników. Można określić więcej niż jednego współpracownika.</p>

<p><strong>Przykłady</strong></p>

<pre class="eval">&lt;em:contributor&gt;Jan Kowalski&lt;/em:contributor&gt;
</pre>

<pre class="eval">&lt;em:contributor&gt;Jan Kowalski&lt;/em:contributor&gt;
&lt;em:contributor&gt;Jan Nowak&lt;/em:contributor&gt;
&lt;em:contributor&gt;Jan Kowalski&lt;/em:contributor&gt;
</pre>

<h3 id="homepageURL" name="homepageURL">homepageURL</h3>

<p>Odnośnik do strony domowej dodatku wyświetlany w interfejsie użytkownika.</p>

<p><strong>Przykład:</strong></p>

<pre class="eval">&lt;em:homepageURL&gt;<span class="nowiki">http://www.foo.com/</span>&lt;/em:homepageURL&gt;
</pre>

<h3 id="updateURL" name="updateURL">updateURL</h3>

<p>Odnośnik do własnego Manifestu Aktualizacji, który określa dostępne aktualizacje dla twojego dodatku. Składnia jest opisana poniżej. Jeżeli użytkownik wybrał odpowiednią opcję, to Menadżer Dodatków, co jakiś czas sprawdza plik Manifestu, by określić, czy jest dostępna nowa wersja dodatku.</p>

<div class="warning"><strong>Ostrzeżenie:</strong> It is strongly recommended that the <code>updateURL</code> be an HTTPS (secure) link. Non-secure update URLs can be hijacked by a malicious <code>update.rdf</code> file, enabling malware to infiltrate the user's computer. Alternatively, you could host your extension on <a class="external" href="http://addons.mozilla.org">AMO</a> and leave out the <code>updateURL</code> completely. This provides secure updates automatically.</div>

<p>Twój serwer musi wysłać ten plik w postaci <code>text/rdf</code>, inaczej automatyczna aktualizacja nie zadziała.</p>

<p>Menadżer Dodatków odpowiednio zamieni poniższe wartości w adresie URL, jeżeli chcesz, aby odpowiedź w formacie RDF była generowana dynamicznie, za pomocą PHP lub CGI:</p>

<table>
 <tbody>
  <tr>
   <td><code>%REQ_VERSION%</code></td>
   <td>Wersja żądania. Obecnie 1</td>
  </tr>
  <tr>
   <td><code>%ITEM_ID%</code></td>
   <td><code>id</code> aktualizowanego dodatku</td>
  </tr>
  <tr>
   <td><code>%ITEM_VERSION%</code></td>
   <td><code>version</code> aktualizowanego dodatku</td>
  </tr>
  <tr>
   <td><code>%ITEM_MAXAPPVERSION%</code></td>
   <td><code>maxVersion</code> obiektu <code>targetApplication</code> odpowiadającego aplikacji bazowej aktualizowanego dodatku.</td>
  </tr>
  <tr>
   <td><code>%APP_ID%</code></td>
   <td><code>id</code> aplikacji bazowej</td>
  </tr>
  <tr>
   <td><code>%APP_VERSION%</code></td>
   <td><code>version</code> aplikacji bazowej</td>
  </tr>
  <tr>
   <td><code>%APP_OS%</code></td>
   <td>Wartość <code>OS_TARGET</code> ze środowiska kompilacji Firefoksa, wykorzystywana do identyfikacji systemu operacyjnego. {{ Fx_minversion_inline(1.5) }}</td>
  </tr>
  <tr>
   <td><code>%APP_ABI%</code></td>
   <td>Wartość <code>TARGET_XPCOM_ABI</code> ze środowiska kompilacji Firefoksa, identyfikująca kompilator/architekturę użytą do kompilacji aplikacji bazowej. {{ Fx_minversion_inline(1.5) }}</td>
  </tr>
 </tbody>
</table>

<p><strong>Przykłady</strong></p>

<p>&lt;em:updateURL&gt;<span class="nowiki">http://www.foo.com/update.cgi?id=%ITEM_ID%&amp;amp;version=%ITEM_VERSION%</span>&lt;/em:updateURL&gt;</p>

<p>&lt;em:updateURL&gt;<span class="nowiki">http://www.foo.com/extension/windows.rdf</span>&lt;/em:updateURL&gt;</p>

<p><strong>Dodatki hostowane na addons.mozilla.org:</strong> Nie musisz określać własności updateURL. Domyślnie aplikacje Mozilli korzystające z Menedżera Dodatków (jak Firefox i Thunderbird) wysyłają żądanie aktualizacji do <code>addons.mozilla.org</code>. Za każdym razem, kiedy wgrasz nową wersję twojego dodatku albo zmienisz parametry kompatybilności poprzez interfejs autora, twój Manifest Aktualizacji zostanie wygenerowany automatycznie.</p>

<p><strong>Format Manifestu Aktualizacji:</strong> Manifest Aktualizacji jest w formacie RDF/XML, który jest opisana tutaj: <a href="/pl/Manifest_Aktualizacji" title="pl/Manifest_Aktualizacji">Manifest Aktualizacji</a></p>

<h3 id="optionsURL" name="optionsURL">optionsURL</h3>

<p>Adres <code>chrome://</code> okna dialogowego opcji rozszerzenia. Jest to przydatne jedynie rozszerzeniom. Jeżeli właściwość jest określona, przycisk Opcje na liście rozszerzeń będzie dostępny i będzie wyświetlał podane okno.</p>

<p><strong>Przykłady</strong></p>

<pre class="eval">&lt;em:optionsURL&gt;<a class="external" rel="freelink">chrome://wtyka/content/opcje.xul</a>&lt;/em:optionsURL&gt;
</pre>

<h3 id="aboutURL" name="aboutURL">aboutURL</h3>

<p>Adres <code>chrome://</code> okna dialogowego <em>Informacje o rozszerzeniu</em> dodatku. Jest to przydatne jedynie rozszerzeniom. Jeżeli własność jest określona, przycisk <em>Informacje o rozszerzeniu...</em> na liście rozszerzeń będzie dostępny i będzie wyświetlał podane okno zamiast domyślnego.</p>

<p><strong>Przykłady</strong></p>

<pre class="eval">&lt;em:aboutURL&gt;<a class="external" rel="freelink">chrome://wtyka/content/about.xul</a>&lt;/em:aboutURL&gt;
</pre>

<h3 id="iconURL" name="iconURL">iconURL</h3>

<p>Adres <code>chrome://</code> do ikonki o rozmiarze 32x32, która pojawi się na liście dodatków. Jeżeli nie określisz tej własności zostanie użyta domyślna ikonka.</p>

<pre class="eval">&lt;em:iconURL&gt;<a class="external" rel="freelink">chrome://wtyka/skin/ikonka.png</a>&lt;/em:iconURL&gt;
</pre>

<h3 id="hidden" name="hidden">hidden</h3>

<p>Wartość logiczna, gdy jest prawdziwa, dodatek nie zostanie wyświetlony na liście; zapewnia, że dodatek instalowany jest w chronionej strefie dostępu (np. nie ze strony WWW). Wykorzystuję się to przy budowaniu integracyjnych haków w większych aplikacjach, które mają na liście rozszerzeń wpisy nie mające sensu.</p>

<p><strong>Przykłady</strong></p>

<pre class="eval">&lt;em:hidden&gt;true&lt;/em:hidden&gt;
</pre>

<h2 id="Niezalecane_w.C5.82a.C5.9Bciwo.C5.9Bci" name="Niezalecane_w.C5.82a.C5.9Bciwo.C5.9Bci">Niezalecane właściwości</h2>

<p>Te właściwości nie są wspierane w nowszych wersjach Menedżera Dodatków. Są one ignorowane, ale mogą być wymagane przez starsze wersje.</p>

<h3 id="targetPlatform" name="targetPlatform">targetPlatform</h3>

<p>A string specifying a platform that the addon supports. It contains either the value of OS_TARGET alone or combined with <a href="/pl/XPCOM_ABI" title="pl/XPCOM_ABI">TARGET_XPCOM_ABI</a>, separated by an underscore (_).</p>

<p>OS_TARGET is typically the output of the 'uname -s' command on the target platform, e.g.:</p>

<ul>
 <li><code>WINNT</code> for Windows NT, 2000, XP and later</li>
 <li><code>Linux</code> for all Linux versions</li>
 <li><code>Darwin</code> for all MacOS X versions</li>
 <li><code>SunOS</code> for all Solaris versions</li>
</ul>

<p>You can specify multiple targetPlatform properties per manifest. If any value matches the application's build parameters, it will be installed; if not, the user will get an appropriate error message.</p>

<p><strong>Przykłady</strong></p>

<pre class="eval">&lt;em:targetPlatform&gt;WINNT_x86-msvc&lt;/em:targetPlatform&gt;

&lt;em:targetPlatform&gt;Linux&lt;/em:targetPlatform&gt;

&lt;em:targetPlatform&gt;Darwin_ppc-gcc3&lt;/em:targetPlatform&gt;

&lt;em:targetPlatform&gt;SunOS_sparc-sunc&lt;/em:targetPlatform&gt;
</pre>

<p>Usually, you would use only the OS part for themes or for extensions that are not fully cross-platform. For extensions including binary (compiled) components, you should never use the OS alone, but include the <a href="/pl/XPCOM_ABI" title="pl/XPCOM_ABI">ABI (s)</a> that you compiled the components with. If you want to include multiple versions of the components, you should also use <a href="/pl/Bundles#Platform-specific_Subdirectories" title="pl/Bundles#Platform-specific_Subdirectories">Platform-specific Subdirectories</a>.</p>

<p><strong>Notatki</strong></p>

<ul>
 <li>In the same manifest file, you could even mix values with and without ABI. If a value for the application's OS is encountered that requires any specific ABI, the ABI is considered important for that OS and the application will refuse to install the addon if it does not find a matching OS/ABI combination. This means that if all of the above examples would occur in one manifest, the addon will install on any Linux build of the application, regardless of its ABI, but not on a Windows Cygwin build.</li>
</ul>

<ul>
 <li>There may be builds of Firefox and Thunderbird which do not "know" their ABI (most likely ports to rare platforms, or non-official builds). These builds will refuse to install any addon that requires a specific ABI for their platform.</li>
</ul>

<p>{{ Fx_minversion_inline(1.5) }} This property was added for Firefox/Thunderbird 1.5. Previous versions of these applications will ignore the restrictions and install the addon regardless of the platform.</p>

<h3 id="requires" name="requires">requires</h3>

<p>This tag has a similar syntax to the <code>&lt;em:targetApplication&gt;</code> tag. If the addon specified by the <code>&lt;em:id&gt;</code> tag is not installed or has an incompatible version, the extension manager will disable your extension and show the message "Requires additional items". You can add as many <code>&lt;em:requires&gt;</code> tags as you like. Your extension will be disabled if any of the specified requirements fail.</p>

<p><strong>Przykład</strong></p>

<pre>&lt;em:requires&gt;
   &lt;Description&gt;
     &lt;!-- Lightning --&gt;
     &lt;em:id&gt;{e2fda1a4-762b-4020-b5ad-a41df1933103}&lt;/em:id&gt;
     &lt;em:minVersion&gt;0.5pre&lt;/em:minVersion&gt;
     &lt;em:maxVersion&gt;0.5pre&lt;/em:maxVersion&gt;
   &lt;/Description&gt;
 &lt;/em:requires&gt;
</pre>

<p><strong>Notatki</strong></p>

<ul>
 <li>Currently, only <code>&lt;em:id&gt;</code>, <code>&lt;em:minVersion&gt;</code>, <code>&lt;em:maxVersion&gt;</code> are parsed inside the <code>&lt;em:requires&gt;</code> tag.</li>
 <li>It is not currently possible to add dependencies that are specific to a <code>&lt;em:targetApplication&gt;</code>. See {{ interwiki('wikimo', 'Extension_Manager:Extension_Dependencies', 'wikimo:Extension Manager:Extension Dependencies') }} for more details.</li>
</ul>

<p>{{ Fx_minversion_inline(2) }} This property was added for Firefox/Thunderbird 2. Previous versions of these applications will ignore the restrictions and install the addon regardless of the requirements.</p>

<h2 id="Dokumentacja_przestarza.C5.82ych_w.C5.82asno.C5.9Bci" name="Dokumentacja_przestarza.C5.82ych_w.C5.82asno.C5.9Bci">Dokumentacja przestarzałych własności</h2>

<p>These properties were required in older versions of the Addon Manager, but have been replaced with newer and better mechanisms.</p>

<h3 id="file" name="file">file</h3>

<p><strong>Firefox 1.0</strong> Ta właściwość wskazywała na plik <code>.jar</code>, który zawierała pakiety chrome wymagające rejestracji w Rejestrze Chrome.</p>

<p>Właściwość <code>&lt;em:file&gt;</code> ma złożona obiektową wartość. Adres lokalny wartości wygląda tak: <code>urn:mozilla:extension:file:PlikJar.jar</code> przy czym <code>PlikJar.jar</code> to nazwa pliku jar, który zawiera pliki pakietów chrome. Może to być także nazwa niespakowanego folderu zawierającego pliki pakietów chrome (np. <code>urn:mozilla:extension:file:folder</code>).<strong> In either case, the referenced chrome package file(s) must be placed in the <code>chrome</code> subdirectory of the XPI's top level.</strong></p>

<p>Obiekt ma właściwość <code>package</code> (ze ścieżką wewnątrz pliku lub folderu z pakietami, która prowadzi do pliku <code>contents.rdf</code>, który jest odpowiedzialny za rejestrację pakietu), właściwość <code>locale</code> (jw. tylko, że rejestracji lokalizacji) i właściwość <code>skin</code> (jw. odpowiedzialną za rejestracje motywów).</p>

<p>Obiekt jest zbędny w Firefoksie 1.5 ponieważ <code>chrome.manifest</code> na najwyższym poziomie XPI jest używany do lokalizacji chrome wymagających rejestracji.</p>

<p><strong>Przykłady</strong></p>

<pre class="eval">&lt;em:file&gt;
 &lt;Description about="urn:mozilla:extension:file:wtyka.jar"&gt;
  &lt;em:package&gt;content/wtyka/&lt;/em:package&gt;
  &lt;em:locale&gt;locale/pl/wtyka/&lt;/em:locale&gt;
  &lt;em:skin&gt;skin/classic/wtyka/&lt;em:skin&gt;
 &lt;/Description&gt;
&lt;/em:file&gt;
</pre>

<p>Manifest Instalcji może określać więcej niż jedną właściwość <code>file</code>, po jednej na każdy plik jar lub podfolder zawierający chrome do rejestracji.</p>

<h2 id="Glossary" name="Glossary">Glossary</h2>

<h3 id="restricted_access_area" name="restricted_access_area">restricted access area</h3>

<p>A <em>restricted access area</em> is an install location that could be restricted on a restricted-access account, regardless of whether or not the location is restricted with the current user privileges (zobacz {{ Source("toolkit/mozapps/extensions/public/nsIExtensionManager.idl#80", "nsIInstallLocation::restricted") }}). Currently, the <code>($APPDIR)/extensions</code> folder and the registry install location under <code>HKEY_LOCAL_MACHINE</code> (see <a href="/pl/Adding_Extensions_using_the_Windows_Registry" title="pl/Adding_Extensions_using_the_Windows_Registry">Adding Extensions using the Windows Registry</a> for details) are restricted.</p>

<p>The <code>($PROFILE)/extensions</code> and <code>HKEY_CURRENT_USER</code> install locations, on the other hand, are not restricted.</p>

<h2 id="Wi.C4.99cej_informacji" name="Wi.C4.99cej_informacji">Więcej informacji</h2>

<ul>
 <li>Zobacz <a class="external" href="http://kb.mozillazine.org/Install.rdf">stronę install.rdf w MozillaZine KB</a> po więcej przykładów i informacji na ten temat</li>
</ul>