Documentation for Ice 3.6. The documentation for Ice 3.5 and Ice 3.4 is available in separate spaces.

Skip to end of metadata
Go to start of metadata

This page provides important information for users of the Ice for Ruby distribution.

On this page:

Overview of the Ice for Ruby Distribution

Ice for Ruby is available as a collection of Ruby gems. Each package provides the following components:

  • Ice extension for Ruby
  • Standard Slice files
  • Slice-to-Ruby compiler (slice2rb)


Installing the Ice for Ruby Distribution

Linux and OS X users can install Ice for Ruby using this command:

This gem builds Ice for Ruby from source and supports Ruby 1.8 or later.

Windows users can install a binary gem instead:

These gems require Ruby 2.3.

Using Ice for Ruby

The installation process automatically adds the Ice modules to Ruby's package directory and adds the Slice-to-Ruby compiler (slice2rb) to a directory that's likely already in your executable search path. To verify that Ice is installed, execute these commands:

The output of getSliceDir shows where the standard Slice files have been installed.

Ruby 1.8

Icon

 Users of Ruby 1.8 must add the -rubygems option when starting the interpreter with irb or ruby:

The Ice manual provides a complete description of the Ruby mapping, including the options for generating Ruby code from Slice definitions.

 

Using the sample programs

Sample programs are provided in a separate GitHub repository. You can browse this repository to see build and usage instructions for all supported programming languages. Simply clone this repository and use its 3.6 branch:

  • No labels