[ruby-gnome2-doc-cvs] [Hiki] update - Install Guide for Windows

アーカイブの一覧に戻る

ruby-****@lists***** ruby-****@lists*****
2003年 6月 5日 (木) 01:48:34 JST


-------------------------
REMOTE_ADDR = 210.249.203.62
REMOTE_HOST = 
        URL = http://ruby-gnome2.sourceforge.jp/?Install+Guide+for+Windows
-------------------------
= Install Guide

== Windows

=== Note

* The installation should be quick and easy. The minimum packages are ((<Ruby|URL:http://www.ruby-lang.org>)), ((<Ruby-GTK2|URL:http://ruby-gnome2.sf.net>)) and GTK2 binaries for Windows from ((<Dropline|URL:http://www.dropline.net>)).
* The entire Ruby-GNOME2 package isn't supported on Windows yet, and may never be, as it requires GNOME 2.
* The versions of Windows are categorized in Win9X/ME and WinNT/2000/XP/2003.
* This installation process was tested with Ruby 1.8, but it should work with version 1.6 as well.

=== Steps

==== One

* Download ((<Ruby packaged by the Pragmatic Programmers|URL:http://rubyinstaller.sourceforge.net/>)). 
* ((<ruby180-9.exe|URL:http://prdownloads.sourceforge.net/rubyinstaller/ruby180-9.exe?download>)) is recommended for this example. 
* Install it in any directory (Ex: c:\Ruby).

==== Two

* Download ((<Ruby-GTK2 binaries for Windows|URL:http://sourceforge.net/project/showfiles.php?group_id=53614>)).
* ((<ruby-gtk2-0.4.0-1-i386-msvcrt-1.8.zip|URL:http://prdownloads.sourceforge.net/ruby-gnome2/ruby-gtk2-0.4.0-1-i386-msvcrt-1.8.zip?download>)) is recommended for this example.
* Unzip it in ruby-install-dir (Ex: c:\Ruby).

==== Three

* Download ((<GTK+2 Runtime Environment binaries for Windows from Dropline|URL:http://www.dropline.net/gtk/download.php>)).
* ((<GTK-Runtime-Environment-2.2.1.2.exe|URL:http://prdownloads.sourceforge.net/gtk-win/GTK-Runtime-Environment-2.2.1.2.exe?download>)) is recommended for this example.
* Install it in any directory (Ex: c:\Gtk).

==== Four

* Enough downloads. Time to configure it. Basicly, there is only one Environment Variable that needs to hold the directories where the important binaries that need to be shared are located.
* Conventions:
  * ruby-install-dir is the directory where Ruby was installed. Ex: c:\Ruby
  * gtk-install-dir is the directory where GTK+2 was installed. Ex: c:\Gtk
* On Win9X/ME
  * Edit the c:\autoexec.bat file. Append a line (Yes, it should be the last one to be safer) that reads ((*SET PATH=%PATH%;ruby-install-dir\bin;gtk-install-dir\bin;gtk-install-dir\lib*)) . Reboot for the changes to take effect.
* On WinNT/2000/XP/2003
  * Open Panel Control>System>Advanced>Environment Variables. If there is a System Variable called PATH, just append to it ((*ruby-install-dir\bin;gtk-install-dir\bin;gtk-install-dir\lib*)). If there isn't one, add PATH and set its value to ((*ruby-install-dir\bin;gtk-install-dir\bin;gtk-install-dir\lib*)).

==== Five

* Time to test it. Don't worry if something didn't go well, as there is a trouble shooting area below.
* The following commands should be typed on the "Prompt for DOS". To open the Prompt for DOS on:
    * Win9X/ME click on the Start Button and Run(Execute ?). Type ((*command*)) and hit the <ENTER> key.
    * WinNT/2000/XP/2003 click on the Start Button and Run(Execute ?). Type ((*cmd*)) and hit the <ENTER> key.
    C:\>ruby -v
    ruby 1.8.0 (2003-05-26) [i386-mswin32]

    C:\>ruby -e "require 'gtk2'"

    C:\>ruby -e "require 'gtk2';include Gtk;Gtk.init;w=Window.new;w.title='Hello Ruby-GNOME2 World!';w.set_size_request(500,400);w.signal_connect('delete_event'){Gtk.main_quit};w.show_all;Gtk.main"
* Don't worry about the warnings that were shown, as they are fixed on the current release, and as soon as Masahiro Sakai releases the new binaries for Windows, they will disappear.
* If it didn't return any error, it's done. From here you can follow to the ((<tutorial|URL:http://ruby-gnome2.sourceforge.net/tut/toc.htm>)).

=== Trouble Shooting
--- PATH Environment Variable
    Check if the PATH Environment Variable is set correctly. Type SET PATH on the "Prompt for DOS" and check if it contains ((*ruby-install-dir\bin;gtk-install-dir\bin;gtk-install-dir\lib*)) as explained above. Redo the above configuration if needed. Close and Reopen the "Prompt for DOS" for it to load the new value on WinNT/2000/XP/2003, or Reboot the machine on Win9X/ME.

    The PATH Env. Var. on my system reads:
      C:\>SET PATH
      Path=C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\System32\Wbem;C:\dev\python;C:\j2sdk1.4.2\bin;C:\ruby\bin;C:\Gtk\bin;C:\Gtk\lib

    Be careful with directories that have spaces in their names, as that could cause breaks in the spaces, provoking errors. Try to enclose them with quotes (Ex: "c:\my spaced directory name") if you get errors with the PATH Env. Var. .
--- ruby -v
    If this command doesn't work, check if ruby-install-dir\bin is set correcly in the PATH Env. Var. .
--- ruby -e "require 'gtk2'"
    If this command doesn't work, check if gtk-install-dir\bin and gtk-install-dir\lib are set correcly in the PATH Env. Var. .

    If it still doesn't work after that, then tell us more about what kind of error you are getting on the ((<mailling lists|URL:http://sourceforge.net/mail/?group_id=53614>)).


=== Author
* Joao Pedrosa - joaopedrosa at yahoo dot com

=== ChangeLog
-------------------------
= Install Guide

== Windows

=== Note

* The installation should be quick and easy. The minimum packages are ((<Ruby|URL:http://www.ruby-lang.org>)), ((<"Ruby/GTK2"|URL:http://ruby-gnome2.sf.net>)) and GTK2 binaries for Windows from ((<Dropline|URL:http://www.dropline.net>)).
* The entire Ruby-GNOME2 package isn't supported on Windows yet, and may never be, as it requires GNOME 2.
* The versions of Windows are categorized in Win9X/ME and WinNT/2000/XP/2003.
* This installation process was tested with Ruby 1.8, but it should work with version 1.6 as well.

=== Steps

==== One

* Download ((<Ruby packaged by the Pragmatic Programmers|URL:http://rubyinstaller.sourceforge.net/>)). 
* ((<ruby180-9.exe|URL:http://prdownloads.sourceforge.net/rubyinstaller/ruby180-9.exe?download>)) is recommended for this example. 
* Install it in any directory (Ex: c:\Ruby).

==== Two

* Download ((<"Ruby/GTK2 binaries for Windows"|URL:http://sourceforge.net/project/showfiles.php?group_id=53614>)).
* ((<ruby-gtk2-0.4.0-1-i386-msvcrt-1.8.zip|URL:http://prdownloads.sourceforge.net/ruby-gnome2/ruby-gtk2-0.4.0-1-i386-msvcrt-1.8.zip?download>)) is recommended for this example.
* Unzip it in ruby-install-dir (Ex: c:\Ruby).

==== Three

* Download ((<GTK+2 Runtime Environment binaries for Windows from Dropline|URL:http://www.dropline.net/gtk/download.php>)).
* ((<GTK-Runtime-Environment-2.2.1.2.exe|URL:http://prdownloads.sourceforge.net/gtk-win/GTK-Runtime-Environment-2.2.1.2.exe?download>)) is recommended for this example.
* Install it in any directory (Ex: c:\Gtk).

==== Four

* Enough downloads. Time to configure it. Basicly, there is only one Environment Variable that needs to hold the directories where the important binaries that need to be shared are located.
* Conventions:
  * ruby-install-dir is the directory where Ruby was installed. Ex: c:\Ruby
  * gtk-install-dir is the directory where GTK+2 was installed. Ex: c:\Gtk
* On Win9X/ME
  * Edit the c:\autoexec.bat file. Append a line (Yes, it should be the last one to be safer) that reads ((*SET PATH=%PATH%;ruby-install-dir\bin;gtk-install-dir\bin;gtk-install-dir\lib*)) . Reboot for the changes to take effect.
* On WinNT/2000/XP/2003
  * Open Panel Control>System>Advanced>Environment Variables. If there is a System Variable called PATH, just append to it ((*ruby-install-dir\bin;gtk-install-dir\bin;gtk-install-dir\lib*)). If there isn't one, add PATH and set its value to ((*ruby-install-dir\bin;gtk-install-dir\bin;gtk-install-dir\lib*)).

==== Five

* Time to test it. Don't worry if something didn't go well, as there is a trouble shooting area below.
* The following commands should be typed on the "Prompt for DOS". To open the Prompt for DOS on:
    * Win9X/ME click on the Start Button and Run(Execute ?). Type ((*command*)) and hit the <ENTER> key.
    * WinNT/2000/XP/2003 click on the Start Button and Run(Execute ?). Type ((*cmd*)) and hit the <ENTER> key.
    C:\>ruby -v
    ruby 1.8.0 (2003-05-26) [i386-mswin32]

    C:\>ruby -e "require 'gtk2'"

    C:\>ruby -e "require 'gtk2';include Gtk;Gtk.init;w=Window.new;w.title='Hello Ruby-GNOME2 World!';w.set_size_request(500,400);w.signal_connect('delete_event'){Gtk.main_quit};w.show_all;Gtk.main"
* Don't worry about the warnings that were shown, as they are fixed on the current release, and as soon as Masahiro Sakai releases the new binaries for Windows, they will disappear.
* If it didn't return any error, it's done. From here you can follow to the ((<tutorial|URL:http://ruby-gnome2.sourceforge.net/tut/toc.htm>)).

=== Trouble Shooting
--- PATH Environment Variable
    Check if the PATH Environment Variable is set correctly. Type SET PATH on the "Prompt for DOS" and check if it contains ((*ruby-install-dir\bin;gtk-install-dir\bin;gtk-install-dir\lib*)) as explained above. Redo the above configuration if needed. Close and Reopen the "Prompt for DOS" for it to load the new value on WinNT/2000/XP/2003, or Reboot the machine on Win9X/ME.

    The PATH Env. Var. on my system reads:
      C:\>SET PATH
      Path=C:\WINDOWS\system32;C:\WINDOWS;C:\WINDOWS\System32\Wbem;C:\dev\python;C:\j2sdk1.4.2\bin;C:\ruby\bin;C:\Gtk\bin;C:\Gtk\lib

    Be careful with directories that have spaces in their names, as that could cause breaks in the spaces, provoking errors. Try to enclose them with quotes (Ex: "c:\my spaced directory name") if you get errors with the PATH Env. Var. .
--- ruby -v
    If this command doesn't work, check if ruby-install-dir\bin is set correcly in the PATH Env. Var. .
--- ruby -e "require 'gtk2'"
    If this command doesn't work, check if gtk-install-dir\bin and gtk-install-dir\lib are set correcly in the PATH Env. Var. .

    If it still doesn't work after that, then tell us more about what kind of error you are getting on the ((<mailling lists|URL:http://sourceforge.net/mail/?group_id=53614>)).


=== Author
* Joao Pedrosa - joaopedrosa at yahoo dot com

=== ChangeLog
:2003-06-05 Masao Mutoh
 Change Library name(Ruby-GTK to Ruby/GTK)
:2003-06-04 Joao Pedrosa
 Initial release




ruby-gnome2-cvs メーリングリストの案内
アーカイブの一覧に戻る