Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "EDT:SettingUpForMobile"

Line 1: Line 1:
The set-up instructions differ by development platform:
+
The set-up instructions differ by development platform:  
  
 
*[[#Windows_platforms|Windows platforms]]  
 
*[[#Windows_platforms|Windows platforms]]  
Line 22: Line 22:
 
::You cannot use the general EGL Dojo widgets, which are in the dojo.widgets package.
 
::You cannot use the general EGL Dojo widgets, which are in the dojo.widgets package.
  
     
+
== &nbsp;&nbsp;&nbsp; How to resolve the problem "Internal Error. No more handlers" - Safari must be installed to use a SWT.WEBKIT -style Browser<br> ==
 +
 
 +
You might encounter the problem described in bug https://bugs.eclipse.org/bugs/show_bug.cgi?id=396721 after setting up EDT mobile development environment. The problem is caused by Oracle JRE dll file conflicts with WebKit since Oracle JRE 7u6. Below is several workarounds that you could try (please make sure you installed '''32bit Eclipse and 32bit JVM'''),<br>
 +
 
 +
#Use Oracle JDK instead of JRE. Oracle JRE provided libxml2.dll since JRE 7u6, which has conflict with WebKit dll. However, the JDK does not ship with libxml2.dll, it will not have problem. ''You can refer to&nbsp;http://wiki.eclipse.org/Eclipse.ini for how to set up specific JVM with Eclipse. ''<br>
 +
#Use IBM JRE or JDK 6.x or 7.x. Since libxml2.dll is not shipped with IBM JVMs, it has no such problem in our testing.<br>
 +
#If you do want to use Oracle JRE, you could delete the libxml2.dll under %JRE_DIR%\bin. It probably has some side effects we don't know, so it's not recommended to use this approach.<br>
 +
 
 +
Finally, you'd better try previous approaches with a new empty workspace, and start Eclipse with "-clean" option. If you still have the problem after using one workaround, you could try to reboot the machine and restart the EDT.<br>
  
 
= Linux platforms<br>  =
 
= Linux platforms<br>  =

Revision as of 04:19, 28 December 2012

The set-up instructions differ by development platform:

For additional information on supported browsers, see EDT Supported Platforms.


Windows platforms

To develop a mobile application with EGL on a Windows platform, do as follows:

  1. Ensure that you are using a 32-bit version of Eclipse, even if you are working on Windows 7.  You can fulfill this requirement by downloading an all-in-one EDT build from the following page: http://www.eclipse.org/edt/#download.

    Before accessing a nightly EDT build, download Eclipse 3.7.2 from here. For details on accessing the EDT nightly build, see the EDT download page just mentioned.

  2. Download Apple Safari, which includes a version of the WebKit layout engine:  http://www.apple.com/safari/download.

  3. Configure your PATH variable to include the Apple Application Support directory.  For example, on Windows 7, the directory might be as follows: 

             C:\Program Files (x86)\Safari\Apple Application Support

  4. When you have configured a 32-bit version of Eclipse to include EDT, set the following defaults:

    a.  Set the preference for EGL Rich UI render engine. Specifically, click Window > Preferences, then expand EGL and Rich UI and, at the bottom of the Appearance page tab that is labeled General, click WebKit.

    b. Set the preference for browser size. For example, at the Appearance page tab that is labeled Browser size, you might set the vertical size to 800 and the horizontal size to 400.

  5. Note that you can use widgets only of the following kinds:
    • EGL Dojo mobile widgets, which are in the dojo.mobile.widgets package.
    • EGL widgets that in the org.eclipse.edt.rui.widgets package.
You cannot use the general EGL Dojo widgets, which are in the dojo.widgets package.

    How to resolve the problem "Internal Error. No more handlers" - Safari must be installed to use a SWT.WEBKIT -style Browser

You might encounter the problem described in bug https://bugs.eclipse.org/bugs/show_bug.cgi?id=396721 after setting up EDT mobile development environment. The problem is caused by Oracle JRE dll file conflicts with WebKit since Oracle JRE 7u6. Below is several workarounds that you could try (please make sure you installed 32bit Eclipse and 32bit JVM),

  1. Use Oracle JDK instead of JRE. Oracle JRE provided libxml2.dll since JRE 7u6, which has conflict with WebKit dll. However, the JDK does not ship with libxml2.dll, it will not have problem. You can refer to http://wiki.eclipse.org/Eclipse.ini for how to set up specific JVM with Eclipse.
  2. Use IBM JRE or JDK 6.x or 7.x. Since libxml2.dll is not shipped with IBM JVMs, it has no such problem in our testing.
  3. If you do want to use Oracle JRE, you could delete the libxml2.dll under %JRE_DIR%\bin. It probably has some side effects we don't know, so it's not recommended to use this approach.

Finally, you'd better try previous approaches with a new empty workspace, and start Eclipse with "-clean" option. If you still have the problem after using one workaround, you could try to reboot the machine and restart the EDT.

Linux platforms

For Linux, the details vary by Eclipse version: 

  • If you're using Eclipse 3.6, ensure that webkit-gtk 1.2.x installed and then do as follows:

    a.  Access your Eclipse installation directory and add the following line to eclipse.ini:

    -Dorg.eclipse.swt.browser.UseWebKitGTK=true

    b.  After opening Eclipse, click Window > Preferences, expand EGL and Rich UI and, at the bottom of the Appearance page tab that is labeled General, click User configured.

  • If you're using Eclipse 3.7, ensure that either webkit-gtk 1.2.x or 1.4.x is installed and then do as follows:  click Window > Preferences, expand EGL and Rich UI and, at the bottom of the Appearance page tab that is labeled General, click Webkit

  • The EDT team has not tested more recent versions of Eclipse, which might support newer versions of webkit-gtk.

As is true on Windows platforms, you can use widgets only of the following kinds:

  • EGL Dojo mobile widgets, which are in the dojo.mobile.widgets package.
  • EGL widgets that in the org.eclipse.edt.rui.widgets package.

You cannot use the general EGL Dojo widgets, which are in the dojo.widgets package.   

Back to the top