Chilkat Ruby Quick Start Tutorial

Prerequisite: RubyGems

Download and Install RubyGems from http://rubygems.org/

Step 1 - Download the Chilkat Ruby Gem

Download from Chilkat Ruby Downloads and save the .gem to any directory.

Step 2 - Install the Chilkat Ruby API using RubyGems

64-bit Linux

   tar xvfz chilkat-9.4.0-x86_64-linux.gem.tar.gz
   sudo gem install chilkat-9.4.0-x86_64-linux.gem

32-bit Linux

   tar xvfz chilkat-9.4.0-x86-linux.gem.tar.gz
   sudo gem install chilkat-9.4.0-x86-linux.gem

Windows

Unzip chilkat-9.4.0-x86-mswin32-60.gem.zip to any directory, then install using RubyGems:

   gem install chilkat-9.4.0-x86-mswin32-60.gem

Step 3 - Using the Chilkat Gem

Since you are using Chilkat via rubygems, you'll need to require 'rubygems' before 'chilkat'. Add these two 'require' statements at the beginning of your Ruby source file.

    require 'rubygems'
    require 'chilkat'
    
    # It should now be possible to instantiate and use Chilkat objects:
    mailman = Chilkat::CkMailMan.new()
    print mailman.version() + "\n"

Note 1 - 30 Day Trial for Commercial Classes

Chilkat's commercially licensed Ruby objects are fully-functional for a 30-day trial period. The UnlockComponent method should be called once at the beginning of a program. The trial period automatically begins when a non-valid unlock code is used. Licensed customers receive a permanent unlock code that is valid for all future versions of the particular object(s) licensed.

Note: The Chilkat Ruby library contains both freeware and commercially-licensed classes. Freeware classes, such as the ones for XML and digital certificates, do not have an UnlockComponent method and do not need to be unlocked.

zip = Chilkat::CkZip.new()
zip.UnlockComponent("anything for 30-day trial")

Note 2 - Chilkat Licenses Include all Programming Languages on all Supported Operating Systems

Each license sold by Chilkat is valid for all programming languages on all supported operating systems. For example, if you purchase a "Chilkat Zip" license, you may use the Chilkat Zip component/library in C++, .NET, VB6, ASP, Perl, Java, Delphi, Python, Ruby, etc.

Note 3 - New Version Upgrades are Always Free

Your permanent unlock code will work with all future versions of the product. Your 1-year unlimited support may expire, but you don't have to pay for new versions. Support is renewable at reduced pricing.

Note 4 - Bundle Pricing

Purchasing the Bundle provides licenses to all existing Chilkat products. Prices are $289 for a 1-Developer Bundle, $349 for up to 4-Developers, and $439 for Site-Wide (more than 4 developers). All licenses allow for royalty-free distribution of Chilkat DLL's / modules with your application.