Changes between Version 2 and Version 3 of Drosera


Ignore:
Timestamp:
Jun 19, 2007 10:41:53 AM (17 years ago)
Author:
pewtermoose@gmail.com
Comment:

Tweak the instructions for enabling Drosera; remove the Windows info as Drosera does not run on Windows

Legend:

Unmodified
Added
Removed
Modified
  • Drosera

    v2 v3  
    77
    88= Enabling Drosera =
    9  * On the Mac, if you use a locally built version of WebKit, you'll need to run the following command in Terminal and restart Safari to enable Drosera debugging:
     9Drosera requires the Safari 3 Beta or one of the [wiki:"Nightly Builds" nightly builds].  It cannot be used with Safari 2.
     10
     11If you are using a nightly build of WebKit, Drosera is already enabled for you.
     12
     13To allow Drosera to attach to Safari 3, enter the following command in Terminal:
    1014{{{
    1115defaults write com.apple.Safari WebKitScriptDebuggerEnabled -bool true
    1216}}}
    13  * On Windows, you'll have make sure that the following lines are in your preferences file at the location
    14 {{{
    15 C:\Documents and Settings\<USERNAME>\Application Data\Apple Computer\Safari\Preferences.plist
    16 }}}
    17 (where <USERNAME> should be your windows user name):
    18 {{{
    19     <key>WebKitScriptDebuggerEnabled</key>
    20     <true/>
    21 }}}
    2217
     18If you would like to debug your own WebKit-based application using Drosera, simply replace {{{com.apple.Safari}}} in the above command with your own application's bundle identifier or add the {{{WebKitScriptDebuggerEnabled}}} with a value of {{{true}}} to your Info.plist.
    2319
    2420= Using Drosera =
    25 Now that you have Drosera, you'll need something to debug.  Although Drosera can be used with any application that links against WebKit, it needs to be launched with the current development frameworks.  If you're debugging a website in Safari, you do not need to worry about this as long as you're using one of the [wiki:"Nightly Builds" nightly builds].  If you're debugging your own application however, you'll need to make sure the {{{WebKitScriptDebuggerEnabled}}} key is in your bundle identifier and then use the {{{run-webkit-app}}} script located in {{{WebKitTools/Scripts}}} to start your application.
    26 
    2721Once Drosera is launched, you're presented with the Attach window, showing all running applications capable of being debugged with Drosera.  Select the application you want to debug to load the debugging window.
    2822
     
    3731== Function and Variable Stacks ==
    3832While a script is paused, you can examine the contents of the variables within various scopes of the code.
     33
     34= Drosera on Windows =
     35Drosera is currently not available on Windows.  Much of Drosera is written in JavaScript and should require very little modifications to run on Windows.  The Cocoa application wrapper is not portable will need to be rewritten using native Windows APIs.  Hop onto [http://webkit.org/contact.html "our irc channel"] if you're interested in porting Drosera to Windows.