mozilla

Compare Revisions

AddonManager

Change Revisions

Revision 65144:

Revision 65144 by trevorh on

Revision 65145:

Revision 65145 by trevorh on

Title:
AddonManager
AddonManager
Slug:
Addons/Add-on_Manager/AddonManager
Addons/Add-on_Manager/AddonManager
Tags:
NeedsTechnicalReview, Add-ons, NeedsEditorialReview, Interfaces, Interfaces:Scriptable, "Add-on Manager"
NeedsTechnicalReview, Add-ons, NeedsEditorialReview, Interfaces, Interfaces:Scriptable, "Add-on Manager"
Content:

Revision 65144
Revision 65145
n14      One of the forces of the AddonManager is that it deals withn14      One of the forces of the AddonManager is that it deals with
> any kind (type) of addon in generic manner. To do so many method> any kind (type) of addon in generic manner. To do so many method
>s of the AddonManager take the addon types as parameters. The exi>s of the AddonManager take the addon types as parameters. The exi
>sting addon types are defined in <a class=" external" href="http:>sting addon types are defined in {{ source("toolkit/mozapps/exten
>//mxr.mozilla.org/mozilla-central/source/toolkit/mozapps/extensio>sions/XPIProvider.jsm","XPIProvider.jsm") }} and are, at this tim
>ns/XPIProvider.jsm" title="http://mxr.mozilla.org/mozilla-central>e, the following: <code>extension</code>, <code>theme</code>, <co
>/source/toolkit/mozapps/extensions/XPIProvider.jsm">XPIProvider.j>de>locale</code>, <code>multipackage</code>.
>sm</a> and are, at this time, the following: <span id="the-code"> 
><code>extension</code>, <code>theme</code>, <code>locale</code>,< 
>/span> <code><span id="the-code"><span class="a">multipackage</sp 
>an></span></code>. 
nn107        <tr>
108          <td>
109            <code>{{ Interface("nsIURI") }} <a href="#getURIForRe
 >sourceInFile()">getURIForResourceInFile</a>(in {{ Interface("nsIF
 >ile") }} aFile, in string aPath)</code> {{ gecko_minversion_inlin
 >e("7.0") }}
