Compare Revisions

Installing Extensions and Themes From Web Pages

Revision 128332:

Revision 128332 by vika0322 on

Revision 128333:

Revision 128333 by vika0322 on

Title:
Installing Extensions and Themes From Web Pages
Installing Extensions and Themes From Web Pages
Slug:
Installing_Extensions_and_Themes_From_Web_Pages
Installing_Extensions_and_Themes_From_Web_Pages
Tags:
Extensions, Add-ons, Themes
Extensions, Add-ons, Themes
Content:

Revision 128332
Revision 128333
n8      There are a variety of ways you can install <a href="/en/Exn8      &nbsp;
>tensions" title="en/Extensions">extensions</a> and <a href="/en/T 
>hemes" title="en/Themes">themes</a> from web pages, including dir 
>ect linking to the XPI files and using the <a href="/en/XPInstall 
>_API_Reference/InstallTrigger_Object" title="en/XPInstall_API_Ref 
>erence/InstallTrigger_Object">InstallTrigger</a> object.(译:要通过网页来 
>安装扩展和主题,有多种方法可供选择,包括直接链接到XPI文件和使用<a href="/en/XPInstall_API_Refer 
>ence/InstallTrigger_Object" title="en/XPInstall_API_Reference/Ins 
>tallTrigger_Object">InstallTrigger</a>对象。) 
nn11      There are a variety of ways you can install <a href="en/Ext
 >ension">extensions</a> and <a href="en/Themes">themes</a> from we
 >b pages, including direct linking to the XPI files and using the 
 ><a href="en/XPInstall_API_Reference/InstallTrigger_Object">Instal
 >lTrigger</a> object.
