Current XULRunner is a stable developer preview release. This means that while the release is immature in some areas such as embedding, application deployment, and OS integration, it can be used by developers that are releasing standalone XUL applications. This document explains how deployment should be managed for self contained portable applications built on XULRunner.
Note: To actually install a XULRunner application, a compatible version of XULRunner must be registered on the system and the app must be deployed per the instructions at XUL Application Packaging. If your installer is capable of determining whether or not XULRunner has been registered on the system you could perform the check and register the appropriate version if necessary. After that, the app could be installed to the registered XULRunner and appear in start menus, lists of installed programs, etc. (Bonus points for checking the operating system and downloading the right XULRunner on the fly, or bundling them into your installer). Registration and app installation are performed with command line switches as outlined in the XULRunner section of article Command Line Options.
It may turn out to be easier to create a self contained portable application, as described here, and deploy it with a generic installer that would create shortcuts to scripts that launch your application in the unregistered bundled XULRunner. The responsibility still lies with the developer to provide the correct version of XULRunner per platform. In the end, most users are afraid of links that don't have a pretty icon so you may want to have a look at the Branding section of XULRunner tips.
Windows
On Windows, XULRunner does not yet have a complete built-in installation solution; app developers should use pre-existing solutions for a native Windows installer. An example of one such solution may be found in the article: Creating a Windows Inno Setup installer for XULRunner applications. The installed files should be arranged in the following directory structure:
installdir/application.inicomponents/- ... components which are part of the application
chrome/- ... chrome which is part of the application
- ... additional application files such as icons, etc
myapplicationname.exe(This is the "stub executable"... you should copy and rename this file fromxulrunner-stub.exein your XULRunner installation.)xulrunner/- ... copy xulrunner/ to this directory
When deploying with XULRunner 2.0 and above do the following:
Move chrome.manifest to the root directory, and adjust resource paths inside chrome.manifest accordingly
With XULRunner 9.0 or 10.0 you may need to copy "mozutils.dll" and/or "mozcrt19.dll" from the xulrunner directory to the root directory. This should be fixed with XULRunner 11.0
With XULRunner 11.0 you may need to copy "gkmedias.dll" from the xulrunner directory to the root directory
Mac OS X
On Mac OS X, the XULRunner framework bundle is placed in your application bundle:
MyApp.app/Contents/Info.plistPkgInfoFrameworks/XUL.framework/- files copied from
/Library/Frameworks/XUL.framework/Versions/1.8/... make sure you copy all symlinks correctly (usersync -rl /Library/Frameworks/XUL.framework ...).
- files copied from
Resources/application.iniapp_icon.icnscomponents/- ... components which are part of the application
chrome/- ... chrome which is part of the application
- ... additional application files such as icons, etc
MacOS/xulrunner(This is the "stub executable"... you should copy this file from/Library/Frameworks/XUL.framework/Versions/1.8/xulrunner.)
NOTE: When deploying with XULRunner 2.0 do the following:
- Move chrome.manifest to the root directory, and adjust resource paths inside chrome.manifest accordingly
Additionally, your Mac app WILL NOT RUN without a valid Info.plist file. Here's a sample one:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>CFBundleDevelopmentRegion</key>
<string>English</string>
<key>CFBundleExecutable</key>
<string>xulrunner</string>
<key>CFBundleGetInfoString</key>
<string>1.0</string>
<key>CFBundleIconFile</key>
<string>app_icon.icns</string>
<key>CFBundleIdentifier</key>
<string>net.yourcompany.yourapplication</string>
<key>CFBundleInfoDictionaryVersion</key>
<string>6.0</string>
<key>CFBundleName</key>
<string>applicationName</string>
<key>CFBundlePackageType</key>
<string>APPL</string>
<key>CFBundleShortVersionString</key>
<string>1.0</string>
<key>CFBundleSignature</key>
<string>????</string>
<!--only useful if your app handle urls-->
<key>CFBundleURLTypes</key>
<array>
<dict>
<key>CFBundleURLIconFile</key>
<string>app_icon.icns</string>
<key>CFBundleURLName</key>
<string>YOURAPP Entity</string>
<key>CFBundleURLSchemes</key>
<array>
<string>chrome</string>
</array>
</dict>
</array>
<key>CFBundleVersion</key>
<string>1.0</string>
</dict>
</plist>
Here's a sample of the PkgInfo file
AAPL????Edit this as you need to, but CFBundleExecutable MUST be xulrunner, and CFBundleIconFile and CFBundleURLIconFile should be set to the filename of your application icon (app_icon.icns).
Finally :
- Your icon can be created with Icon Composer which can be found in /Developer/Application/Utilities/Icon Composer (if you installed the XCode developer tools). You should use an original image in png format.
- To make it all work, change the permissions of you bundle by running:
chmod -R 755 YourApp.app.
Linux
Most Linux applications are distributed as simple .tar.bz2 archives which can be unpacked by the user wherever they wish. The archive should be structured as follows:
appname/application.inicomponents/- ... components which are part of the application
chrome/- ... chrome which is part of the application
- ... additional application files such as icons, etc
myapplicationname(This is the "stub executable"... you should copy and rename this file fromxulrunner-stubin your XULRunner installation.)xulrunner/- ... copy
xulrunner/to this directory
- ... copy