Comment puis-je spécifier une gem locale dans mon Gemfile?

Question

Je voudrais que Bundler charge une gem locale. Y a-t-il une option pour cela? Ou dois-je déplacer le dossier gem dans le répertoire .bundle?

Answer 1

Je crois que vous pouvez le faire:

gem "foo", :path => "/path/to/foo" 

Answer 2

En plus de spécifier le chemin (comme Jimmy mentionné), vous pouvez également forcer Bundler à utiliser un petit bijou locale pour votre environnement que en utilisant la configuration suivante Option:

$ bundle config local.GEM_NAME /path/to/local/git/repository 

Cela est extrêmement utile si vous développez deux pierres précieuses ou un bijou et un rails côte à côte app.

Notez cependant que cela ne fonctionne que lorsque vous utilisez déjà git pour votre dépendance, par exemple:

# In Gemfile 
gem 'rack', :github => 'rack/rack', :branch => 'master' 

# In your terminal 
$ bundle config local.rack ~/Work/git/rack 

Comme on le voit sur the docs.

Answer 3

Vous pouvez également référencer une gem locale avec git si vous travaillez dessus.

gem 'foo', 
    :git => '/Path/to/local/git/repo', 
    :branch => 'my-feature-branch' 

Ensuite, si elle change je cours

bundle exec gem uninstall foo 
bundle update foo 

Mais je ne suis pas sûr que tout le monde a besoin d'exécuter ces deux étapes.

Answer 4

Pour utiliser dépôt gem local dans un projet Rails, suivez les étapes ci-dessous:

1. Vérifiez si votre dossier de pierres précieuses est un dépôt git (la commande est exécutée dans le dossier de pierres précieuses)

   git rev-parse --is-inside-work-tree 
   

2. Obtenir chemin du référentiel (la commande est exécutée dans le dossier de gemme)

   git rev-parse --show-toplevel 
   

3. Mise en place d'une application dérogation locale pour le rails

   bundle config local.GEM_NAME /path/to/local/git/repository 
   

   où GEM_NAME est le nom de votre bijou et /path/to/local/git/repository est la sortie de la commande au point 2

4. Dans votre application Gemfile ajoutez la ligne suivante :

   gem 'GEM_NAME', :github => 'GEM_NAME/GEM_NAME', :branch => 'master' 
   

5. Courir bundle install devrait donner quelque chose comme ceci:

   Using GEM_NAME (0.0.1) from git://github.com/GEM_NAME/GEM_NAME.git (at /path/to/local/git/repository) 
   

   où GEM_NAME est le nom de votre bijou et /path/to/local/git/repository du point 2

6. Enfin, exécutez bundle list, pas gem list et vous devriez voir quelque chose comme ceci:

   GEM_NAME (0.0.1 5a68b88) 
   

   où GEM_NAME est le nom de votre gemme

---

Quelques cas importants j'observe en utilisant:

Rails 4.0.2 
ruby 2.0.0p247 (2013-06-27 revision 41674) [x86_64-linux] 
Ubuntu 13.10 
RubyMine 6.0.3 

• Il semble RubyMine ne montre pas les pierres précieuses locales comme une bibliothèque externe. Plus d'informations sur le bug se trouve here et here
• Quand je change quelque chose dans la pierre locale, afin d'être chargé dans l'application rails je stop/start le serveur rails

• Si je change la version de la gemme, stopping/starting le serveur Rails me donne une erreur. Pour résoudre ce problème, je spécifie la version de pierres précieuses dans l'application rails Gemfile comme ceci:

  gem 'GEM_NAME', '0.0.2', :github => 'GEM_NAME/GEM_NAME', :branch => 'master' 
  

Answer 5

Si vous voulez la branche aussi:

gem 'foo', path: "point/to/your/path", branch: "branch-name" 

Answer 6

Vous pouvez référencer des pierres précieuses avec la source : source: 'https://source.com', git repository (:github => 'git/url') et avec le chemin d'accès local :path => '.../path/gem_name'.Vous pouvez en apprendre plus sur Gemfiles and how to use them dans cet article.