/motion-cocoapods

Use CocoaPods with RubyMotion

Primary LanguageRubyBSD 2-Clause "Simplified" LicenseBSD-2-Clause

motion-cocoapods

motion-cocoapods allows RubyMotion projects to integrate with the CocoaPods dependency manager.

Installation

$ [sudo] gem install motion-cocoapods

Or if you use Bundler:

gem 'motion-cocoapods'

Setup

  1. Edit the Rakefile of your RubyMotion project and add the following require line:

    require 'rubygems'
    require 'motion-cocoapods'
  2. Still in the Rakefile, set your dependencies using the same language as you would do in Podfiles.

    Motion::Project::App.setup do |app|
      # ...
      app.pods do
        pod 'AFNetworking'
      end
    end
  3. If this is the first time using CocoaPods on your machine, you'll need to let CocoaPods do some setup work with the following command:

    $ [bundle exec] pod setup
    

Tasks

To tell motion-cocoapods to download your dependencies, run the following rake task:

$ rake pod:install

That’s all. The build system will properly download the given pods and their dependencies. On the next build of your application it will pod the pods and link them to your application executable.

If the vendor/Podfile.lock file exists, this will be used to install specific versions. To update the versions, use the following rake task:

$ rake pod:update

Options

By default the output of CocoaPods doing its work is silenced. If, however, you would like to see the output, you can set the COCOAPODS_VERBOSE env variable:

$ rake pod:install COCOAPODS_VERBOSE=1

As part of the install and update tasks, the specification repostories will get updated. You can disable this with the COCOAPODS_NO_REPO_UPDATE env variable:

$ rake pod:install COCOAPODS_NO_REPO_UPDATE=1

Contribute

  1. Setup a local development environment.

    $ git clone git://github.com/HipByte/motion-cocoapods.git
    $ cd motion-cocoapods
    $ rake bootstrap
    
  2. Verify that all the tests are passing.

    $ rake spec
    
  3. Create your patch and send a pull-request.

License

Copyright (c) 2012-2013, Laurent Sansonetti lrz@hipbyte.com All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

  1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
  2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.