Flow

Flow is a set of cross-platform libraries for RubyMotion. It can be seen as RubyMotion's missing standard library.

Each library implements the following requirements:

• Simple Ruby API
• 100% cross-platform (iOS, Android and OS X)
• No external dependencies
• Covered by tests
• Documented

WARNING: Flow is currently a work in progress. Some specs might be broken, APIs might change, and documentation might be missing. We are working toward a stable release. If you want to help please get in touch.

Libraries

Flow is currently composed of the following libraries:

• UI - User interface framework
• Net - HTTP networking and host reachability
• JSON - JSON serialization
• Digest - Digest cryptography
• Store - Key-value store
• Base64 - Base64 encoding/decoding
• Location - Location management and (reverse) geocoding
• Task - Lightweight tasks scheduler

Usage

Currently, Flow is still under development. It will be released as a gem once we reach a stable version. In the meantime, it has to be used locally.

Make sure to build the extensions before requiring it.

$ rake build

You can then build a .gem file that you can manually install.

$ rake gem

Projects

Flow projects

Flow comes with its own RubyMotion template, which creates a hybrid (iOS + Android + OS X) project.

$ motion create --template=flow Hello
$ cd Hello
$ rake -T

RubyMotion projects

Flow can be added as a dependency of an existing iOS, Android or OS X RubyMotion project, by adding the motion-flow gem in the project's Gemfile.

Code organization

Each Flow library is contained in subdirectories inside the flow directory. Platform-specific code is contained inside subdirectories of each library (E.g. cocoa and android).