Dev : Extensions : Extension does not install: Difference between revisions

From MozillaZine Knowledge Base
Jump to navigationJump to search
Line 36: Line 36:
*'''Mixed case in extension's package name'''. Use lower case for chrome package name. ([https://bugzilla.mozilla.org/show_bug.cgi?id=257997 bug 257997], [https://bugzilla.mozilla.org/show_bug.cgi?id=132183 bug 132183]). Symptoms: Firefox is completely hosed or doesn't open windows that belong to your extension.
*'''Mixed case in extension's package name'''. Use lower case for chrome package name. ([https://bugzilla.mozilla.org/show_bug.cgi?id=257997 bug 257997], [https://bugzilla.mozilla.org/show_bug.cgi?id=132183 bug 132183]). Symptoms: Firefox is completely hosed or doesn't open windows that belong to your extension.
*'''<script> tags with wrong URL.''' (Overlayed) window doesn't open [mozilla tries to load the script from unexistent location].
*'''<script> tags with wrong URL.''' (Overlayed) window doesn't open [mozilla tries to load the script from unexistent location].
*'''Not a valid package'''.  This error is displayed before your extension finishes installing.  You need to make sure that when you upload your finished extension via FTP, that the transfer type of your .XPI package is set to binary and not ASCII.
*'''Not a valid package'''.  This error is displayed before your extension finishes installing.  If you are uploading your XPI package via FTP, you need to make sure that the transfer type of your XPI package is set to ''binary'' and not ''ASCII''.


===Pre-1.0 releases===
===Pre-1.0 releases===

Revision as of 10:33, 17 April 2005

This page is part of the extension development documentation project.

Ask your questions in MozillaZine Forums. Also try browsing example code.

Note: development documentation is in process of being moved to Mozilla Development Center (MDC).

Introduction

This page describes possible reasons for extension installation problems. Intended audience is extension developers, not end-users. If you have problems with installing extensions in general, you should search somewhere else.

If you are extension developer, you can't get your (recently packaged) extension installed and suspect the problem is with your extension, this is the right page.

Covered applications are Firefox and Thunderbird.

Possible causes

This item will be installed...

This problem is almost always caused by mistakes in your install.rdf file. Take a look at that link to see an example of good install.rdf.

Some known causes include:

  • Malformed XML/RDF in install.rdf.. Make sure your install.rdf is valid XML by renaming it to install.xml and opening in Firefox. If it doesn't show any XML errors, you're ok. A good idea is to make sure your install.rdf is well-formed RDF too. There's an RDF validator at w3.org (it displays some warnings even for correct install.rdf, but that's ok).
  • Wrong information in install.rdf. Triple-check your install.rdf. The following mistakes are likely to cause the "will be installed" bug:
    • Typos in <em:file> tag. For example your jar file is named differently or placed in wrong directory. You may also have wrong directory structure. Another known problem is forgotten slash after directory name in <em:package> <em:locale> or <em:skin>. That is when you have <em:package>content/myext</em:package> instead of <em:package>content/myext/</em:package>, the Extension manager will not install the extension.

Other

Other possible issues are listed here:

  • Not ZIP archive. You might have packed your extension in a fancy format that the EM cannot understand. You should use simple ZIP format for both XPI and JAR files.
  • Mixed case in extension's package name. Use lower case for chrome package name. (bug 257997, bug 132183). Symptoms: Firefox is completely hosed or doesn't open windows that belong to your extension.
  • <script> tags with wrong URL. (Overlayed) window doesn't open [mozilla tries to load the script from unexistent location].
  • Not a valid package. This error is displayed before your extension finishes installing. If you are uploading your XPI package via FTP, you need to make sure that the transfer type of your XPI package is set to binary and not ASCII.

Pre-1.0 releases

  • Bad target application. That was a problem with early aviary builds.
  • Another possible cause is bug 252543. Triggers when you have components in myext.xpi/components/ that overwrite existing files in components/ (often when upgrading). The bug is fixed for 0.10, possible workaround for 0.9.x is use new names for files in components/ for each new release.
  • Bad contents.rdf. (shows an error box with Thunderbird/Firefox 1.0?)