130
edits
Mobile/Build/Windows Mobile Build Instructions: Difference between revisions
Jump to navigation
Jump to search
Mobile/Build/Windows Mobile Build Instructions (view source)
Revision as of 17:47, 20 November 2008
, 20 November 2008→work in progress - things are changing as we speak, er.. as you read this
| Line 12: | Line 12: | ||
'''Did we mention that things are changing frequently?''' | '''Did we mention that things are changing frequently?''' | ||
==Setup== | ==Setup== | ||
| Line 30: | Line 31: | ||
You will also need to download and install the [http://www.microsoft.com/downloads/details.aspx?familyid=3D6F581E-C093-4B15-AB0C-A2CE5BFFDB47&displaylang=en Windows Mobile 6.1 Professional Localized Emulator Images]. | You will also need to download and install the [http://www.microsoft.com/downloads/details.aspx?familyid=3D6F581E-C093-4B15-AB0C-A2CE5BFFDB47&displaylang=en Windows Mobile 6.1 Professional Localized Emulator Images]. | ||
===IMPORTANT NOTE=== | ===IMPORTANT NOTE=== | ||
| Line 48: | Line 50: | ||
Bottom Line - you need to either test on-device, or use VS9 Pro (or better) | Bottom Line - you need to either test on-device, or use VS9 Pro (or better) | ||
==Downloading and Building== | ==Downloading and Building== | ||
| Line 143: | Line 146: | ||
''ac_add_options --with-wince-sdk="c:/program files/windows mobile 6 sdk/pocketpc/include/armv4i"'' | ''ac_add_options --with-wince-sdk="c:/program files/windows mobile 6 sdk/pocketpc/include/armv4i"'' | ||
===Building XULRunner and Mobile Fennec Code=== | ===Building XULRunner and Mobile Fennec Code=== | ||
| Line 151: | Line 155: | ||
$ '''make -f client.mk build''' | $ '''make -f client.mk build''' | ||
==Notes After Building== | ==Notes After Building== | ||
===Copy MOZCE_SHUNT.DLL=== | ===Copy MOZCE_SHUNT.DLL=== | ||
For Visual Studio 2005 (VS8), you can find the shunt DLL at: | |||
/c/hg/mozilla-central/build/wince/shunt/build/vs8/mozce_shunt.dll | |||
into | |||
For Visual Studio 2008 (VS9), you can find the shunt DLL at: | |||
/c/hg/mozilla-central/build/wince/shunt/build/vs9/mozce_shunt.dll | |||
To debug fennec using VS8/9, you will have to copy mozce_shunt.dll into: | |||
''$OBJDIR''\mobile\dist\bin\xulrunner | ''$OBJDIR''\mobile\dist\bin\xulrunner | ||
so that the .dll file is in the ''same directory'' as where xulrunner.exe is in. | so that the .dll file is in the ''same directory'' as where xulrunner.exe is in. | ||
| Line 162: | Line 172: | ||
Otherwise, you will receive a ''Could not find 'XULRunner' (or one of its components). Make sure that the path and filename are correct and that all the required libraries are available.'' error dialog if you try to run XULRunner.exe from a File Explorer. | Otherwise, you will receive a ''Could not find 'XULRunner' (or one of its components). Make sure that the path and filename are correct and that all the required libraries are available.'' error dialog if you try to run XULRunner.exe from a File Explorer. | ||
The VS8 IDE will say that it is ''Unable to start program '\Storage Card\bin\xulrunner.exe'. An error occurred that usually indicates a corrupt installation (code 0x8007007e). If the problem persists, repair your Visual Studio installation via 'Add or Remove Programs' in Control Panel.'' | |||
Both of these rather cryptic messages try to tell you that an executable file (EXE or DLL) depends upon a DLL, and that DLL could not be found. | Both of these rather cryptic messages try to tell you that an executable file (EXE or DLL) depends upon a DLL, and that DLL could not be found. | ||
===Debugging Fennec=== | ===Debugging Fennec=== | ||
| Line 177: | Line 188: | ||
(3) Change your Registry's OEM Search Path string to add your xulrunner's bin directory. Further information for this option is available | (3) Change your Registry's OEM Search Path string to add your xulrunner's bin directory. Further information for this option is available | ||
[[http://msdn.microsoft.com/en-us/library/bb202759.aspx via Microsoft DevNetwork]]. Note that you will have to reboot your WinMobile device for a changed OEM Search Path to take effect. | [[http://msdn.microsoft.com/en-us/library/bb202759.aspx via Microsoft DevNetwork]]. Note that you will have to reboot your WinMobile device for a changed OEM Search Path to take effect. | ||
===Visual Studio 2005 / Visual Studio 8=== | ===Visual Studio 2005 / Visual Studio 8=== | ||
| Line 188: | Line 200: | ||
* VS8 Emulator's shared-directory driver does not work properly. If you try to use the Emulator supplied with VS8, you will receive LOTS of random errors and faults. You might be able to eventually get a good run of the xulrunner application, but you will also get very frustrated at the same time. | * VS8 Emulator's shared-directory driver does not work properly. If you try to use the Emulator supplied with VS8, you will receive LOTS of random errors and faults. You might be able to eventually get a good run of the xulrunner application, but you will also get very frustrated at the same time. | ||
===Visual Studio 2008 / Visual Studio 9=== | ===Visual Studio 2008 / Visual Studio 9=== | ||
| Line 198: | Line 211: | ||
* To run / debug xulrunner and fennec, you will need to increase the amount of memory available to the WinMobile 6.1 Emulator Image in which you are running. | * To run / debug xulrunner and fennec, you will need to increase the amount of memory available to the WinMobile 6.1 Emulator Image in which you are running. | ||
* To increase the amount of memory available to your Emulator Image, do the following within VS9: | * To increase the amount of memory available to your Windows Mobile 6.1 Localized Emulator Image, do the following within VS9: | ||
** Pull down the Tools menu | ** Pull down the Tools menu | ||
** Select the Options... menu item | ** Select the Options... menu item | ||
| Line 217: | Line 230: | ||
* The main people working on WinMobile also use VS9 to run / debug on-device. | * The main people working on WinMobile also use VS9 to run / debug on-device. | ||
==Setting Up MyBrowser== | ==Setting Up MyBrowser== | ||
| Line 239: | Line 253: | ||
'''copy -r mybrowser c:\mozilla\unicode\objdir-wm6-debug\dist\bin''' | '''copy -r mybrowser c:\mozilla\unicode\objdir-wm6-debug\dist\bin''' | ||
==Setting Up For Debugging MyBrowser== | ==Setting Up For Debugging MyBrowser== | ||
| Line 267: | Line 282: | ||
12. Close the Project Properties dialog box | 12. Close the Project Properties dialog box | ||
==Debugging MyBrowser== | ==Debugging MyBrowser== | ||
| Line 287: | Line 303: | ||
You should now see the Visual Studio begin a debugging session of XULRunner loading the MyBrowser XULApp. | You should now see the Visual Studio begin a debugging session of XULRunner loading the MyBrowser XULApp. | ||
==Other Tips== | ==Other Tips== | ||