motion-hybrid 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 64d08d319ac85d30d54245b42d93a0e0ea25341e
+  data.tar.gz: 9dd02ccbb10a99e80fd98f22d6aca8262e54ee51
+SHA512:
+  metadata.gz: 366a07d182912214a43f2a3013aa599f8ceaf78324a68bc4f3d644845cdeee49bcddb3a646632cbce1dba66a4b53b76815ad87dcf0b041b2754e53acafc4ed08
+  data.tar.gz: a1ca81a7731b41e6a4c32fefbe591c352d20b51c884673f694d7c5d6c769219f641a153475688c6ee7edea11305fcba2cc9330636d30584e9deb0971a020995a

data/.gitignore

@@ -0,0 +1,20 @@
+.repl_history
+build
+tags
+app/pixate_code.rb
+resources/*.nib
+resources/*.momd
+resources/*.storyboardc
+resources/Settings.bundle/
+.DS_Store
+nbproject
+.redcar
+#*#
+*~
+*.sw[po]
+.eprj
+.sass-cache
+.bundle
+.idea
+vendor/Pods
+vendor/**/build-*

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in motion-hybrid.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,76 @@
+PATH
+  remote: .
+  specs:
+    motion-hybrid (0.0.1)
+      ProMotion
+      bubble-wrap
+      dish
+      motion-cocoapods
+      motion-require
+      motion-support
+      sugarcube
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ProMotion (1.2.0)
+      methadone (~> 1.3)
+      motion-require (~> 0.2)
+    activesupport (3.2.17)
+      i18n (~> 0.6, >= 0.6.4)
+      multi_json (~> 1.0)
+    bubble-wrap (1.5.0)
+    claide (0.4.0)
+    cocoapods (0.29.0)
+      activesupport (>= 3.2.15, < 4)
+      claide (~> 0.4.0)
+      cocoapods-core (= 0.29.0)
+      cocoapods-downloader (~> 0.3.0)
+      cocoapods-try-release-fix (~> 0.1.1)
+      colored (~> 1.2)
+      escape (~> 0.0.4)
+      json_pure (~> 1.8)
+      nap (~> 0.5)
+      open4 (~> 1.3)
+      xcodeproj (~> 0.14.1)
+    cocoapods-core (0.29.0)
+      activesupport (>= 3.2.15, < 4)
+      fuzzy_match (~> 2.0.4)
+      json_pure (~> 1.8)
+      nap (~> 0.5)
+    cocoapods-downloader (0.3.0)
+    cocoapods-try-release-fix (0.1.2)
+    colored (1.2)
+    dish (0.0.3)
+    escape (0.0.4)
+    fuzzy_match (2.0.4)
+    i18n (0.6.9)
+    json_pure (1.8.1)
+    methadone (1.3.2)
+      bundler
+    motion-cocoapods (1.4.0)
+      cocoapods (>= 0.26.2)
+    motion-redgreen (0.1.0)
+    motion-require (0.2.0)
+    motion-support (0.2.6)
+      motion-require (>= 0.0.6)
+    multi_json (1.9.2)
+    nap (0.6.0)
+    open4 (1.3.3)
+    rake (10.1.1)
+    sugarcube (1.5.5)
+    webstub (1.0.1)
+    xcodeproj (0.14.1)
+      activesupport (~> 3.0)
+      colored (~> 1.2)
+      rake
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.5)
+  motion-hybrid!
+  motion-redgreen
+  rake
+  webstub

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Jens Balvig
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,115 @@
+# motion-hybrid
+
+motion-hybrid takes your existing web app and views and wraps them in a snappy native iOS interface
+
+## Installation
+
+
+Add to your rubymotion project's Gemfile:
+
+```ruby
+  gem 'motion-hybrid'
+```
+
+Run bundle and install required cocoapods:
+
+```bash
+$ bundle
+$ rake pod:install
+```
+
+## Basic Usage
+
+Create a screen that inherits from `MotionHybrid::Screen` and set the base url of your web app:
+
+```ruby
+# app/screens/base_screen.rb
+class BaseScreen < MotionHybrid::Screen
+  self.root_url = 'http://github.com'
+end
+```
+
+Create one or more screens and set their paths:
+
+```ruby
+# app/app_delegate.rb
+class AppDelegate < PM::Delegate
+  def on_load(app, options)
+    BaseScreen.sync_sessions do
+      @screen_1 = BaseScreen.new(nav_bar: true, path: '/balvig', tab_bar: { title: 'Balvig', icon: :users })
+      @screen_2 = BaseScreen.new(nav_bar: true, path: '/rubymotion', tab-bar: { title: 'Rubymotion', icon: :gear })
+      open_tab_bar @screen_1, @screen_2
+    end
+  end
+end
+```
+
+### Navigation
+
+By default, all GET-links are pushed onto the navigation controller stack.
+
+```html
+<!-- index.html -->
+<a href='index_2.html'>Page 2</a>
+
+<!-- index_2.html -->
+<p>This is page 2</p>
+```
+
+<img src='https://dl.dropboxusercontent.com/u/3032793/screenshots/get.gif' width='200px' />
+
+### Modals
+
+Links with anchor `#modal` will be opened in a modal window.
+Links _within_ a modal linking to the url of the page that created it will automatically close the modal.
+
+```html
+<!-- index.html -->
+<a href='modal.html#modal'>Page 2</a>
+
+<!-- modal.html -->
+<a href='index.html'>This will close the modal</a>
+```
+
+<img src='https://dl.dropboxusercontent.com/u/3032793/screenshots/modal.gif' width='200px' />
+
+### Inline
+
+Links with anchor `#self` will open the new url within the current view without pushing a new view on to the stack:
+
+### Non-GET requests
+
+Any non-GET requests (form posts etc) will display the result within the current view and also automatically refresh all other views so that pages are up to date.
+
+## The Bridge
+
+The bridge is a small javascript connection between the web app and native app that allows you to use HTML in your web page to control pars of the native app.
+
+All markup is contained within a div with id `motion-hybrid-bridge`
+
+### Title/subtitles
+
+```html
+<div id='motion-hybrid-bridge'>
+  <h1>This is the title</h1>
+  <h2>This is a subtitle</h2>
+</div>
+```
+
+### Alerts
+
+```html
+<div id='motion-hybrid-bridge'>
+  <div class='flash'>
+    <h3>Congratulations!</h3>
+    <p>You completed level 2</p>
+  </div>
+</div>
+```
+
+### Navbar items
+
+
+## Custom routes
+
+TODO: Write usage instructions here

