Código distribuído pelo RubyGems
Uma gem é um pacote que distribui uma biblioteca ou um programa para Ruby junto de seus metadados. O RubyGems usa essas informações para identificar a versão e instalar o pacote com suas dependências. A distribuição costuma ter a extensão .gem.
O arquivo gemspec descreve o conteúdo do pacote. Uma gem pode incluir executáveis, mas também pode fornecer apenas código de biblioteca, carregado pelo programa Ruby quando necessário.
Instalar uma gem e carregar seu código
O guia oficial do RubyGems usa a gem awesome_print para demonstrar o carregamento de uma biblioteca. A instalação pelo terminal utiliza:
gem install awesome_printApós a instalação bem-sucedida, a gem fica disponível no ambiente Ruby utilizado pelo comando. O código Ruby carrega a biblioteca com require "ap". Nesse exemplo, awesome_print é o nome do pacote e ap é o nome usado para carregar seu arquivo de entrada. Instalar o pacote não executa esse require dentro da aplicação.
A compatibilidade também depende da versão do Ruby e da plataforma declarada. Algumas gems incluem extensões nativas que precisam ser compiladas no ambiente de instalação. Outras distribuem essas partes já compiladas para uma plataforma específica, então você precisa conferir se a distribuição atende ao sistema utilizado.
Dúvidas frequentes
Perguntas frequentes sobre gem
- Toda gem oferece um comando no terminal?
- Uma gem pode conter somente uma biblioteca. Os comandos de terminal dependem dos executáveis que o pacote inclui e declara.
- A plataforma ruby dispensa conferir a versão do Ruby?
- A plataforma ruby indica uma distribuição sem restrição a uma plataforma específica. A versão do Ruby exigida pelo pacote ainda precisa ser compatível.
- Qual é o papel do arquivo gemspec?
- O gemspec descreve o pacote para o RubyGems. Ele informa a versão e os arquivos distribuídos, além de permitir declarar as dependências.
Para continuar
Recursos relacionados
Documentação
RubyGems: estrutura e identificação dos pacotes
Explica a estrutura de uma gem e a identificação do pacote por nome, versão e plataforma.
Abrir recursoAplicação na formação
Developer Workspace
Você precisa conferir a versão do Ruby e a plataforma exigidas pelas gems utilizadas no ambiente de desenvolvimento.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.