Building XULRunner | MDN
Description: XULRunner is built using basically the same process as Firefox or other applications. Please read and follow the general Build Documentation for instructions on how to get sources and set up build prerequisites.

# Building XULRunner

- History
- Edit

- Tags
- Files

XULRunner is built using basically the same process as Firefox or other applications. Please read and follow the general Build Documentation for instructions on how to get sources and set up build prerequisites.

By default, XULRunner is built with JavaXPCOM support; the build system must be able to find an appropriate JDK on the system; see the instructions on Building JavaXPCOM for more details. If you do not want to build JavaXPCOM support, specify `--disable-javaxpcom` in your configuration.

On Mac, XULRunner requires Mac OS X 10.3 or higher and XCode 1.5 or higher to build properly. The runtime requirement is Mac OS X 10.2.

A basic minimal mozconfig which will build a release configuration of XULRunner is:

    mk_add_options MOZ_CO_PROJECT=xulrunner
    mk_add_options MOZ_OBJDIR=@topsrcdir@/obj-xulrunner

    ac_add_options --enable-application=xulrunner
    #Uncomment the following line if you don't want to build JavaXPCOM:
    #ac_add_options --disable-javaxpcom

### CVS tags and XULRunner versions

Older XULRunner releases where tagged in CVS with (for instance XULRUNNER_1_8_0_5_RELEASE ) up to version 1.8.0.5

The CVS repository does not have specific tags for XULRunner anymore. Instead a XULRunner build is a just special build made from the Firefox/Mozilla tree, using the same tag as a Firefox build. There is a convention where a certain XULRunner version maps to a certain tag in the CVS.

For instance XULRunner 1.8.1.3, the corresponding tag is CVS is : FIREFOX_2_0_0_3_RELEASE

To find out how those Firefox tags and XULRunner version maps, check out the file mozilla/config/milestone.txt .

You can also check the User Agent string in Firefox Help/About menu to get the mapping from a certain binary Firefox version to the corresponding XULRunner version. For instance, in Firefox 2.0.0.9 you will get :

    Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.9) Gecko/20071025 Firefox/2.0.0.9

Therefore the XULRunner version for this Firefox version is : 1.8.1.9

### Fetching Sources from Mercurial

As with all other Mozilla products, one would fetch recent sources from Mercurial. For example, to build XULRunner with the top of the tree:

    hg clone http://hg.mozilla.org/mozilla-central/ src
    cd src
    echo ". \$topsrcdir/xulrunner/config/mozconfig" > .mozconfig
    make -f client.mk build

Interwiki Language Links

## Tags (4)

- Developing Mozilla
- XUL
- XULRunner
- Build documentation

Contributors to this page: Kray2, Taken, Kozawa, Benjamin Smedberg, Nickolay, NickolayBot, Pombredanne
Last updated by: Taken, Oct 8, 2009 3:16:43 PM

What do you think of the new MDN? Please share your feedback with us. Join our mailing list to discuss ways to help create great documentation.