IB
RubyMotion interface builder support (yes, with outlets)
Installation
Add this line to your application's Gemfile:
gem 'ib'
And then execute:
$ bundle
Or install it yourself as:
$ gem install ib
Or use RubyMotion templates by @infiniteNIL
In your Rake file:
$:.unshift("/Library/RubyMotion/lib")
require 'motion/project'
# if you use bundler
require 'bundler'
Bundler.require
# if you are not using bundler
require 'rubygems'
require 'ib'
Motion::Project::App.setup do |app|
# ...
end
Usage
Manual Way
extend your class with IB module
class HelloController < UIViewController
extend IB
# define ib outlet
outlet :title, UILabel # @property IBOutlet UILabel * title;
outlet :untyped_label # @property IBOutlet id untyped_label;
# define ib outlet collection
outlet_collection :labels, UILabel # @property IBOutletCollection(UILabel) NSArray * labels;
# define ib action
def someAction sender
end
end
NOTE: If you include methods and attributes from module, you can use ib_outlet
and ib_action
to make them visible in Interface Builder
module TouchLogger
outlet :my_button, UIButton
def controlTouched sender
puts "touched"
end
end
class LogController < UIViewController
extend IB
include TouchLogger
ib_outlet :my_button
ib_action :controlTouched
end
Generators Way
Generate controller with folllowing command:
ib c Hello UIViewController \
--outlets scroller:UIScrollView btn_hello: \
--actions say_hello \
--accessors data_source
The generated file:
/app/controllers/hello_controller.rb
class HelloController < UIViewController
extend IB
attr_accessor :data_source
## ib outlets
outlet :scroller, UIScrollView
outlet :btn_hello
def say_hello(sender)
# TODO Implement action here
end
end
Using Interface Builder
Running rake ib:open
will create a ib.xcodeproj in the root of your app and open XCode. You can create Storyboards or nibs, and save them in your resources
directory in order to be picked up by RubyMotion.
Everytime you make a change in your ruby files (like adding a new outlet or action method) you have to run rake ib:open
in order to let Interface Builder see the changes.
Tip : add ib.xcodeproj to your .gitignore
How it works
This gem parses your Ruby code and generates two Objective-c files (Stub.m and Stub.h) which are populated with the classes, methods and outlets you have defined. This is necessary for Interface Builder to bind outlets and actions to your code.
Sample app
Here is sample app
- clone it
- run
bundle
- run
rake ib:open
to change story board - run
rake
to run app in simulator
Note : this app is build for iOS 6.0
Another Sample app
Here is another sample app
OS X Sample app
Here is OS X sample app
You can play around with it in the same way as the Sample app above. This sample uses a single xib file rather than a storyboard.
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Added some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request