12    </p>
13    <p>
11      Extension and web authors are encouraged to use the method 14      Extension and web authors are encouraged to use the method 
>described below to install XPIs, as it provides the best experien>described below to install XPIs, as it provides the best experien
>ce to users.(译:鼓励扩展和网页的开发者使用如下描述的方法来安装XPI文件,这将会给使用者最好的体验。)>ce to users.
n41      Let's go through this piece by piece. The HTML &lt;a&gt; isn44      Let's go through this piece by piece. The HTML &lt;a&gt; is
> the install link. The href attribute contains a direct link to t> the install link. The href attribute contains a direct link to t
>he extension XPI file, this is what will show in the location bar>he extension XPI file, this is what will show in the location bar
> when the link is moused over. Users can save the XPI file to dis> when the link is moused over. Users can save the XPI file to dis
>k easily by right clicking on the link and choosing "Save Link As>k easily by right clicking on the link and choosing "Save Link As
>..."[译:让我们一点一点地看这些代码。HTML标签&lt;a&gt;是用来安装的链接。href属性包含了一个到扩展XPI文件的>..."
>连接,当鼠标经过时这个连接就会在地址栏中显示出来。使用者可以简单地通过点击右键选“另存为...”来保存该XPI文件到本地磁盘。] 
n44      When the link is clicked it calls the function <code>instaln47      When the link is clicked it calls the function <code>instal
>l</code> passing the event object as the parameter.[译:当这个链接被点击时,<>l</code> passing the event object as the parameter.
>code>install函数会被调用,并传递一个事件对象</code>作为参数。] 
n47      The install first creates a parameter block:[译:安装过程首先会创建一个如n50      The install first creates a parameter block:
>下的参数块:] 
n58      This specifies the display name (Foo) for use in the confirn61      This specifies the display name (Foo) for use in the confir
>mation dialog, the URL to the extension (which is the link <code>>mation dialog, the URL to the extension (which is the link <code>
>href</code>, recall), the Icon URL to display in the confirmation>href</code>, recall), the Icon URL to display in the confirmation
> dialog, a hash of the xpi file contents (to protect against corr> dialog, a hash of the xpi file contents (to protect against corr
>upted downloads), and a <code>toString</code> function which will>upted downloads), and a <code>toString</code> function which will
> allow this code to work with versions of Firefox 0.8 and earlier> allow this code to work with versions of Firefox 0.8 and earlier
>. You could also use the old style parameter block (<code>{ "Foo">. You could also use the old style parameter block (<code>{ "Foo"
>: aEvent.target.href }</code>) if you wanted - and didn't have an>: aEvent.target.href }</code>) if you wanted - and didn't have an
> Icon to use for the confirmation dialog.[译:它指定了在确认对话框上的显示名字(Foo)> Icon to use for the confirmation dialog.
>,到扩展的URL(连接的<code>href属性</code>),显示在确认对话框上的图标的URL,xpi文件的hash值(防止下 
>载过程中的错误),和一个用来让该能在Firefox0.8及以前版本上工作的<code>toString函数。如果愿意的话,你可以使 
>用旧的</code>编码风格来写这个参数块(<code>{ "Foo": aEvent.target.href }</code>) 
>,你也可以不指定显示在确认对话框上的图标。] 
n61      <code>InstallTrigger.install</code> is then called to instan64      <code>InstallTrigger.install</code> is then called to insta
>ll the item with the parameter block. [译:接下来<code>InstallTrigger.>ll the item with the parameter block.
>install会被调用,它使用刚才的参数块来安装项目。</code>] 
n67      This last part is the most important - the install functionn70      This last part is the most important - the install function
> must return <code>false</code> so that when the link is clicked,> must return <code>false</code> so that when the link is clicked,
> only the script is run, and the link href is not navigated to. I> only the script is run, and the link href is not navigated to. I
>f you omit this step, the user may see two installation dialogs—s>f you omit this step, the user may see two installation dialogs—s
>ince you've effectively invoked two install requests, one from th>ince you've effectively invoked two install requests, one from th
>e <code>InstallTrigger</code>, one from trying to load the XPI fi>e <code>InstallTrigger</code>, one from trying to load the XPI fi
>le directly.[译:最后一部分是最重要的,install函数必须返回<code>false,这样当链接被点击时</cod>le directly.
>e>只有脚本被运行了,而并未导航到连接的地址。如果你忽略该步,使用者将看到两个安装对话框--因为你成功的调用了两次安装请求,一次来 
>自于<code>InstallTrigger,另一次来自于</code>直接下载XPI文件。] 
n70      Available Parameters for the install object(install对象可使用的参数n73      Available Parameters for the install object
>) 
n73      The <code>InstallTrigger.install</code> method accepts a Jan76      The <code>InstallTrigger.install</code> method accepts a Ja
>vaScript object as a parameter, with several properties on that o>vaScript object as a parameter, with several properties on that o
>bject used to affect the install.[译:<code>InstallTrigger.install<>bject used to affect the install.
>/code> 方法接收一个JavaScript对象作为参数,该参数对象中有一些属性来影响安装。] 
n79      The <code>URL</code> property specifies the URL of the XPI n82      The <code>URL</code> property specifies the URL of the XPI 
>to install. This property is required.[<code>URL属性指定了将被安装的XPI文件的<>to install. This property is required.
>/code>URL.该属性是必须的。] 
n85      The <code>IconURL</code> property specifies an icon to be dn88      The <code>IconURL</code> property specifies an icon to be d
>isplayed in the installation dialog. This property is optional. I>isplayed in the installation dialog. This property is optional. I
>f you do not specify an icon, the default icon will be used, usua>f you do not specify an icon, the default icon will be used, usua
>lly a green puzzle piece. The icon can be any image format suppor>lly a green puzzle piece. The icon can be any image format suppor
>ted by Firefox, and should be 32x32 pixels in size.[译:<code>IconU>ted by Firefox, and should be 32x32 pixels in size.
>RL属性指定一个显示在安装对话框上的图标。如果不指定图标,一个默认的图标就会被使用,通常是一个绿色的拼图块。图标可以是任意被Fir 
>efox</code>支持的格式,但大小应是32x32像素的。] 
n91      The <code>Hash</code> property specifies a cryptographic han94      The <code>Hash</code> property specifies a cryptographic ha
>sh of the XPI file contents. This is used to verify the downloade>sh of the XPI file contents. This is used to verify the downloade
>d file, to protect against a corrupted file being served by a mir>d file, to protect against a corrupted file being served by a mir
>ror download server, for example. You can use any hash function s>ror download server, for example. You can use any hash function s
>upported by <a href="/en/nsICryptoHash" title="en/nsICryptoHash">>upported by <a href="en/NsICryptoHash">nsICryptoHash</a>. The has
>nsICryptoHash</a>. The hash is specified as <code>hash function:h>h is specified as <code>hash function:hash value</code>, for exam
>ash value</code>, for example, <code>sha1:28857e60d043447c5f45508>ple, <code>sha1:28857e60d043447c5f4550853f2d40770b326a13</code>.
>53f2d40770b326a13</code>.[译:<code>Hash属性用于指定XPI文件内容的</code>加密hash 
>值。这被用来验证下载文件,例如,可以防止一个错误的XPI文件被放在镜像服务器上被下载。可以使用被<a href="/en/nsIC 
>ryptoHash" title="en/nsICryptoHash">nsICryptoHash</a>支持的hash函数。该h 
>ash值的格式为 hash函数:hash值,例如:<code>sha1:28857e60d043447c5f4550853f2d4 
>0770b326a13。</code>] 
n97      The <code>toString()</code> property should return the XPI n100      The <code>toString()</code> property should return the XPI 
>URL, for compatibility with Firefox browsers older than version 1>URL, for compatibility with Firefox browsers older than version 1
>.0, and other applications such as Seamonkey.[译:<code>toString()属>.0, and other applications such as Seamonkey.
>性应当返回</code>XPI 的URL,主要是为了兼容早于1.0版本的浏览器和其它程序如Seamonkey。] 
t123    </p>t
124    <p>
125      {{ languages( { "fr": "fr/Installation_d\'extensions_et_de_126    </p>{{ languages( { "fr": "fr/Installation_d\'extensions_et_d
>th\u00e8mes_depuis_une_page_Web", "ja": "ja/Installing_Extensions>e_th\u00e8mes_depuis_une_page_Web", "ja": "ja/Installing_Extensio
>_and_Themes_From_Web_Pages" } ) }}>ns_and_Themes_From_Web_Pages" } ) }}
126    </p>

Back to History