Làm cách nào tôi có thể chỉ định một viên ngọc địa phương trong Gemfile của mình?

Tôi muốn Bundler tải một viên ngọc địa phương. Có một lựa chọn cho điều đó? Hoặc tôi phải di chuyển thư mục gem vào thư mục .bundle?

Tôi tin rằng bạn có thể làm điều này:

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

Ngoài việc chỉ định đường dẫn (như Jimmy đã đề cập), bạn cũng có thể buộc Bundler sử dụng đá quý cục bộ cho môi trường của mình chỉ bằng cách sử dụng tùy chọn cấu hình sau:

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

Điều này cực kỳ hữu ích nếu bạn đang phát triển hai viên đá quý hoặc đá quý và ứng dụng đường ray song song.

Tuy nhiên, xin lưu ý rằng điều này chỉ hoạt động khi bạn đang sử dụng git cho sự phụ thuộc của mình, ví dụ:

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

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

Như đã thấy trên các tài liệu .

Bạn cũng có thể tham chiếu một viên ngọc địa phương với git nếu bạn tình cờ làm việc với nó.

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

Sau đó, nếu nó thay đổi, tôi chạy

bundle exec gem uninstall foo
bundle update foo

Nhưng tôi không chắc ai cũng cần chạy hai bước này.

Để sử dụng kho đá quý cục bộ trong dự án Rails, hãy làm theo các bước dưới đây:

1. Kiểm tra xem thư mục gem của bạn có phải là kho lưu trữ git không (lệnh được thực thi trong thư mục gem)

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

2. Bắt đường dẫn kho lưu trữ (lệnh được thực thi trong thư mục gem)

   git rev-parse --show-toplevel

3. Thiết lập ghi đè cục bộ cho ứng dụng đường ray

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

   nơi GEM_NAMElà tên của đá quý của bạn và /path/to/local/git/repositorylà sản phẩm của các lệnh trong điểm2

4. Trong ứng dụng của bạn Gemfilethêm dòng sau:

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

5. Chạy bundle installnên cho một cái gì đó như thế này:

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

   nơi GEM_NAMElà tên của đá quý của bạn và /path/to/local/git/repositorytừ điểm2

6. Cuối cùng, chạy bundle list, không gem listvà bạn sẽ thấy một cái gì đó như thế này:

   GEM_NAME (0.0.1 5a68b88)

   nơi GEM_NAMElà tên của đá quý của bạn

Một vài trường hợp quan trọng tôi đang quan sát bằng cách sử dụng:

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

• Có vẻ như RubyMinekhông hiển thị đá quý địa phương như một thư viện bên ngoài. Thông tin thêm về lỗi có thể được tìm thấy ở đây và đây
• Khi tôi thay đổi thứ gì đó trong đá quý cục bộ, để được tải trong ứng dụng rails, tôi nên sử dụng stop/startmáy chủ rails

• Nếu tôi thay đổi versionviên ngọc, stopping/startingmáy chủ Rails sẽ báo lỗi cho tôi. Để khắc phục, tôi chỉ định phiên bản đá quý trong ứng dụng rails Gemfilenhư thế này:

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

Bạn có thể tham khảo đá quý với nguồn: source: 'https://source.com', git repository (:github => 'git/url')và với đường dẫn cục bộ :path => '.../path/gem_name'.
Bạn có thể tìm hiểu thêm về Gemfiles và cách sử dụng chúng trong bài viết này.

Nếu bạn muốn chi nhánh quá:

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