SharpDevelop Community

Get your problems solved!
Welcome to SharpDevelop Community Sign in | Join | Help
in Search

Matt Ward

December 2009 - Posts

  • IronRuby Integration Update

    Support for IronRuby in SharpDevelop has moved on since the last alpha release of the IronRuby addin. This addin now ships with SharpDevelop 3.2 which is available to download from the build server. The main new features are support for IronRuby 1.0 RC 1 and the ability to debug IronRuby applications.

    New Features

    • Windows Forms designer support now complete
    • Converting entire C# and VB.NET projects to IronRuby.
    • Debugger support for IronRuby applications.
    • Smart indenting for IronRuby code.
    • IronRuby 1.0 RC 1 support.

    Currently there is no support for IronRuby code completion.

    Now we will take a look at some of the new features in more depth.

    Running an IronRuby Application

    After you create an IronRuby application you can run it immediately without having to edit the project options as you did previously. The project templates have been updated so that everything is ready to go straight away. Simply select Run from the Debug menu to run your application with the IronRuby console.

    Debug run menu option

    Debugging an IronRuby Application

    In order to get the debugger to work well when debugging an IronRuby application you should change the debugger options. To open the debugger options select Options from the Tools menu, then select the Debugging category. Only the 'Just My Code' feature should be selected and everything else should be unselected, as shown in the screenshot below.

    Debugger options when debugging an IronRuby application

    You can set your breakpoints in the normal way either by clicking in the left hand margin of the text editor or by selecting Toggle Breakpoint from the Debug menu.

    Selecting Run from the Debug menu will run your IronRuby application under the debugger. Alternatively you can select Run from the Ruby menu which will run the code currently active text editor window. Selecting either of these will run the IronRuby console in debug mode with SharpDevelop's debugger.

    Breakpoint hit in IronRuby application

    Converting a C# or VB.NET Project to IronRuby

    To convert a VB.NET or C# project to IronRuby open the project and then select Convert from C# to Ruby or Convert from VB.NET to Ruby from the Project menu.

    Convert project to Ruby menu item

    Extra Ruby Libraries

    The IronRuby 1.0 RC 1 download from codeplex includes extra Ruby libraries that are not shipping with SharpDevelop. If you want to use these libraries then download the IronRuby zip file and copy the lib folder to the IronRuby addin folder:

    C:\Program Files\SharpDevelop\3.0\AddIns\AddIns\BackendBindings\RubyBinding

    The IronRuby console (ir.exe) is configured to look in the lib subfolder by information in the ir.exe.config file:

    <options> 
    <set language='Ruby' option='LibraryPaths' value='lib\IronRuby;lib\Ruby\site_ruby\1.8;lib\Ruby\site_ruby;lib\Ruby\1.8'/>
    </options>

    If you want to put these Ruby libraries somewhere else then the ir.exe.config file should be modified.

    IronRuby Downloads

    IronRuby 1.0 RC 1 from Codeplex

Powered by Community Server (Commercial Edition), by Telligent Systems
Don't contact us via this (fleischfalle@alphasierrapapa.com) email address.