Compare Revisions

Extension Versioning, Update and Compatibility

Change Revisions

Revision 17845:

Revision 17845 by Nsteven on

Revision 17846:

Revision 17846 by Nsteven on

Title:
Extension Versioning, Update and Compatibility
Extension Versioning, Update and Compatibility
Slug:
Extension_Versioning,_Update_and_Compatibility
Extension_Versioning,_Update_and_Compatibility
Tags:
Extensions, Add-ons
Extensions, Add-ons
Content:

Revision 17845
Revision 17846
n47      Firefox uses the pref <code>app.extensions.version</code> tn47      Firefox 1.0 and below use the pref <code>app.extensions.ver
>o determine Extension compatibility for this release. When an Ext>sion</code> to determine Extension compatibility for this release
>ension is installed, Firefox makes sure that <code>app.extensions>. When an Extension is installed, Firefox makes sure that <code>a
>.version</code> lies within the range set up by the Extension's i>pp.extensions.version</code> lies within the range set up by the 
>nstall.rdf file using minVersion and maxVersion. If <code>app.ext>Extension's install.rdf file using minVersion and maxVersion. If 
>ensions.version</code> is less than minVersion, a newer version o><code>app.extensions.version</code> is less than minVersion, a ne
>f Firefox is required to install the Extension, if it is greater >wer version of Firefox is required to install the Extension, if i
>than maxVersion, Firefox is too new to install the extension.>t is greater than maxVersion, Firefox is too new to install the e
 >xtension.
48    </p>
49    <p>48    </p>
49    <p>
50      If this basic compatibility check fails, Firefox will then 50      If this basic compatibility check fails, Firefox will then 
>attempt to "phone home" and obtain newer compatibility informatio>attempt to "phone home" and obtain newer compatibility informatio
>n for the Extension. If the Extension's install.rdf file specifie>n for the Extension. If the Extension's install.rdf file specifie
>s an update RDF file, this will be loaded and newer information d>s an update RDF file, this will be loaded and newer information d
>iscovered there (see below for format). If none is supplied, Fire>iscovered there (see below for format). If none is supplied, Fire
>fox will check the generic update service running on addons.mozil>fox will check addons.mozilla.org; if the Extension is hosted the
>la.org, and if the Extension is hosted there and has newer compat>re and has newer compatibility information, this will be read and
>ibility information it will be read and the local information upd> the local information updated.
>ated. 
n59      app.extensions.version is not used in Firefox 1.5.n59      <code>app.extensions.version</code> is not used in Firefox 
 >1.5 or later.
n62      The app.extensions.version pref will be incremented every tn62      The <code>app.extensions.version</code> pref will be increm
>ime there are changes that might break extension authors, or ever>ented every time there are changes that might break extensions. W
>y minor release, i.e. 0.9, 1.0, 1.1, etc. If a point release cont>ith every minor release, e.g. 0.9, 1.0, 1.1, etc., or point relea
>ains changes (heaven forbid) that might break extensions, we'll r>se that might break extensions, we'll rev this pref. Every time w
>ev it then too. Every time we rev this pref, we will publically a>e do so, we will publicly announce our intent to do so.
>nnounce our intent to do so. 
n77      This is <b>only</b> for people who <i>know what they're doin77      This is <b>only</b> for people who <i>know what they're doi
>ng</i>. To install an Extension that is incompatible with the bui>ng</i>. To install an Extension that is incompatible with the bui
>ld you're using, open <code>about:config</code> and type <code>ap>ld you're using, open <code>about:config</code> and type <code>ap
>p.extensions.version</code> - and set the value of this pref to a>p.extensions.version</code>. Set the value of this pref to a vers
> version number that is compatible with the Extension. Now try in>ion number that is compatible with the Extension. Now try install
>stalling the Extension. For safety's sake, reset the pref to its >ing the Extension. For safety's sake, reset the pref to its defau
>default value (Right click on the pref in about:config and choose>lt value (Right click on the pref in about:config and choose "Res
> "Reset Pref") so that you don't inadvertedly install incompatibl>et Pref") so that you don't inadvertently install incompatible Ex
>e Extensions at a later point. Firefox allows Extension sites to >tensions later. Firefox allows Extension sites to see what Extens
>see what Extension version it is running with, so if you change t>ion version it is running with, so if you change this and forget 
>his and forget to reset it then browse to an Extension site, you >to reset it then browse to an Extension site, you may install inc
>may install incompatible Extensions that mess up your browser.>ompatible Extensions that mess up your browser.
78    </p>
79    <p>78    </p>
79    <p>
80      <b>If you mess things up doing this</b> read the next secti80      <b>If you do mess things up,</b> read the next section abou
>on about using the Safe Mode to recover.>t using Safe Mode to recover.
n86      In the Program Group the Firefox installer created in your n86      In the Program Group the Firefox installer created in your 
>Start menu you will find an item called, "Firefox (Safe Mode)" - >Start menu you will find an item called, "Firefox (Safe Mode)" - 
>if you run into problems, such as the browser not starting, perfo>if you run into problems, such as browser startup failure, degrad
>rmance being degraded, etc, try running by using this shortcut in>ed performance, etc., try running Firefox with this shortcut inst
>stead of your usual one, if things improve try uninstalling the l>ead of your usual one. If performance is better, you can try unin
>ast Extension(s) you installed.>stalling the last Extension(s) you installed.
87    </p>
88    <p>87    </p>
89      If you did not install the Start Menu Program Group, or you
>'re on Linux, start Firefox with the <code>-safe-mode</code> comm 
>and line switch: 
90    </p>88    <p>
89      You can also run safe mode on Windows or Linux from the com
 >mand line using the <code>safe-mode</code> switch:
90    </p>
91    <p>
92      Windows:
93    </p>
t92./firefox -safe-modet95&lt;Path to Firefox directory&gt;/firefox -safe-mode
96</pre>
97    <p>
98      Linux:
99    </p>
100    <pre class="eval">
101&lt;Path to Firefox directory (if necessary)&gt;/firefox -safe-mo
 >de

Back to History