How to use bundler with iOS projects

bundlerInIOS.MD

#How to use Bundler with iOS projects

You probably stuck with situation when after finishing for example bundle install && bundle exec pod install Bundler couldn't access gems which he just download. Some of you may think "RVM is the answer!" and yes it is, but what if it is not?

##Don't use macOS's gems. Just DON'T.

1. Establish that you will don't use macOS's gems and RVM.

2. Go to your_app_dir

3. Make sure you have Gemfile if not create one

   example Gemfile

   source 'https://rubygems.org'
   
   gem 'cocoapods'
   gem 'cocoapods-keys'
   gem 'redcarpet'
   gem 'rswift-ios'
   

4. Now there are two scenarios:

   1. you have BUNDLE_PATH defined in your_app_dir/.bundle/config.

      example your_app_dir/.bundle/config

      ---
      BUNDLE_PATH: ".gems"
      BUNDLE_DISABLE_SHARED_GEMS: "true"
      

      So then you just type bundle install which will install gems from Gemfile to `your_app_dir/.gems'

   2. you don't have BUNDLE_PATH defined in your_app_dir/.bundle/config. This is most likely situation. Then instead of regular bundle install you have to type bundle install --path .gems. This will define BUNDLE_PATH in your_app_dir/.bundle/config and install missing gems.

5. Now bundle will use .gems (or other dir) by default and will not interfere with system gems.

They recommend to use bundle config set path '.gems', following by bundle install. --path will be deprecated soon.