Integrate 3rd-party libraries in RubyMotion for iOS / OS X projects via CocoaPods
motion-cocoapods allows RubyMotion projects to integrate with the CocoaPods dependency manager.
$ [sudo] gem install motion-cocoapods
Or if you use Bundler:
gem 'motion-cocoapods'
Rakefileof your RubyMotion project and add the following require line:
require 'rubygems' require 'motion-cocoapods'
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
You can use
use_frameworks!to install pods as frameworks (NOTE This feature requires RubyMotion 4.18+).
Motion::Project::App.setup do |app| # ... app.pods do use_frameworks! pod 'AFNetworking' end end
$ [bundle exec] pod setup
To tell motion-cocoapods to download your dependencies, run the following rake task:
$ [bundle exec] 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.lockfile exists, this will be used to install specific versions. To update the versions, use the following rake task:
$ [bundle exec] rake pod:update
If necessary, you can pass
vendor_projectoptions to the
podsconfiguration method. These options are described here. For instance, to only generate BridgeSupport metadata for a single pod, which might be needed if a dependency that you’re not using directly is causing issues (such as C++ headers), you can specify that like so:
Motion::Project::App.setup do |app| app.pods :headers_dir => 'Headers/AFNetworking' do pod 'AFNetworking' # ... end end
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_VERBOSEenv variable:
$ [bundle exec] rake pod:install COCOAPODS_VERBOSE=1
$ git clone git://github.com/HipByte/motion-cocoapods.git $ cd motion-cocoapods $ [bundle exec] rake bootstrap
$ [bundle exec] rake spec
Copyright (c) 2012-2015, HipByte ([email protected]) and contributors. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
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.