Namespaces

Variants
Actions

Please note that as of October 24, 2014, the Nokia Developer Wiki will no longer be accepting user contributions, including new entries, edits and comments, as we begin transitioning to our new home, in the Windows Phone Development Wiki. We plan to move over the majority of the existing entries over the next few weeks. Thanks for all your past and future contributions.

Revision as of 05:44, 17 July 2012 by hamishwillee (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Downloading and Installing Ruby on Symbian

From Wiki
Jump to: navigation, search
Article Metadata
Article
Created: hamishwillee (10 May 2011)
Last edited: hamishwillee (17 Jul 2012)
Trails.png Getting Started with Ruby
 > Download and Install > Hello World > Ruby Quick Start

Ruby logo.gif
This article shows how to set up a Ruby on Symbian development environment. It explains how to get and install the needed files and how to set up your mobile device for testing.

Contents

Ruby development environment

Ruby scripts are simply text files containing code written in the Ruby programming language and named with the file extension ".rb". The scripts can be written in any text editor on any host operating system and can be run from within the "Ruby Front end" interactive GUI environment on your mobile device.

While any text editor may be used, we recommend Notepad ++ for its awareness of Ruby syntax. You can also use one of the myriad of Ruby IDEs (Netbeans, Aptana Radrails, RubyMine, to name just a few); Note however that while you'll be able to code in your preferred operating system, you won't be able to interactively debug a script running on the phone.

Set up your device

Note.pngNote: Ruby on Symbian is dependent on some of the standard C compatibility library: pips_nokia_x_x_SS.sis (and stdioserver_s60_x_x_SS.SIS if you want to direct output to standard IO)
These are present on Symbian platform devices, but may not be present on S60 devices; they should be installed prior to installing Ruby. We suggest you install all of Open C and Open C++ SIS files from the Open C/C++ Plug-ins. The plugin README.txt explains the location of the files that must be installed to the phone

The latest Symbian Ruby binaries, packaged as native installation files (.sisx), can be downloaded from the Files section of http://rubyforge.org/projects/symbian/:

Unzip the file and install the following files to your phone (following the instructions in How to get an app to the phone)

  • ruby.sisx - Ruby runtime
  • ruby_core_ext.sisx - natively implemented core functions
  • ruby_ecam.sisx - extension to provide access to the camera
  • ruby_eloc.sisx - extension to provide access to the current locale
  • ruby_etel.sisx - extension to provide access to basic telephony functionality
  • RubyFrontend.sisx - Shell for running scripts in

Standard Ruby libraries can be copied manually from any PC Ruby distribution to \Data\Ruby\Lib folder (default library search path) in the internal phone memory or on the memory card.

At this point you can put Ruby scripts on the phone and run them easily with the basic GUI interactive shell (that you installed with RubyFrontend.sisx). This shell also redirects all standard I/O streams to its main window, so it is not necessary to install any additional P.I.P.S. components to support STDIO console functionality. The shell application can be found in the "Applications" (or equivalent) folder on your device, and is obvious as it has the "Ruby" icon. A bit more information on this process is provided in the Ruby Hello World Tutorial

Set up the Emulator

The Windows-hosted Symbian Emulator is not supported due to ongoing migration to Platform Simulator able to run native ARM binary code.

Further information

The core Ruby documentation and many useful tutorials are available from the RubyForge documentation page.

Licence icon cc-by-sa 3.0-88x31.png© 2010 Symbian Foundation Limited. This document is licensed under the Creative Commons Attribution-Share Alike 2.0 license. See http://creativecommons.org/licenses/by-sa/2.0/legalcode for the full terms of the license.
Note that this content was originally hosted on the Symbian Foundation developer wiki.



Trails.png Getting Started with Ruby
 > Download and Install > Hello World > Ruby Quick Start

This page was last modified on 17 July 2012, at 05:44.
65 page views in the last 30 days.

Was this page helpful?

Your feedback about this content is important. Let us know what you think.

 

Thank you!

We appreciate your feedback.

×