Guia de Instalação

Nota

• A instalação deve ser rápida e fácil. Os pacotes mínimos são Ruby, Ruby/GTK2 e os binários de GTK2 para Windows de Dropline.
• O pacote todo Ruby-GNOME2 não é suportado no Windows ainda, e pode nunca ser, como ele exige o GNOME 2.
• As versões de Windows são categorizadas em Win9X/ME e WinNT/2000/XP/2003.
• Este processo de Instalação foi testado com Ruby 1.8.

Passos

Um

• Baixe Ruby empacotado pelos "Programadores Práticos".
• ruby180-9.exe é recomendado para este exemplo.
• Instale-o em qualquer diretório (Ex.: c:\Ruby).

Dois

• Baixe os binários de Ruby/GTK2 para Windows.
• ruby-gtk2-0.8.0-1-i386-msvcrt-1.8.zip é recomendado para este exemplo.
• Unzip ele em ruby-install-dir (Ex.: c:\Ruby).

Três

• Baixe os binários do ambiente de execução de GTK+2 para Windows de Dropline.
• GTK-Runtime-Environment-2.2.4.1.exe é recomendado para este exemplo.
• Instale-o em qualquer diretório (Ex.: c:\Gtk).

Quatro

• Chega de downloads. Hora de configura-lo. Basicamente, exist apenas uma Variável de Ambiente que precisa guardar os diretórios onde os binários importantes que precisam ser compartilhados estão localizados.
• Convenções:
  • ruby-install-dir é o diretório onde Ruby foi instalado. Ex.: c:\Ruby
  • gtk-install-dir é o diretório onde o GTK+2 foi instalado. Ex.: c:\Gtk
• No Win9X/ME
  • Edite o arquivo c:\autoexec.bat. Adicione uma linha (Sim, precisa ser a última para ficar mais seguro) que lê SET PATH=%PATH%;ruby-install-dir\bin;gtk-install-dir\bin;gtk-install-dir\lib . Reinicie para que as alterações surtam efeito.
• No WinNT/2000/XP/2003
  • Abra o Painel de Controle>Sistema>Advançado>Variáveis de Ambiente. Se existe uma Variável de Sistema chamada PATH, apenas adicione a ela ruby-install-dir\bin;gtk-install-dir\bin;gtk-install-dir\lib. Se não existe uma, então adicione PATH e configure o seu valor para ruby-install-dir\bin;gtk-install-dir\bin;gtk-install-dir\lib.

Cinco

• Hora de testar. Não se preocupe se algo não ocorreu bem, pois existe uma área de correção de problemas abaixo.

• Os comandos a seguir devem ser digitados na "Linha de Comando para DOS". Para abrir a "Linha de Comando para DOS" no:

  • Win9X/ME clique no Botão Iniciar e Executar. Digite command e aperte a tecla <ENTER>.
  • WinNT/2000/XP/2003 clique no Botão Iniciar e Executar. Digite cmd e aperte a tecla <ENTER>.

  C:\>ruby -v
  ruby 1.8.0 (2003-05-26) [i386-mswin32]
  
  C:\>ruby -e "require 'gtk2'"
  
  C:\>ruby -rgtk2 -e "Gtk::Window.new('Olá mundo do Ruby-GNOME2!').show_all;Gtk.main"

• Se não retornou erro algum, está feito. Daqui você pode seguir um dos nossos tutoriais.

Correção de Problemas

Variável de Ambiente PATH

Cheque se a Variável de Ambiente PATH está configurada corretamente. Digite SET PATH na "Linha de Comando para DOS" e cheque se ela contém ruby-install-dir\bin;gtk-install-dir\bin;gtk-install-dir\lib como explicado acima. Refaça a configuração acima se necessário. Feche e re-abra a "Linha de Comando para DOS" para que ela carregue o novo valor no WinNT/2000/XP/2003, ou reinicie a máquina no Win9X/ME.

A Variável de Ambiente PATH no meu sistema lê:

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

Seja cuidadoso com os diretórios que têm espaços nos nomes, pois eles podem causar quebras nos espaços, provocando erros. Tente cerca-los com aspas (Ex.: "c:\meu nome de diretório com espaço") se você obter erros com a Variável de Ambiente PATH.

ruby -v

Se esse comando não funciona, cheque se ruby-install-dir\bin está configurado corretamente na Variável de Ambiente PATH.

ruby -e "require 'gtk2'"

Se esse comando não funciona, cheque se gtk-install-dir\bin e gtk-install-dir\lib estão configurados corretamente na Variável de Ambiente PATH.

Se ainda não funciona após isso, então nos conte mais a respeito de que tipo de erro voce está obtendo nas listas de discussões.

Configuração de Fonte

Se você não pode mostrar rótulos e menus na sua linguagem, adicione font-setting para C:\Arquivos de Programas\Arquivos Comuns\GTK\2.0\etc\gtk-2.0\gtkrc

style "user-font"
{
  font_name="ms pgothic 10"
}
widget_class "*" style "user-font"

Autor

• Joao Pedrosa - joaopedrosa at yahoo dot com

Log de Alterações

2003-12-18 Masao Mutoh

Atualização do pacote Ruby-GNOME2 para 0.8.0.

2003-12-14 Masao Mutoh

Adicionamento de configuração de fonte, e atualização de algumas informações velhas.

2003-11-05 Masahiro Sakai

Atualização de pacote gtk dropline para GTK-Runtime-Environment-2.2.4.1.exe

2003-09-08 Masahiro Sakai

Atualização para Ruby-GNOME2 0.7.0

2003-06-05 Masao Mutoh

Alteração de nome de biblioteca(Ruby-GTK para Ruby/GTK)

2003-06-04 Joao Pedrosa

Versão inicial

Autor da Tradução para Português: Joao Pedrosa