data/Rakefile

@@ -0,0 +1,11 @@
+$:.unshift("/Library/RubyMotion/lib")
+require 'motion/project/template/ios'
+require 'motion-hybrid'
+require 'bundler'
+Bundler.require(:development)
+
+
+Motion::Project::App.setup do |app|
+  app.name = 'motion-hybrid test'
+  app.version = '1.0'
+end

data/app/app_delegate.rb

@@ -0,0 +1,11 @@
+class AppDelegate < PM::Delegate
+  def on_load(app, options)
+    return true if App.environment == 'test'
+
+    BaseScreen.sync_sessions do
+      @screen_1 = BaseScreen.new(nav_bar: true, path: '/index.html', tab_bar: { title: 'Welcome', icon: :users })
+      @screen_2 = BaseScreen.new(nav_bar: true, path: '/refreshable.html', tab_bar: { title: 'Refreshable', icon: :cog })
+      open_tab_bar @screen_1, @screen_2
+    end
+  end
+end

data/app/screens/base_screen.rb

@@ -0,0 +1,3 @@
+class BaseScreen < MotionHybrid::Screen
+  self.root_url = NSURL.fileURLWithPath(NSBundle.mainBundle.resourcePath + '/web').to_s
+end

data/lib/motion-hybrid.rb

@@ -0,0 +1,20 @@
+require 'bubble-wrap'
+require 'dish/motion'
+require 'motion-cocoapods'
+require 'motion-require'
+require 'motion-support'
+require 'ProMotion'
+require 'sugarcube-classic'
+
+
+Motion::Require.all(Dir.glob(File.expand_path('../motion-hybrid/**/*.rb', __FILE__)))
+
+Motion::Project::App.setup do |app|
+  app.resources_dirs << File.join(File.dirname(__FILE__), 'resources')
+  app.pods do
+    pod 'CRToast', '<0.0.6'
+    pod 'FontAwesomeKit'
+    pod 'MBProgressHUD'
+    pod 'SpinKit'
+  end
+end

data/lib/motion-hybrid/concerns/basic_routes.rb

@@ -0,0 +1,35 @@
+module MotionHybrid
+  module BasicRoutes
+    extend MotionSupport::Concern
+
+    included do
+
+      # All clicked GET-links are pushed
+      route /.*/ do |request|
+        push(request.url) if request.http_method == 'GET' && request.type == UIWebViewNavigationTypeLinkClicked
+      end
+
+      # Links with anchor #self are rendered in place
+      route '#self' do |request|
+        open_url(request.url_without_anchor)
+      end
+
+      # Hides tab bar
+      route '#hide_tab_bar' do |request|
+        push(request.url_without_anchor, hide_tab_bar: true)
+      end
+
+      # Opens in modal
+      route '#modal' do |request|
+        push(request.url_without_anchor, modal: true, nav_bar: true)
+      end
+
+      # Modals are closed if they encounter the url from which they were spawned from
+      route /.*/ do |request|
+        close_screen if presented_from?(request.url)
+      end
+
+    end
+
+  end
+end

data/lib/motion-hybrid/concerns/bridgeable.rb

