View source for Firefox/Tegra/Build Notes

This is a work in progress; pieces of the [[Mobile/Build/Windows_Mobile_Build_Instructions|Windows Mobile Build Instructions]] might also be relevant and/or informative.  However, they are targeted towards building Fennec/XULRunner for Windows Mobile.

= Initial Setup =

* Follow the instructions in [https://developer.mozilla.org/en/Windows_Build_Prerequisites Windows Build Prerequisites], installing at a minimum:
** the mozilla-build environment
** Visual Studio 2008 (2005 ought to work, but this guide has been written with 2008 in mind), with Smart Device support

* Install the [http://www.microsoft.com/DownLoads/details.aspx?familyid=FA1A3D66-3F61-4DDC-9510-AE450E2318C3&displaylang=en Windows CE 5.00 Standard SDK].  If you have a SDK provided by a Windows CE 6 device manufacturer, it ought to work as well; this has only been tested with the CE 5.00 SDK.

* To take advantage of the DirectDraw backend for Windows CE, you'll need to replace ddraw.h and ddraw.lib in the CE5 SDK with those from the Windows Mobile 6 SDK.  This will require installing the WM6 SDK, and then, assuming the SDKs are installed in the default locations, copying:
** '''/c/Program Files/Windows Mobile 6 SDK/PocketPC/Include/Armv4i/ddraw.h''' to '''/c/Program Files/Windows CE Tools/wce500/STANDARDSDK_500/Include/Armv4i'''
** '''/c/Program Files/Windows Mobile 6 SDK/PocketPC/Lib/Armv4i/ddraw.lib''' to '''/c/Program Files/Windows CE Tools/wce500/STANDARDSDK_500/Lib/Armv4i'''

= Downloading the Source =

The process for creating a source tree and  build is basically the same as for building Firefox for Windows XP/Vista. See [https://developer.mozilla.org/En/Simple_build this simplified guide] for the general process.

In 'C:\mozilla-build', there will be a few batch files -- fire up '''start-msvc9.bat''' to obtain a console window with paths set up for building.  All commands are assumed to be executed within such a window:

# '''mkdir /c/proj''' (or any path without spaces!)
# '''cd /c/proj'''
# '''<nowiki>hg clone http://hg.mozilla.org/mozilla-central</nowiki>'''

Mozilla uses the Mercurial version control system. The "hg clone" command will create a mozilla-central directory in /c/proj containing the Mozilla source.   For more detailed information, see [https://developer.mozilla.org/en/Mercurial this page].  For creating your own patches and/or maintaining local changes, I'd suggest using the [https://developer.mozilla.org/en/Mercurial_Queues Mercurial Queues] extension.

'''NOTE''': the MSYS environment that drives the build uses Unix-style forward slashes for path separators.  Drive letters are also treated as directories, so "C:\proj" becomes "/c/proj".  Note that MSYS will automatically translate "/c/proj" into "C:\proj" from the command line; this sometimes causes problems when trying ot pass arguments that start with "/" to programs.  To get around this, use "//" -- for example, "dumpbin //exports".  Or, use the - form of arguments if supported.

= Set up a mozconfig =

The mozilla build system uses a "mozconfig" file to store various build-time options. Here's a sample mozconfig for Windows CE builds. Copy & paste the below into a file named "mozconfig" inside your mozilla-central directory.

 mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/obj-ff
 mk_add_options MOZ_MAKE_FLAGS="-s"
 ac_add_options --enable-application=browser
 
 # Either --enable-debug or --enable-optimize should be specified;
 # --enable-debugger-info-mobules ensures that debugging symbols are available
 # even with an optimized build.
 
 #ac_add_options --enable-debug
 ac_add_options --enable-optimize
 ac_add_options --enable-debugger-info-modules
 
 # Have to do libxul builds, or else the linker complains (it's buggy?)
 ac_add_options --enable-libxul
 
 ac_add_options --enable-jemalloc
 ac_add_options --enable-splashscreen
 ac_add_options --enable-faststripe
 
 # buggy for ARM at the moment
 ac_add_options --disable-ogg
 
 # for ActiveX shim
 export MOZ_FLASH_ACTIVEX_PATCH=1
 ac_add_options --enable-activex
 ac_add_options --enable-activex-scripting
 ac_add_options --enable-xpconnect-idispatch

 ac_add_options --disable-windows-mobile-components
 
 # Note that you need to give both CFLAGS and CXXFLAGS
 export CFLAGS="-QRarch6 -QRfpe-"
 export CXXFLAGS="-QRarch6 -QRfpe-"
 
 # No need to build the tests for now
 ac_add_options --disable-tests
 
 # Disable some things that aren't necessary right now;
 # these might or might not actually work should they be needed.
 ac_add_options --disable-javaxpcom
 ac_add_options --disable-accessibility
 ac_add_options --disable-printing
 ac_add_options --disable-oji
 ac_add_options --disable-vista-sdk-requirements
 ac_add_options --disable-updater
 ac_add_options --disable-installer
 ac_add_options --disable-dbm
  
 CROSS_COMPILE=1
 MIDL=/c/Program\ Files/Microsoft\ Visual\ Studio\ 9/VC/ce/bin/x86_arm/midl.exe
 
 ac_add_options --target=arm-wince
 ac_add_options --enable-win32-target=WINCE
 
 ac_add_options --with-wince-sdk="c:/program files/windows ce tools/wce500/standardsdk_500"

= Start a Build =

In the location where you cloned mozilla-central, just run "make -f client.mk build". If all goes well, you should have a complete build/install dir in "dist/bin" inside your obj-ff dir.

= Running the Build =

Copy the entire bin directory to the device, and run firefox.exe.