XULRunner 1.8.0.4 Release Notes

From MDC

XULRunner 1.8.0.4 is a stable developer preview of the Mozilla XULRunner application framework. It replaces version 1.8.0.1; all users should upgrade. It provides facilities for launching standalone XUL applications and embedding APIs which can be used to render web pages within native and Java applications.

Contents 1 System Requirements 2 Installing XULRunner 2.1 Windows 2.2 Mac OS X 2.3 Linux 3 Uninstalling XULRunner 3.1 Linux 3.2 Windows 3.3 Mac OS X 4 Installing XUL Applications 4.1 Windows 4.2 Mac OS X 4.3 Linux 5 Known Issues 6 Frequently Asked Questions

[edit] System Requirements

Before installing, make sure your computer meets the system requirements. The system requirements for XULRunner are the same as the system requirements for Firefox.

[edit] Installing XULRunner

Mozilla provides XULRunner for Windows, Mac OS X, and Linux, in English:

• Download XULRunner for Windows
• Download XULRunner for Mac OS X
• Download XULRunner for Linux

[edit] Windows

• Unpack the ZIP file to a new directory using an archive tool (7zip is recommended). The following directory is recommended: C:\Program Files\Mozilla XULRunner\1.8.0.4 .
• To register XULRunner with the system, open a command prompt and run xulrunner.exe --register-global (to register for all users) or xulrunner.exe --register-user (to register for one user only).

[edit] Mac OS X

• Open the .pkg file within the installer and follow the directions.

[edit] Linux

• Unpack the tarball to a new directory using tar -xzf xulrunner-1.8.0.4.en-US.linux-i686.tar.gz. The following directory is recommended: /opt/xulrunner/1.8.0.4 .
• Register XULRunner with the system by running xulrunner --register-global (to install for all users, must be run as root) or xulrunner --register-user (to install for one user only).

[edit] Uninstalling XULRunner

[edit] Linux

• From a command prompt, run xulrunner --unregister-global or xulrunner --unregister-user to unregister XULRunner just as you registered it during installation.
• Remove the XULRunner directory.

[edit] Windows

• From a command prompt, run xulrunner.exe --unregister-global or xulrunner.exe --unregister-user to unregister XULRunner just as you registered it during installation.
• Remove the XULRunner directory.

[edit] Mac OS X

If you have multiple versions of XULRunner installed on Mac OS X, it is not possible to uninstall only one version.

• To remove all installed versions of XULRunner, remove the /Library/Frameworks/XUL.framework directory.

[edit] Installing XUL Applications

XUL applications can be obtained from various sources, and are typically packaged as a ZIP archive with the extension .xulapp or .xpi. Sample applications are available from the Mozilla Developer Center.

• Save the application archive to your desktop or another convenient place.

[edit] Windows

Run the following command from the Start Menu -> Run or from a command prompt:

"C:\Program Files\Mozilla XULRunner\1.8.0.4\xulrunner\xulrunner.exe" --install-app "C:\Documents and Settings\User\Desktop\myapplication.xpi"

The application will be installed to C:\Program Files\VendorName\ApplicationName

[edit] Mac OS X

Run the following command in a command prompt:

/Library/Frameworks/XUL.framework/xulrunner-bin --install-app ~/Desktop/myapplication.xpi

The application will be installed to /Applications/Vendor/ApplicationName

[edit] Linux

Run the following command in a command prompt:

/opt/xulrunner/1.8.0.4/xulrunner/xulrunner --install-app ~/Desktop/myapplication.xpi

The application will be installed to /usr/lib/vendor/applicationname

[edit] Known Issues

• Firewall software may identify all XUL applications as the same application.
• On Microsoft Windows XP, all XUL applications may wind up being grouped together in the taskbar.

[edit] Frequently Asked Questions

Why is installing XULRunner so painful? Why isn't there a nice installer?

Because nobody has written that code yet! This is a developer preview release: additional features for installing and deploying XULRunner and applications based on XULRunner will be available in future releases.

I'm writing a XUL application, how can I deploy that application to my users?

Right now Mozilla recommends that XULRunner should be deployed privately with each application. See Deploying XULRunner 1.8 for more information.

Where is the source code?

Here.

I think I've found a bug, how do I report it?

bugzilla.mozilla.org is used to track bugs in all Mozilla products. Please search to make sure that your bug has not already been reported.

How can I help?

If you want to help with XULRunner but don't know where to start, visit the XULRunner:Community page and ask questions on the newsgroups or the IRC channel.