James Boston is working on the [http://zenit.senecac.on.ca/wiki/index.php/Mozilla_Developer_Resource_Kit Mozilla Developer Resource Kit]a Computer Programmer.

ContactEmail: <br />Email james mozilla [at the domain that has my name or look for me on irc:] jamesboston [dot] ca<br />'''JamesB''' on irc://irc.mozilla.org/seneca

= Building Projects = === Fixing nsIProcess === Project page: [[User:Jamesboston/nsIProcess|Fixing nsIProcess]] The API in Firefox for managing external processes has never been fully implemented. This project aims to implement the existing API and extend the API to include inter-process communication. === The Canvas 3D JS Libary (C3DL) === Project page: [[Canvas3D_JS_Library | C3DL]] C3DL is a JavaScript library that will make it easier to write 3D applications using <del>canvas 3d</del> WebGL. (''Mozilla's Canvas 3D project has been superseded by the new WebGL standard that will also by used by WebKit.'') It will provide a set of math, scene, and 3d object classes to make the canvas more accessible for developers that want to develop 3D content in browser. === Mozilla Developer Resource Kit === Project page: [[Mozilla_Developer_Resource_Kit|Mozilla Developer Resource Kit]] Creating a package that contains everything a developer needs, including documentation, to get started with Firefox. The plan is to make it available as a live Fedora DVD for developers in countries where bandwidth is scarce. '''This project is of uncertain status. It's a multi-semester project that is worked on by a new student group each semester, but it doesn't appear to be under development at this time.''' === Portable DXR === Project page: [[Portable_DXR|Portable DXR]] This is closely related to the MDRK. The aim is to package the Mozilla developer documentation and the DXR source browsing tool in an extension that can be easily distributed/installed mostly likely as a XUL/Prism application. As an added bonus, this is a group project where the team members are experimenting with using traditional project planning tools and open source development methods. '''This project is defunct. It was a group project for school and some members have graduated. Plus, the nominal client in not interested in completion.''' = Software = === Process Manager Extension === A binary XPCOM extension that allows processes external to Firefox to be started and stopped. Currently only Win32 is supported. It is used in the SHTTPD extension. Further notes on usage: http://jamesboston.ca/cms/node/41 Download: http://jamesboston.ca/extensions/processmanager.xpi Source: http://jamesboston.ca/extensions/processmanager.zip === SHTTPD Extension === This is a proof of concept. Installing this extension will start a tiny webserver that runs locally. The purpose of this is to eventually provide a way to distribute web application as extensions so they can be run locally/offline. At present, when the browser starts the server also starts and installs an icon to the system tray. It only runs on Win32 machines. Download: http://jamesboston.ca/extensions/shttpd.xpi (The server is licensed as beerware and is available on its own at http://shttpd.sourceforge.net/).

== Building on Windows Vista = Open in Editor Extension ===

Install Visual Studio:(The express version This extension will work.) open source code files from http://msdn2mxr.mozilla.org in an editor on the users machine. Simply right click on the loaded page and select the Open in Editor option from the pop up context menu.microsoftThe user may choose any editor through preference settings.com/en-us/vstudio/aa700736If no preferences are selected the extension defaults to gedit on Linux, notepad on Windows, and (currently) nothing on OS X.aspx

Get Microsoft Windows Software Development Kit Update for Windows VistaDownload: http://wwwzenit.microsoftsenecac.comon.ca/wiki/downloadsimgs/detailsOpenineditor.aspx?FamilyID=4377f86d-c913-4b5c-b87e-ef72e5b4e065&DisplayLang=en xpi

Open a shell window by right clicking and using admin privileges[http:(The example here is for Visual Studio 2005//matrix. The name of the bat file you use should match the directory that Visual Studio is installed insenecac.) c:\mozilla-build\start-msvc8on.batca/~jwboston/ubiquity/ Subscribe to all my commands]

Add the following lines to .mozconfig== # My first mozilla config . $topsrcdir/browser/config/mozconfig mk_add_options MOZ_OBJDIRInstall prerequisites ==@TOPSRCDIR@/obj-@CONFIG_GUESS@ ac_add_options --disable-optimize ac_add_options --enable-debug ac_add_options --disable-static --enable-shared

Start the build (which will take AT LEAST one hour)Install Visual Studio: cd ~/mozilla make -f client.mk build

Once the build is finished you should set the following environment variable to turn-off assertion dialogs:''(The Visual C++ 2008 Express version will work.)'' export XPCOM_DEBUG_BREAK=warnhttp://www.microsoft.com/express/download/

When If you run Firefox paid for the first timeProfessional version of Visual Studio you can skip this step. But if you are using an express version, create and select a new profile called "development" you need to install the Windows Server 2003 Platform SDK in order to get some headers (or any name of your choiceatlbase.h to be specific) to avoid corrupting your current profile. You can do this while running your current included in the Professional version of Firefox using these command line options: ~http:/mozilla/obj*www.microsoft.com/distdownloads/bin/firefox details.aspx?FamilyId=0BAF2B35-C656-Profilemanager 4969-noACE8-remoteE4C0C0716ADB&displaylang=en

The finished build can be found in :''On the ~/mozilla/obj*/dist/bin directoryabove page, DO NOT click the web install link. Scroll further down the page to see a list of download options. You probably want PDSK-x86.exe for a 32-bit machine.'':[[Image:Windowsserversdkchoices.GIF]]

Run Install the file "mozilla" Microsoft Windows Software Development Kit Update for Windows 7 (even if you are using Vista or "firefox", not the binary "mozillaVisual Studio Professional): http://www.microsoft.com/downloads/details.aspx?familyid=C17BA869-9671-4330-bin" or "firefoxA63E-bin".1FD44E0E2505&displaylang=en

For more detailed info about If you had a previous version of the windows build requirements visit [httpSDK installed (such as the Vista SDK) open the CMD shell (Start-> All Programs-> Microsoft SDK v7.0-> CMD) and make sure the new version is set as default by entering://developer WindowsSdkVer.mozilla.org/en/docs/Windows_Build_Prerequisites#Microsoft_Visual_C.2B.2B_and_Windows_SDK Mozilla Developer Center]exe -version:v7.0

For more detailed information about Download and install Mozilla building visit [httpBuild, a package of software prerequisites://zenit.senecac.on.ca/wiki/index.php/Real_World_Mozilla_Build_Mozilla_Lab Real World Mozilla Build Lab].

For more info about Visual Studio 2008 problems ''(If you get a message saying this application did not install properly then you should see [a windows dialog giving you the option to re-install with the 'correct settings'. After that all should be well.)'' http://crashopensourceftp.blogspotmozilla.comorg/2008pub/05mozilla.org/vistamozilla/libraries/win32/MozillaBuildSetup-building-with-vc91.html Lukas Blakk's blog4.]exe

The instructions are the same as for Windows Vista. For Firefox 3If everything worked correctly, you should see a list of the Vista SDK is also required. However, try adding the following additional line to your .mozconfig file firstheaders: ac_add_options --disable-vista-sdk-requirements[[Image:Mozilla_sdk_shell_Capture.GIF]]

Another problem ''(The example above is that for Visual C++ 2008 Express. The name of the bat file you may not be able to use your home should match the directory because the path may have spaces. If that Visual Studio is the caseinstalled in. For instance, just put the mozilla directory in your root (ieVS2005 uses start-msvc8. C:\mozillabat) and put the .mozconfig file in that directory.''

=== Linux ======= Fedora ====Install build pre-requisites for Fedora users:

Additional Fedora 11 pre-requisites: su -c 'yum install libnotify-devel' Additional Fedora 10 pre-requisites: su -c 'yum install libXt-devel'  ==== Ubuntu ====Install Firefox 3 build pre-requisites for Ubuntu users8.10 and 9.04:

sudo apt-get build-dep mozillafirefox sudo apt-get install mercurial libasound2 libasound2-dev curl libcurl4-gnutls-firefoxdev libnotify-dev

Get the makefile instructions === OS X === You should have [http://developer.apple.com/TOOLS/Xcode/ Xcode] installed. You don't need to pull use Xcode for editing source files, but you will need the source tree and put developer SDK that comes with it in a directory . In order to build Firefox you will need something called mozilla in your home directoryMacPorts which can be downloaded from here: cdhttp://www.macports.org/install.php cvs After downloading and installing MacPorts you can then install the pre-d requisites:pserver sudo port sync sudo port install mercurial libidl autoconf213 === autoconf notes ===The build system should know to use autoconf 2.13 instead of later versions automatically, but on some *nix systems it may be necessary to specify it manually:anonymous@cvs-mirror.mozilla.org export AUTOCONF=autoconf213 Or on some systems you may need to set AUTOCONF this way instead:/cvsroot co mozilla/client export AUTOCONF=autoconf2.mk13 == Configuration ==

Checkout You need to create a hidden file for the source: cd ~/mozilla make -f clientbuild system that contains instructions on how you want your build completed.mk checkout MOZ_CO_PROJECT=browser

Create and open a hidden file called .mozconfig in your home directoryusing notepad or gedit or vim: gedit notepad.exe ~/.mozconfig

Start If you are using a multi-core computer for building, you can try adding a flag to speed up compile times. Use a value of ''((# of cores)*2)+1'' (ie. five for two cores): mk_add_options MOZ_MAKE_FLAGS=-j5 For OS X (Leopard) add: ac_add_options --with-macos-sdk=/Developer/SDKs/MacOSX10.5.sdk == Getting the source == If you are attempting to build Firefox 3.1 or greater you can checkout the source using mercurial as described below. When creating a working directory and checking out the source it doesn't really matter where you put it, but avoid paths that contain spaces. Spaces in the path name will cause the build to fail. For Windows XP users, your home directory path almost certainly has spaces. If that is the case, just put the mozilla directory in your root (which will take AT LEAST one hourie. C:\mozilla)and put the .mozconfig file in that directory. If your user name doesn't have space you can checkout the source to your home directory like this: cd mkdir mozilla cd mozilla hg clone http://hg.mozilla.org/mozilla-central/ src It is still possible to checkout older versions of Firefox using cvs: cd cvs -d :pserver:anonymous@cvs-mirror.mozilla.org:/cvsroot co mozilla/client.mk

make -f client.mk checkout MOZ_CO_PROJECT=browser == Starting the build== You need to change to the directory that contains the source code and then run the make command: cd ~/mozilla/src time make -f client.mk build === Special Fedora 11 note === You may need to patch the source before building because of a bug in Breakpad that shows up with the latest version of gcc (which F11 uses). Patch and details here:https://bugzilla.mozilla.org/show_bug.cgi?id=485019 == Running the build ==

When you run Firefox your build for the first time, create and select a new profile called "development" (or any name of your choice) to avoid corrupting your current profile. You can do this while running your current version of Firefox using these command line options: ~/mozilla/obj*/dist/bin/firefox -Profilemanager -no-remote

The finished build can be found in the Windows and Linux: ~/mozilla/src/obj*/dist/bin directory./firefox -profilemanager

Run the file "OS X: ~/mozilla" or "firefox", not the binary "mozilla-bin" or "/src/obj*/dist/MinefieldDebug.app/Contents/MacOS/firefox-bin".

== Building on OS X ==Build pre-requisites and instructions for OS X can be found at If you need to refresh the [httpsource code: cd ~//developer.mozilla.org/en/docs/Mac_OS_X_Build_Prerequisites#Firefox_Quick_Start Mozilla Developer Center.]src hg pull -u

Although the instructions are good, it may be necessary to take a few extra steps. For instance, the build may have trouble finding the glib dependency. If this happens, try adding this to your path: export PATH=$PATH:/sw/bin;/sw/sbin If you have built Firefox in your home directory and are trying to start it from = Rebuilding the command line try these steps: cd ~/mozilla/dist/Minefield.app/Contents/MacOS ./firefox -Profilemanager -no-remote browser = Software =

This is a proof of concept. Installing this extension will start a tiny webserver that runs locally. The purpose of this is For instance, to eventually provide rebuild after a way to distribute web application as extensions so they can be run locallychange in the xpcom module try: make -C ~/mozilla/src/obj*/offline. At present, when the browser starts the server also starts and installs an icon to the system tray. It only runs on Win32 machines.xpcom

DownloadOr as a more general form: http://jamesboston.ca/extensions/shttpd.xpi make -C [the object directory corresponding to the source directory that has changed]

(The server is licensed as beerware In most cases this will relink the changes and is available on its own at http://shttpdcreate a new browser binary.sourceforgeBut there's no hard and fast rule about when you can successfully do an incremental build. Sometimes you can burrow a few levels into the object tree and sometime you need to build from the very top.net/)It may take a bit of trial and error to discover what works.

== Open in Editor Extension =Tunneling a VNC session =

This extension will open source code files from http://mxr.mozilla.org in an editor on the users machine. Simply right click on the loaded [[Tunnel_VNC_through_SSH|Instruction page and select the Open in Editor option from the pop up context menu. The user may choose any editor through preference settings. If no preferences are selected the extension defaults to gedit on Linux, notepad on Windows, and (currently) nothing on OS X. ]]

Download: http://zenitSome of the Mac minis in the ORI area at Seneca are configured to accept VNC connections, but without an SSH tunnel are too slow to be useful.senecacThese instructions will help you get setup.on.ca/wiki/imgs/Openineditor.xpi