<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<body link="#355491" alink="#4262a1" vlink="#355491" style="background: #e2e2e2; margin: 0; padding: 20px;">
<div>
<table cellpadding="0" bgcolor="#FFFFFF" border="0" cellspacing="0" style="border: 1px solid #dadada; margin-bottom: 30px; width: 100%; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tbody>
<tr>
<td>
<table border="0" cellpadding="0" cellspacing="0" bgcolor="#FFFFFF" style="border: solid 2px #ccc; background: #dadada; width: 100%; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tbody>
<tr>
<td bgcolor="#000000" valign="middle" height="58px" style="border-bottom: 1px solid #ccc; padding: 20px; -moz-border-radius-topleft: 3px; -moz-border-radius-topright: 3px; -webkit-border-top-right-radius: 5px; -webkit-border-top-left-radius: 5px;">
<h1 style="color: #333333; font: bold 22px Arial, Helvetica, sans-serif; margin: 0; display: block !important;">
<!-- To have a header image/logo replace the name below with your img tag -->
<!-- Email clients will render the images when the message is read so any image -->
<!-- must be made available on a public server, so that all recipients can load the image. -->
<a href="https://community.jboss.org/index.jspa" style="text-decoration: none; color: #E1E1E1">JBoss Community</a></h1>
</td>
</tr>
<tr>
<td bgcolor="#FFFFFF" style="font: normal 12px Arial, Helvetica, sans-serif; color:#333333; padding: 20px; -moz-border-radius-bottomleft: 4px; -moz-border-radius-bottomright: 4px; -webkit-border-bottom-right-radius: 5px; -webkit-border-bottom-left-radius: 5px;"><h3 style="margin: 10px 0 5px; font-size: 17px; font-weight: normal;">
BrowserSim FAQ
</h3>
<span style="margin-bottom: 10px;">
modified by <a href="https://community.jboss.org/people/yradtsevich">Yahor Radtsevich</a> in <i>JBoss Tools</i> - <a href="https://community.jboss.org/docs/DOC-18100">View the full document</a>
</span>
<hr style="margin: 20px 0; border: none; background-color: #dadada; height: 1px;">
<div class="jive-rendered-content"><p><strong>Q: What is BrowserSim ?</strong></p><p><strong>A: </strong>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.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>Q: How does BrowserSim works ?</strong></p><p><strong>A: </strong>It wraps a webkit browser and makes it respond and send work like a mobile browser by spoofing content and media request headers.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong><br/>Q: What do I need to run BrowserSim?</strong></p><p><strong>A:</strong> The requirements for different platforms are as listed below:</p><ul><li>Windows:<ul><li>Only 32-bit Eclipse/JBDS is supported;</li><li>Apple <a class="jive-link-external-small" href="http://www.apple.com/quicktime/download/">QuickTime</a> or <a class="jive-link-external-small" href="http://www.apple.com/itunes/download/">iTunes</a> must be installed (they contain Apple Application Support which provides WebKit engine for BrowserSim).</li></ul></li><li>Linux:<ul><li>WebKitGTK 1.2.0 or newer must be installed and available in the library load path.</li><li>This should be available on RHEL and Ubuntu by default, if not use your package manager to install libwebkitgtk</li></ul></li><li>Mac OS X<ul><li>It just works.</li></ul></li></ul><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>Q: How to add BrowserSim to the toolbar?</strong></p><p><strong>A:</strong> Go to Window → Customize Perspective and select "BrowserSim" under "Command Groups Availability". Then it becomes available in the global toolbar via the "phone" icon:</p><p><a href="https://community.jboss.org/servlet/JiveServlet/showImage/102-18100-10-18715/browsersim-enabled.png"><span> https://community.jboss.org/servlet/JiveServlet/downloadImage/102-18100-10-18715/113-38/browsersim-enabled.png </span></a></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>Q: Can I use the browser as a replacement for testing on a real phone or emulator?</strong></p><p><strong>A:</strong> 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. </p><p>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. </p><p>For full verfication/testing you should test on a real phone.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>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).</strong></p><p><strong>A:</strong> There is an incompatibility between some versions of JRE 7 and BrowserSim on Windows. To workaround this, please do the following:</p><ol><li>Install JRE/JDK 6 or JDK 7 (but not JRE 7).</li><li>Add the next lines at the beginning of your eclipse.ini or jbdevstudio.ini:</li></ol><p style="padding-left: 60px;"><span style="font-family: 'Courier New', Courier, monospace;">-vm</span></p><p style="padding-left: 60px;"><span style="font-family: 'Courier New', Courier, monospace;">PATH_TO_JAVA_INSTALLATION_DIRECTORY\bin\javaw.exe</span></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong>Q: BrowserSim shows the <strong>"No more handles [Failed to load the swt-webkit library]"</strong> error message and does not run (with JBoss Tools 3.3.0.GA and below).</strong></p><p><strong>A:</strong> There is an incompatibility between some versions of JRE/JDK 7 and BrowserSim on Windows. To workaround this, please do the following: </p><ol><li>Install JRE/JDK 6 (but not JRE/JDK 7).</li><li>Add the next lines at the beginning of your eclipse.ini or jbdevstudio.ini:</li></ol><p style="padding-left: 60px;"><span style="font-family: 'Courier New', Courier, monospace;">-vm</span></p><p style="padding-left: 60px;"><span style="font-family: 'Courier New', Courier, monospace;">PATH_TO_JAVA_INSTALLATION_DIRECTORY\bin\javaw.exe</span></p></div>
<div style="background-color: #f4f4f4; padding: 10px; margin-top: 20px;">
<p style="margin: 0;">Comment by <a href="https://community.jboss.org/docs/DOC-18100">going to Community</a></p>
<p style="margin: 0;">Create a new document in JBoss Tools at <a href="https://community.jboss.org/choose-container!input.jspa?contentType=102&containerType=14&container=2128">Community</a></p>
</div></td>
</tr>
</tbody>
</table>
</td>
</tr>
</tbody>
</table>
</div>
</body>
</html>