Q: What is BrowserSim ?
A: BrowserSim is a Browser Simulator which primarily is intended for having a quick, easy and multi-platform way of testing if your webapp will render and behave correctly on a mobile device.
Q: How does BrowserSim works ?
A: It wraps a webkit browser and makes it respond and send work like a mobile browser by spoofing content and media request headers.
Q: What do I need to run BrowserSim?
A: The requirements for different platforms are as listed below:
- Windows:
- Only 32-bit Eclipse/JBDS is supported;
- Apple QuickTime or iTunes must be installed (they contain Apple Application Support which provides WebKit engine for BrowserSim).
- Linux:
- WebKitGTK 1.2.0 or newer must be installed and available in the library load path.
- This should be available on RHEL and Ubuntu by default, if not use your package manager to install libwebkitgtk
- Mac OS X
Q: How to add BrowserSim to the toolbar?
A: Go to Window → Customize Perspective and select "BrowserSim" under "Command Groups Availability". Then it becomes available in the global toolbar via the "phone" icon:
https://community.jboss.org/servlet/JiveServlet/downloadImage/102-18100-10-18715/113-38/browsersim-enabled.png
Q: Can I use the browser as a replacement for testing on a real phone or emulator?
A: Browsersim make it easy to test basic layout questions/issues on any platform without having to install a platform specifc emulator or manually try use a phone.
That said it is not 100% reliable since there are so many different brands/versions of phones there will be differences in behavior, thus no, BrowserSim does not replace real or emulated phone testing.
For full verfication/testing you should test on a real phone.
Q: BrowserSim shows an error message saying that JRE 7 is not supported on Windows and does not run (with JBoss Tools 3.4.0.Alpha1 and above).
A: There is an incompatibility between some versions of JRE 7 and BrowserSim on Windows. To workaround this, please do the following:
- Install JRE/JDK 6 or JDK 7 (but not JRE 7).
- Add the next lines at the beginning of your eclipse.ini or jbdevstudio.ini:
-vm
PATH_TO_JAVA_INSTALLATION_DIRECTORY\bin\javaw.exe
Q: BrowserSim shows the "No more handles [Failed to load the swt-webkit library]" error message and does not run (with JBoss Tools 3.3.0.GA and below).
A: There is an incompatibility between some versions of JRE/JDK 7 and BrowserSim on Windows. To workaround this, please do the following:
- Install JRE/JDK 6 (but not JRE/JDK 7).
- Add the next lines at the beginning of your eclipse.ini or jbdevstudio.ini:
-vm
PATH_TO_JAVA_INSTALLATION_DIRECTORY\bin\javaw.exe
