OSX WebKit Installation for Mac OSX 10.4

This article is not applicable to users of OSX 10.5 (Leopard) or OSX 10.4.11 (and later).

To display truly native looking forms, GWT Designer for MacOSX uses the Safari browser whose core is a WebKit framework installed in the OS. This WebKit framework is more than 2.5 years old and contains many bugs which may limit the functionality of GWT Designer. In order for GWT Designer to work properly, you need to install the Safari 3 browser (recommended) or the latest WebKit (you do not need to install both).

The known issues with the older WebKit are:

  1. Button elements (except <input> with submit type) rendered without "Aqua" style.
  2. Menu visual editing not working.
  3. Table-based panels editing shows wrong cells bounds.

For complete list of bugs fixed see:
http://bugs.webkit.org/buglist.cgi?query_format=advanced&product=WebKit&version=420+&bug_status=CLOSED

To install the Safari 3 browser (recommended):

  1. Download the browser from http://www.apple.com/safari/download/
  2. Mount the downloaded image.
  3. Double-click on Safari 3 installation icon.
  4. Follow the installation wizard instructions.

To install the latest WebKit:

  1. Download the latest WebKit from http://nightly.webkit.org/builds/Latest-WebKit-SVN.dmg
  1. Mount downloaded disk image.
  1. Choose mounted volume, drag and drop "WebKit" into Applications folder.
  1. Close Eclipse if it is open.
  1. Open "Finder" and find your Eclipse app.
  1. Right-click on Eclipse and choose "Show package contents"
  1. Go to Contents folder and open Info.plist with Property List Editor (simply double clicking on Info.plist file opens it in Property List Editor). In addition to Apple's editor, you can use the commercial PlistEdit Pro product to edit the file (free trial available) or use the Text Editor.
  1. Add "LSEnvironment" key and set it type as "Dictionary"
  1. Add two subkeys of string type under "LSEnvironment" key:

    "DYLD_FRAMEWORK_PATH"

    and set its value to

    "/Applications/WebKit.app/Contents/Resources"

    "WEBKIT_UNSET_DYLD_FRAMEWORK_PATH"
    and set its value to "YES"

If you don't have the Property List Editor, you can use the Text Editor:

  • Open Info.plist with Text Editor.
  • Go to the end of file and put a cursor just before the last

            "</dict>" xml closing tag.

  • Add the following:
<key>LSEnvironment</key>
<dict>
<key>DYLD_FRAMEWORK_PATH</key>
<string>/Applications/WebKit.app/Contents/Resources</string>
<key>WEBKIT_UNSET_DYLD_FRAMEWORK_PATH</key> <string>YES</string>
</dict>

  1. Save Info.plist and close the editor.
  1. If GWT Designer fails to work properly (for example, you see an Unknown Window Type error), shut down Eclipse and delete everything in the "configuration" directory except the config.ini file and the org.eclipse.update/platform.xml file. You should also keep your org.eclipse.update/bookmarks.xml file in order to preserve your update site bookmarks. If that does not help, review all of the suggestions in this FAQ entry.