Installing Ruby on Microsoft Windows

PDF for offline use
Related Links:

Let us know how you feel about this


0/250

last updated: 2016-01

This guide describes how to install Ruby on Microsoft Windows for use with Calabash.

Overview

This guide will describe how to install Ruby on Microsoft Windows.

Installing Ruby on Microsoft Windows is a two-step process, running the Ruby installer and then installing the Ruby DevKit. The Ruby DevKit is a toolkit that is required to build native extensions of the C/C++ extensions available for Ruby.

Installing Ruby

To begin, navigate to the download page on the Ruby Installer website. Download the installers for Ruby 2.1.6 and the DevKit:

First, run the Ruby Installer. It is recommended to add the Ruby executables to your PATH and to associated .rb and .rbw files with the Ruby installation:

Once the installer has finished, you can verify that Ruby has been installed by running ruby –v in PowerShell to see the version information about the installed Ruby:

PS C:\temp> ruby -v
ruby 2.1.6p336 (2015-04-13 revision 50298) [x64-mingw32]
PS C:\temp>

Next, install the DevKit as described below.

Installing the Ruby DevKit

The executable for the DevKit is actually a self-extracting archive and not a true installer. Full instructions about installing the DevKit, summarized below, may be found on their wiki:

  1. Run the EXE that was download and extract it to a directory that has no spaces. It can be any directory you choose, however C:\DevKit is recommended:

  2. Next, open up PowerShell, and change the working directory to where the DevKit was installed, i.e. cd C:\DevKit.

  3. Initialize the DevKit installer by running:

    PS C:\DevKit> ruby dk.rb init
    [INFO] found RubyInstaller v2.0.0 at C:/Ruby221-x64
    
    Initialization complete! Please review and modify the auto-generated
    'config.yml' file to ensure it contains the root directories to all
    of the installed Rubies you want enhanced by the DevKit.
  4. Finally, install the DevKit installer:

    PS C:\DevKit> ruby dk.rb install
    [INFO] Updating convenience notice gem override for 'C:/Ruby200-x64'
    [INFO] Installing 'C:/Ruby200-x64/lib/ruby/site_ruby/devkit.rb'

At this point your Ruby installation should be complete, and it is now possible to install the Calabash gems for Test Cloud.

Summary

This guide covered how to install Ruby on Microsoft Windows 10.

Xamarin Workbook

If it's not already installed, install the Xamarin Workbooks app first. The workbook file should download automatically, but if it doesn't, just click to start the workbook download manually.