110          </td>
111        </tr>
n112    <table class="standard-table" style="width: auto;">n117    <table class="standard-table">
n204        The {{ AMInterface("Addon") }} passed back from the asyncn209        The {{ AMInterface("Addon") }} passed back from the async
>hronous request.&nbsp; If an error occurred (such an addon not be>hronous request. If an error occurred (such an addon not being fo
>ing found), <code><code>null</code></code> is passed back instead>und), <code>null</code> is passed back instead.
>. 
n424    <table class="standard-table" style="font-size: 14px; margin-n429    <table class="standard-table">
>bottom: 1.286em; border-collapse: collapse; border-top-color: rgb 
>(211, 211, 211); border-right-color: rgb(211, 211, 211); border-b 
>ottom-color: rgb(211, 211, 211); border-left-color: rgb(211, 211, 
> 211); border-top-width: 1px; border-right-width: 1px; border-bot 
>tom-width: 1px; border-left-width: 1px; border-top-style: dotted; 
> border-right-style: dotted; border-bottom-style: dotted; border- 
>left-style: dotted;"> 
n427          <td class="header" style="font-family: inherit; font-sin432          <td class="header">
>ze: inherit; color: inherit; padding-top: 0px; padding-right: 5px 
>; padding-bottom: 0px; padding-left: 5px; border-top-width: 1px;  
>border-right-width: 1px; border-bottom-width: 1px; border-left-wi 
>dth: 1px; border-top-style: solid; border-right-style: solid; bor 
>der-bottom-style: solid; border-left-style: solid; border-top-col 
>or: rgb(187, 187, 187); border-right-color: rgb(187, 187, 187); b 
>order-bottom-color: rgb(187, 187, 187); border-left-color: rgb(18 
>7, 187, 187); text-align: left; vertical-align: top; background-i 
>mage: initial; background-attachment: initial; background-origin: 
> initial; background-clip: initial; background-color: rgb(238, 23 
>8, 238); font-weight: bold; background-position: initial initial; 
> background-repeat: initial initial;"> 
n430          <td class="header" style="font-family: inherit; font-sin435          <td class="header">
>ze: inherit; color: inherit; padding-top: 0px; padding-right: 5px 
>; padding-bottom: 0px; padding-left: 5px; border-top-width: 1px;  
>border-right-width: 1px; border-bottom-width: 1px; border-left-wi 
>dth: 1px; border-top-style: solid; border-right-style: solid; bor 
>der-bottom-style: solid; border-left-style: solid; border-top-col 
>or: rgb(187, 187, 187); border-right-color: rgb(187, 187, 187); b 
>order-bottom-color: rgb(187, 187, 187); border-left-color: rgb(18 
>7, 187, 187); text-align: left; vertical-align: top; background-i 
>mage: initial; background-attachment: initial; background-origin: 
> initial; background-clip: initial; background-color: rgb(238, 23 
>8, 238); font-weight: bold; background-position: initial initial; 
> background-repeat: initial initial;"> 
n435          <td style="font-family: inherit; font-size: inherit; pan440          <td>
>dding-top: 5px; padding-right: 5px; padding-bottom: 5px; padding- 
>left: 5px; border-top-width: 1px; border-right-width: 1px; border 
>-bottom-width: 1px; border-left-width: 1px; border-top-style: dot 
>ted; border-right-style: dotted; border-bottom-style: dotted; bor 
>der-left-style: dotted; border-top-color: rgb(211, 211, 211); bor 
>der-right-color: rgb(211, 211, 211); border-bottom-color: rgb(211 
>, 211, 211); border-left-color: rgb(211, 211, 211); text-align: l 
>eft; vertical-align: top; color: inherit;"> 
n438          <td style="font-family: inherit; font-size: inherit; con443          <td>
>lor: inherit; padding-top: 5px; padding-right: 5px; padding-botto 
>m: 5px; padding-left: 5px; border-top-width: 1px; border-right-wi 
>dth: 1px; border-bottom-width: 1px; border-left-width: 1px; borde 
>r-top-style: dotted; border-right-style: dotted; border-bottom-st 
>yle: dotted; border-left-style: dotted; border-top-color: rgb(211 
>, 211, 211); border-right-color: rgb(211, 211, 211); border-botto 
>m-color: rgb(211, 211, 211); border-left-color: rgb(211, 211, 211 
>); text-align: left; vertical-align: top;"> 
n443          <td style="font-family: inherit; font-size: inherit; con
>lor: inherit; padding-top: 5px; padding-right: 5px; padding-botto 
>m: 5px; padding-left: 5px; border-top-width: 1px; border-right-wi 
>dth: 1px; border-bottom-width: 1px; border-left-width: 1px; borde 
>r-top-style: dotted; border-right-style: dotted; border-bottom-st 
>yle: dotted; border-left-style: dotted; border-top-color: rgb(211 
>, 211, 211); border-right-color: rgb(211, 211, 211); border-botto 
>m-color: rgb(211, 211, 211); border-left-color: rgb(211, 211, 211 
>); text-align: left; vertical-align: top;"> 
444            <code style="font: normal normal normal 100%/normal '
>Courier New', 'Andale Mono', monospace; color: inherit; font-weig 
>ht: inherit;">UPDATE_STATUS_TIMEOUT</code> 
445          </td>448          <td>
446          <td style="font-family: inherit; font-size: inherit; co449            <code>UPDATE_STATUS_TIMEOUT</code>
>lor: inherit; padding-top: 5px; padding-right: 5px; padding-botto 
>m: 5px; padding-left: 5px; border-top-width: 1px; border-right-wi 
>dth: 1px; border-bottom-width: 1px; border-left-width: 1px; borde 
>r-top-style: dotted; border-right-style: dotted; border-bottom-st 
>yle: dotted; border-left-style: dotted; border-top-color: rgb(211 
>, 211, 211); border-right-color: rgb(211, 211, 211); border-botto 
>m-color: rgb(211, 211, 211); border-left-color: rgb(211, 211, 211 
>); text-align: left; vertical-align: top;"> 
450          </td>
451          <td>
n451          <td style="font-family: inherit; font-size: inherit; con
>lor: inherit; padding-top: 5px; padding-right: 5px; padding-botto 
>m: 5px; padding-left: 5px; border-top-width: 1px; border-right-wi 
>dth: 1px; border-bottom-width: 1px; border-left-width: 1px; borde 
>r-top-style: dotted; border-right-style: dotted; border-bottom-st 
>yle: dotted; border-left-style: dotted; border-top-color: rgb(211 
>, 211, 211); border-right-color: rgb(211, 211, 211); border-botto 
>m-color: rgb(211, 211, 211); border-left-color: rgb(211, 211, 211 
>); text-align: left; vertical-align: top;"> 
452            <code style="font: normal normal normal 100%/normal '
>Courier New', 'Andale Mono', monospace; color: inherit; font-weig 
>ht: inherit;">UPDATE_STATUS_DOWNLOAD_ERROR</code> 
453          </td>456          <td>
454          <td style="font-family: inherit; font-size: inherit; co457            <code>UPDATE_STATUS_DOWNLOAD_ERROR</code>
>lor: inherit; padding-top: 5px; padding-right: 5px; padding-botto 
>m: 5px; padding-left: 5px; border-top-width: 1px; border-right-wi 
>dth: 1px; border-bottom-width: 1px; border-left-width: 1px; borde 
>r-top-style: dotted; border-right-style: dotted; border-bottom-st 
>yle: dotted; border-left-style: dotted; border-top-color: rgb(211 
>, 211, 211); border-right-color: rgb(211, 211, 211); border-botto 
>m-color: rgb(211, 211, 211); border-left-color: rgb(211, 211, 211 
>); text-align: left; vertical-align: top;"> 
458          </td>
459          <td>
n459          <td style="font-family: inherit; font-size: inherit; con
>lor: inherit; padding-top: 5px; padding-right: 5px; padding-botto 
>m: 5px; padding-left: 5px; border-top-width: 1px; border-right-wi 
>dth: 1px; border-bottom-width: 1px; border-left-width: 1px; borde 
>r-top-style: dotted; border-right-style: dotted; border-bottom-st 
>yle: dotted; border-left-style: dotted; border-top-color: rgb(211 
>, 211, 211); border-right-color: rgb(211, 211, 211); border-botto 
>m-color: rgb(211, 211, 211); border-left-color: rgb(211, 211, 211 
>); text-align: left; vertical-align: top;"> 
460            <code style="font: normal normal normal 100%/normal '
>Courier New', 'Andale Mono', monospace; color: inherit; font-weig 
>ht: inherit;">UPDATE_STATUS_PARSE_ERROR</code> 
461          </td>464          <td>
462          <td style="font-family: inherit; font-size: inherit; co465            <code>UPDATE_STATUS_PARSE_ERROR</code>
>lor: inherit; padding-top: 5px; padding-right: 5px; padding-botto 
>m: 5px; padding-left: 5px; border-top-width: 1px; border-right-wi 
>dth: 1px; border-bottom-width: 1px; border-left-width: 1px; borde 
>r-top-style: dotted; border-right-style: dotted; border-bottom-st 
>yle: dotted; border-left-style: dotted; border-top-color: rgb(211 
>, 211, 211); border-right-color: rgb(211, 211, 211); border-botto 
>m-color: rgb(211, 211, 211); border-left-color: rgb(211, 211, 211 
>); text-align: left; vertical-align: top;"> 
466          </td>
467          <td>
n467          <td style="font-family: inherit; font-size: inherit; con
>lor: inherit; padding-top: 5px; padding-right: 5px; padding-botto 
>m: 5px; padding-left: 5px; border-top-width: 1px; border-right-wi 
>dth: 1px; border-bottom-width: 1px; border-left-width: 1px; borde 
>r-top-style: dotted; border-right-style: dotted; border-bottom-st 
>yle: dotted; border-left-style: dotted; border-top-color: rgb(211 
>, 211, 211); border-right-color: rgb(211, 211, 211); border-botto 
>m-color: rgb(211, 211, 211); border-left-color: rgb(211, 211, 211 
>); text-align: left; vertical-align: top;"> 
468            <code style="font: normal normal normal 100%/normal '
>Courier New', 'Andale Mono', monospace; color: inherit; font-weig 
>ht: inherit;">UPDATE_STATUS_UNKNOWN_FORMAT</code> 
469          </td>472          <td>
470          <td style="font-family: inherit; font-size: inherit; co473            <code>UPDATE_STATUS_UNKNOWN_FORMAT</code>
>lor: inherit; padding-top: 5px; padding-right: 5px; padding-botto 
>m: 5px; padding-left: 5px; border-top-width: 1px; border-right-wi 
>dth: 1px; border-bottom-width: 1px; border-left-width: 1px; borde 
>r-top-style: dotted; border-right-style: dotted; border-bottom-st 
>yle: dotted; border-left-style: dotted; border-top-color: rgb(211 
>, 211, 211); border-right-color: rgb(211, 211, 211); border-botto 
>m-color: rgb(211, 211, 211); border-left-color: rgb(211, 211, 211 
>); text-align: left; vertical-align: top;"> 
474          </td>
471            <p>475          <td>
472              The update was not in any known format.476            The update was not in any known format.
473            </p>477          </td>
478        </tr>
479        <tr>
474          </td>480          <td>
481            <code>UPDATE_STATUS_SECURITY_ERROR</code>
475        </tr>482          </td>
476        <tr>
477          <td style="font-family: inherit; font-size: inherit; co
>lor: inherit; padding-top: 5px; padding-right: 5px; padding-botto 
>m: 5px; padding-left: 5px; border-top-width: 1px; border-right-wi 
>dth: 1px; border-bottom-width: 1px; border-left-width: 1px; borde 
>r-top-style: dotted; border-right-style: dotted; border-bottom-st 
>yle: dotted; border-left-style: dotted; border-top-color: rgb(211 
>, 211, 211); border-right-color: rgb(211, 211, 211); border-botto 
>m-color: rgb(211, 211, 211); border-left-color: rgb(211, 211, 211 
>); text-align: left; vertical-align: top;"> 
478            <code style="font: normal normal normal 100%/normal '
>Courier New', 'Andale Mono', monospace; color: inherit; font-weig 
>ht: inherit;">UPDATE_STATUS_SECURITY_ERROR</code> 
479          </td>483          <td>
480          <td style="font-family: inherit; font-size: inherit; co
>lor: inherit; padding-top: 5px; padding-right: 5px; padding-botto 
>m: 5px; padding-left: 5px; border-top-width: 1px; border-right-wi 
>dth: 1px; border-bottom-width: 1px; border-left-width: 1px; borde 
>r-top-style: dotted; border-right-style: dotted; border-bottom-st 
>yle: dotted; border-left-style: dotted; border-top-color: rgb(211 
>, 211, 211); border-right-color: rgb(211, 211, 211); border-botto 
>m-color: rgb(211, 211, 211); border-left-color: rgb(211, 211, 211 
>); text-align: left; vertical-align: top;"> 
481            <p>
482              The update information was not correctly signed or 484            The update information was not correctly signed or th
>there was an SSL error.>ere was an SSL error.
483            </p>
n491    <table class="standard-table" style="font-size: 14px; margin-n492    <table class="standard-table">
>bottom: 1.286em; border-collapse: collapse; border-top-color: rgb 
>(211, 211, 211); border-right-color: rgb(211, 211, 211); border-b 
>ottom-color: rgb(211, 211, 211); border-left-color: rgb(211, 211, 
> 211); border-top-width: 1px; border-right-width: 1px; border-bot 
>tom-width: 1px; border-left-width: 1px; border-top-style: dotted; 
> border-right-style: dotted; border-bottom-style: dotted; border- 
>left-style: dotted;"> 
n494          <td class="header" style="font-family: inherit; font-sin495          <td class="header">
>ze: inherit; color: inherit; padding-top: 0px; padding-right: 5px 
>; padding-bottom: 0px; padding-left: 5px; border-top-width: 1px;  
>border-right-width: 1px; border-bottom-width: 1px; border-left-wi 
>dth: 1px; border-top-style: solid; border-right-style: solid; bor 
>der-bottom-style: solid; border-left-style: solid; border-top-col 
>or: rgb(187, 187, 187); border-right-color: rgb(187, 187, 187); b 
>order-bottom-color: rgb(187, 187, 187); border-left-color: rgb(18 
>7, 187, 187); text-align: left; vertical-align: top; background-i 
>mage: initial; background-attachment: initial; background-origin: 
> initial; background-clip: initial; background-color: rgb(238, 23 
>8, 238); font-weight: bold; background-position: initial initial; 
> background-repeat: initial initial;"> 
n497          <td class="header" style="font-family: inherit; font-sin498          <td class="header">
>ze: inherit; color: inherit; padding-top: 0px; padding-right: 5px 
>; padding-bottom: 0px; padding-left: 5px; border-top-width: 1px;  
>border-right-width: 1px; border-bottom-width: 1px; border-left-wi 
>dth: 1px; border-top-style: solid; border-right-style: solid; bor 
>der-bottom-style: solid; border-left-style: solid; border-top-col 
>or: rgb(187, 187, 187); border-right-color: rgb(187, 187, 187); b 
>order-bottom-color: rgb(187, 187, 187); border-left-color: rgb(18 
>7, 187, 187); text-align: left; vertical-align: top; background-i 
>mage: initial; background-attachment: initial; background-origin: 
> initial; background-clip: initial; background-color: rgb(238, 23 
>8, 238); font-weight: bold; background-position: initial initial; 
> background-repeat: initial initial;"> 
n502          <td style="font-family: inherit; font-size: inherit; con
>lor: inherit; padding-top: 5px; padding-right: 5px; padding-botto 
>m: 5px; padding-left: 5px; border-top-width: 1px; border-right-wi 
>dth: 1px; border-bottom-width: 1px; border-left-width: 1px; borde 
>r-top-style: dotted; border-right-style: dotted; border-bottom-st 
>yle: dotted; border-left-style: dotted; border-top-color: rgb(211 
>, 211, 211); border-right-color: rgb(211, 211, 211); border-botto 
>m-color: rgb(211, 211, 211); border-left-color: rgb(211, 211, 211 
>); text-align: left; vertical-align: top;"> 
503            <code style="font: normal normal normal 100%/normal '
>Courier New', 'Andale Mono', monospace; color: inherit; font-weig 
>ht: inherit;">AUTOUPDATE_DISABLE</code> 
504          </td>503          <td>
505          <td style="font-family: inherit; font-size: inherit; co504            <code>AUTOUPDATE_DISABLE</code>
>lor: inherit; padding-top: 5px; padding-right: 5px; padding-botto 
>m: 5px; padding-left: 5px; border-top-width: 1px; border-right-wi 
>dth: 1px; border-bottom-width: 1px; border-left-width: 1px; borde 
>r-top-style: dotted; border-right-style: dotted; border-bottom-st 
>yle: dotted; border-left-style: dotted; border-top-color: rgb(211 
>, 211, 211); border-right-color: rgb(211, 211, 211); border-botto 
>m-color: rgb(211, 211, 211); border-left-color: rgb(211, 211, 211 
>); text-align: left; vertical-align: top;"> 
505          </td>
506          <td>
n510          <td style="font-family: inherit; font-size: inherit; con
>lor: inherit; padding-top: 5px; padding-right: 5px; padding-botto 
>m: 5px; padding-left: 5px; border-top-width: 1px; border-right-wi 
>dth: 1px; border-bottom-width: 1px; border-left-width: 1px; borde 
>r-top-style: dotted; border-right-style: dotted; border-bottom-st 
>yle: dotted; border-left-style: dotted; border-top-color: rgb(211 
>, 211, 211); border-right-color: rgb(211, 211, 211); border-botto 
>m-color: rgb(211, 211, 211); border-left-color: rgb(211, 211, 211 
>); text-align: left; vertical-align: top;"> 
511            <code style="font: normal normal normal 100%/normal '
>Courier New', 'Andale Mono', monospace; color: inherit; font-weig 
>ht: inherit;">AUTOUPDATE_DEFAULT</code> 
512          </td>511          <td>
513          <td style="font-family: inherit; font-size: inherit; co512            <code>AUTOUPDATE_DEFAULT</code>
>lor: inherit; padding-top: 5px; padding-right: 5px; padding-botto 
>m: 5px; padding-left: 5px; border-top-width: 1px; border-right-wi 
>dth: 1px; border-bottom-width: 1px; border-left-width: 1px; borde 
>r-top-style: dotted; border-right-style: dotted; border-bottom-st 
>yle: dotted; border-left-style: dotted; border-top-color: rgb(211 
>, 211, 211); border-right-color: rgb(211, 211, 211); border-botto 
>m-color: rgb(211, 211, 211); border-left-color: rgb(211, 211, 211 
>); text-align: left; vertical-align: top;"> 
513          </td>
514          <td>
n518          <td style="font-family: inherit; font-size: inherit; con
>lor: inherit; padding-top: 5px; padding-right: 5px; padding-botto 
>m: 5px; padding-left: 5px; border-top-width: 1px; border-right-wi 
>dth: 1px; border-bottom-width: 1px; border-left-width: 1px; borde 
>r-top-style: dotted; border-right-style: dotted; border-bottom-st 
>yle: dotted; border-left-style: dotted; border-top-color: rgb(211 
>, 211, 211); border-right-color: rgb(211, 211, 211); border-botto 
>m-color: rgb(211, 211, 211); border-left-color: rgb(211, 211, 211 
>); text-align: left; vertical-align: top;"> 
519            <code style="font: normal normal normal 100%/normal '
>Courier New', 'Andale Mono', monospace; color: inherit; font-weig 
>ht: inherit;">AUTOUPDATE_ENABLE</code> 
520          </td>519          <td>
521          <td style="font-family: inherit; font-size: inherit; co520            <code>AUTOUPDATE_ENABLE</code>
>lor: inherit; padding-top: 5px; padding-right: 5px; padding-botto 
>m: 5px; padding-left: 5px; border-top-width: 1px; border-right-wi 
>dth: 1px; border-bottom-width: 1px; border-left-width: 1px; borde 
>r-top-style: dotted; border-right-style: dotted; border-bottom-st 
>yle: dotted; border-left-style: dotted; border-top-color: rgb(211 
>, 211, 211); border-right-color: rgb(211, 211, 211); border-botto 
>m-color: rgb(211, 211, 211); border-left-color: rgb(211, 211, 211 
>); text-align: left; vertical-align: top;"> 
521          </td>
522          <td>
n991        the {{ Interface("nsIURI") }} that started the installsn992        The {{ Interface("nsIURI") }} that started the installs
tt1271    <p>
1272      {{ Method_gecko_minversion("getURIForResourceInFile","7.0")
 > }}
1273    </p>
1274    <pre class="eval">
1275{{ Interface("nsIURI") }} getURIForResourceInFile(
1276  in {{ Interface("nsIFile") }} aFile,
1277  in string aPath
1278)
1279</pre>
1280    <h6>
1281      Parameters
1282    </h6>
1283    <dl>
1284      <dt>
1285        aFile
1286      </dt>
1287      <dd>
1288        The {{ Interface("nsIFile") }} containing the resources, 
 >must be either a directory or an XPI file.
1289      </dd>
1290      <dt>
1291        aPath
1292      </dt>
1293      <dd>
1294        The path to find the resource at, "/" separated. If <code
 >>aPath</code> is empty then the URI to the root of the contained 
 >files will be returned.
1295      </dd>
1296    </dl>
1297    <h6>
1298      Returns
1299    </h6>
1300    <p>
1301      An {{ Interface("nsIURI") }} pointing at the resource.
1302    </p>

Back to History