Ruby Academy · Aula

Publicando no RubyGems

Publique sua gem.

Publicando no RubyGems é uma aula grátis de Ruby Academy no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Ruby Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Ruby Academy inclui 4 aulas no total.

O que é o RubyGems.org?

RubyGems.org é o site público onde as gemas Ruby são publicadas e baixadas. Quando você executa gem install ou bundle install, os pacotes são buscados lá por padrão.

A publicação torna sua gema instalável em todo o mundo.
Cada nome de gema é único e fica disponível para quem o registrar primeiro.
Depois que uma versão é publicada, ela deve ser considerada permanente.

Crie uma conta

Antes de publicar, você precisa de uma conta gratuita no RubyGems.org. Depois, entre pela linha de comando para que a ferramenta gem possa autenticar seus envios. As credenciais são armazenadas localmente para futuros envios.

Lista de verificação antes do lançamento

Antes de lançar, confirme:

O número da versão foi incrementado.
Os testes foram aprovados.
O registro de alterações foi atualizado.
O arquivo de especificação da gema lista todos os arquivos e a licença correta.

Alguns minutos de verificação evitam um lançamento público com problemas.

checklist = ["version bumped", "tests pass", "changelog updated", "gemspec valid"]
checklist.each { |item| puts "[ ] " + item }

Compilar o pacote

Execute gem build mygem.gemspec. Esse comando lê o arquivo de especificação do pacote e produz um arquivo como mygem-0.1.0.gem, contendo seu código e seus metadados. Esse é o artefato exato que será enviado.

Testar a compilação localmente

Instale o arquivo compilado em um ambiente limpo com gem install ./mygem-0.1.0.gem e tente carregá-lo. Isso identifica arquivos ausentes ou erros de carregamento antes que o mundo todo possa vê-los.

Publicar no RubyGems

Publique com gem push mygem-0.1.0.gem. Em instantes, a versão aparecerá no RubyGems.org e qualquer pessoa poderá instalá-la. O comando usa suas credenciais armazenadas para autorizar o envio.

Lançamento com Rake

Os pacotes estruturados pelo Bundler incluem uma tarefa rake release. Ela marca a versão no git, compila o pacote e o publica em uma única etapa, para que a etiqueta do git e a versão publicada sempre correspondam.

Você não pode publicar novamente uma versão

Depois que 1.0.0 for publicada, você não poderá sobrescrevê-la com código diferente. Para corrigir um problema, será necessário publicar uma nova versão, como 1.0.1. Isso garante que determinada versão seja sempre composta pelos mesmos bytes para todos os usuários.

published = "1.0.0"
fix = "1.0.1"
puts "Cannot overwrite " + published
puts "Publish " + fix + " instead"

Remover uma versão problemática

Se uma versão estiver com defeito ou for insegura, gem yank mygem -v 1.0.1 a removerá de novas instalações. Os arquivos de bloqueio existentes ainda poderão fazer referência a ela, portanto removê-la é um último recurso, não um botão de desfazer.

Protegendo sua conta

Proteja seu pacote contra sequestro:

Ative a autenticação multifator no RubyGems.org.
Use chaves de API com escopo e permissões limitadas.
Adicione coproprietários confiáveis com gem owner para que o pacote continue existindo se você se afastar.

Depois da publicação

Quando estiver disponível, compartilhe as instruções de instalação no seu README, anuncie o lançamento e fique atento a problemas. Responda aos relatórios de falhas com lançamentos de correção. Um pacote mantido gera confiança e adoção com o tempo.

Verificação rápida

Teste sua compreensão da publicação.

Recapitulação: publicação no RubyGems

Você aprendeu o fluxo de lançamento:

Crie uma conta e entre nela.
Execute uma lista de verificação preliminar e depois gem build.
Teste localmente e depois use gem push (ou rake release).
As versões são permanentes; publique correções como novas versões ou use gem yank.
Proteja sua conta com MFA e coproprietários.

Isso conclui o curso Construindo sua própria gem Ruby.

Perguntas Frequentes

A aula “Publicando no RubyGems” é grátis?

Sim — o texto completo de “Publicando no RubyGems” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Ruby Academy, atualize para CoddyKit PRO. O curso de Ruby Academy inclui 4 aulas no total.

O que vou aprender em “Publicando no RubyGems”?

Publique sua gem. Você pratica Ruby Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Ruby Academy?

Nenhuma experiência prévia é necessária. Ruby Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.

Quanto tempo leva a aula “Publicando no RubyGems”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Ruby Academy?

Sim. Cada aula de Ruby Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

← Voltar para Ruby Academy