@@ -0,0 +1,71 @@
+module MotionHybrid
+  module Bridgeable
+
+    def on_appear
+      super
+      if title_blank? && bridge.present?
+        set_titles
+      else
+        @transition_finished = true
+      end
+      refresher.endRefreshing if refresher #avoids stuck animation
+    end
+
+    private
+
+    def title_blank?
+      title.blank? && navigationItem.titleView.blank?
+    end
+
+    def load_bridge
+      self.bridge = Bridge.new(self)
+    end
+
+    def dom_loaded
+      set_titles if transition_finished?
+      set_buttons
+      set_refresher
+      render_flash
+    end
+
+    def transition_finished?
+      @transition_finished
+    end
+
+    def set_titles
+      if bridge.subtitle.present?
+        self.navigationItem.titleView = MultiLineHeader.new(bridge.title, bridge.subtitle)
+      else
+        self.title = bridge.title
+      end
+    end
+
+    def set_buttons
+      set_nav_bar_left_button nil, system_item: UIBarButtonSystemItemStop, action: 'close_screen' if bridge.nav_bar_left_button.present?
+      set_nav_bar_right_button Icon.new(:cog, 18), action: 'on_nav_bar_right_button_click' if bridge.nav_bar_right_button.present?
+    end
+
+    def on_nav_bar_right_button_click
+      if bridge.nav_bar_right_button.link
+        bridge.click(:nav_bar_right_button)
+      else
+        UIActionSheet.alert nil, buttons: bridge.nav_bar_right_button.options do |pressed, index|
+          bridge.click_child(:nav_bar_right_button, index)
+        end
+      end
+    end
+
+    def set_refresher
+      if bridge.refreshable && !refresher
+        self.refresher = UIRefreshControl.alloc.init
+        refresher.addTarget(self, action: 'reload', forControlEvents: UIControlEventValueChanged)
+        webview.scrollView.addSubview(refresher)
+      end
+    end
+
+    def render_flash
+      Toast.new(bridge.flash.title, bridge.flash.subtitle) if bridge.flash
+    end
+
+  end
+end

data/lib/motion-hybrid/concerns/navigatable.rb

@@ -0,0 +1,137 @@
+module MotionHybrid
+  module Navigatable
+    extend MotionSupport::Concern
+
+    included do
+      class_attribute :root_url, :routes
+      self.routes = []
+    end
+
+    def set_initial_content
+      super if @initial_url
+    end
+
+    def content
+      NSURL.URLWithString(@initial_url)
+    end
+
+    def path=(path)
+      self.url = self.class.url_for(path)
+    end
+
+    def path
+      self.class.path_for(url)
+    end
+
+    def url=(url)
+      @url = url
+      @initial_url ||= url
+      open_url(url) if webview
+    end
+
+    def url
+      @url
+    end
+
+    def load_started
+      start_transitions
+    end
+
+    def load_finished
+      @url = current_url
+      load_bridge
+      reload_dependents if needs_reload?
+      end_transitions
+    end
+
+    def load_failed(error)
+      unless [102, -999].include?(error.code) #http://stackoverflow.com/questions/19487330/failed-to-load-webpage-error-nsurlerrordomain-error-999
+        end_transitions
+        show_error(error)
+      end
+    end
+
+    def close_screen
+      reload_dependents if needs_reload?
+      super
+    end
+
+    def reset!
+      dismissViewControllerAnimated(false, completion: nil)
+      navigation_controller.popToRootViewControllerAnimated(false)
+      load_initial_url
+    end
+
+    def on_request(nsurlrequest, type)
+      process_request Request.new(nsurlrequest, type)
+    end
+
+    def navigate(new_path)
+      return if path == new_path
+      process_request Request.new(self.class.request_for(new_path), UIWebViewNavigationTypeLinkClicked)
+    end
+
+    private
+
+    def process_request(request)
+      return dom_loaded && false if request.url == 'motionhybrid://ready'
+      @needs_reload = true if request.http_method != 'GET'
+
+      if router.process(request)
+        false
+      else
+        PM.logger.info("#{self} #{request.http_method} #{request.url}")
+        true
+      end
+    end
+
+    def push(url, options = {})
+      view_options = options.slice!(:hide_tab_bar)
+      options[:modal] = view_options[:modal]
+      view_options.reverse_merge!(url: url, modal: modal?, transition_style: transition_style)
+      open self.class.new(view_options), options
+    end
+
+    def load_initial_url
+      self.path = self.class.path_for(@initial_url)
+    end
+
+    def transition_style
+      modal? ? UIModalTransitionStyleFlipHorizontal : nil
+    end
+
+    def router
+      @router ||= Router.new(self)
+    end
+
+    def show_error(error)
+      PM.logger.warn error
+      BW::UIAlertView.default(title: 'Could not connect', message: error.localizedDescription, buttons: ['Cancel', 'Try Again']) do |alert|
+        reset! if alert.clicked_button.index > 0
+      end.show
+    end
+
+    module ClassMethods
+
+      def url_for(path)
+        "#{root_url}#{path}"
+      end
+
+      def request_for(path)
+        NSURLRequest.requestWithURL NSURL.URLWithString(url_for(path))
+      end
+
+      def path_for(url)
+        return if url.blank?
+        NSURL.URLWithString(url).path
+      end
+
+      def route(*patterns, &block)
+        patterns.each do |pattern|
+          self.routes = [Route.new(pattern, &block)] + routes
+        end
+      end
+    end
+
+  end
+end