motion-splash 1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a96fcb3e6d8704765c0db3f4c3925b4bc87cf234
+  data.tar.gz: e0778229ce1b9c25a065aa9b6c101dc21293fe9b
+SHA512:
+  metadata.gz: ecd1081838f66d5c62991ed384f15ebf28a88bbf5cb75d580852682565168368402d110101005b7a6ce51a243cf432e54d9590775b1c7b6898b09d949932e84d
+  data.tar.gz: 6e87e52fca3f9b0356d53d9150ceefaec24e869e85bc7d733ccaaa755fe984ab2be37f3efdf9bf2b55ae471e6807bd49aa28dc0d1709e6ca24e06e0d8c1ae65b

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+spec_app/build/*
+.DS_Store

data/Gemfile

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

data/README.md

@@ -0,0 +1,75 @@
+# Motion-Splash
+
+Create all your splash images from any UIViewController using whatever method you like to style it.
+
+With Xcode 6 and iOS 8 came the ability to create your launch images from a XIB or storyboard file. This is a huge gain over manually creating every image in all the available resolutions.
+
+But as a RubyMotion developer, I try to stay away as much as possible from the Xcode environment... I present you `Motion-Splash`
+
+#Installation
+```
+gem install motion-splash
+
+# or in Gemfile
+gem 'motion-splash'
+```
+
+#How to use it
+Require `motion-splash` in your Rakefile and add `MotionSplash.setup(app)` in your project setup block.
+
+This will add the `rake splash` task to your project.
+When running the task, the app will instantiate your `UIViewController` for every configured resolution/scale, present it over its own `UIWindow` and take a screenshot when you tell it to.
+
+The only requirement is that your `UIViewController` instance responds to `#splash_generator=` and that you call `#take_snapshot` on the generator object whenever the controller's view is ready. Calling this method will save a snapshot to disk and continue with the next available resolution or exit if finished.
+
+```ruby
+class SplashController < UIViewController
+  attr_writer :splash_generator
+
+  def loadView
+    @layout = SplashLayout.new
+    self.view = @layout.view
+  end
+
+  def viewDidAppear(animated)
+    super
+    @splash_generator.take_snapshot
+  end
+end
+```
+
+**NOTE: the view controller's view frame is being manually adjusted after it has been created, so be sure to adjust the subviews' frames either by using AutoLayout or manually changing their frames in `viewWillLayoutSubviews`**
+
+#Configuration
+You can configure `MotionSplash` passing a block to `MotionSplash.setup`
+```ruby
+MotionSplash.setup(app) do |c|
+  c.controller_class = "MyCustomSplashController"
+  c.exclude_scales = [1, 3]
+end
+```
+
+Avaiable options are:
+* **controller_class**: Your splash controller class name (String). Defaults to "SplashController"
+* **images_dir**: Absolute path to the directory where images should be saved. Defaults to the app's resources dir
+* **image_name**: Launch image name. Defaults to "Default"
+* **app_delegate_file**: Absolute path to the app's app_delegate file. Defaults to `app/app_delegate.rb`
+* **sizes**: An array of all the needed sizes. Format of each entry must be [size, scale]. Defaults to `[[[320, 480], 1], [[320, 480], 2], [[320, 568], 2], [[375, 667], 2], [[414, 736], 3]]`
+* **exclude_scales**: Array of scales that are not needed. Defaults to an empty array.
+* **exclude_sizes**: Array of sizes that are not needed (ie [320, 480]). Defaults to an empty array.
+* **custom_sizes**: Array with custom sizes. Format of each entry must be [size, scale]. Defaults to empty array.
+
+#Samples
+Check out the two sample apps:
+
+* On the first one we create splash images using MotionKit and AutoLayout
+* On the second one, we use an `UINavigationController` styled through the app's `UIAppearence`.
+
+![Sample 1](https://raw.github.com/ijpiantanida/motion-splash/master/samples/sample-1/resources/Default.png)
+![Sample 2](https://raw.github.com/ijpiantanida/motion-splash/master/samples/sample-2/resources/Default.png)
+
+#How does it work?
+When running the `rake splash` task, your `AppDelegate#application:didFinishLaunchingWithOptions:` will be overwritten with a custom implementation. 
+
+For every enabled size, a `UIWindow` is created with the appropiate frame size and setted as keyAndVisible. After your view controller is presented, you should call `#take_snapshot` (usually within `#viewDidAppear`) and an image will be created drawing the `UIWindow` with `#drawViewHierarchyInRect`. Using `UIWindow` allows us to make crazy thinks like using `UIVisualEffectView`
+

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/motion-splash.rb

@@ -0,0 +1,37 @@
+require 'motion-splash/config.rb'
+
+class MotionSplash
+  def self.generate!
+    @should_generate = true
+  end
+
+  def self.should_generate?
+    @should_generate
+  end
+
+  def self.setup(app)
+    config = Config.new(app)
+    yield(config) if block_given?
+    config.finish
+
+    splash_delegate = File.join(File.dirname(__FILE__), 'motion-splash/splash_app_delegate.rb')
+
+    if MotionSplash.should_generate?
+      app.files << File.join(File.dirname(__FILE__), 'motion-splash/generator.rb')
+      app.files << File.join(File.dirname(__FILE__), 'motion-splash/config.rb')
+      app.files << splash_delegate
+
+      system("touch \"#{splash_delegate}\"")
+    else
+      if File.mtime(splash_delegate) >= File.mtime(config.app_delegate_file)
+        system("touch \"#{config.app_delegate_file}\"")
+      end
+    end
+  end
+end
+
+desc "Creates splash images"
+task 'splash' do
+  MotionSplash.generate!
+  Rake::Task["simulator"].invoke
+end

data/lib/motion-splash/config.rb

@@ -0,0 +1,53 @@
+class MotionSplash
+  class Config
+    def initialize(app = nil)
+      @app = app
+      @properties_set = []
+    end
+
+    def info_plist
+      @info_plist ||= begin
+        if @app
+          @app.info_plist
+        else
+          NSBundle.mainBundle.infoDictionary
+        end
+      rescue
+        {}
+      end
+    end
+
+    PROPERTIES = {
+        controller_class: "SplashController",
+        images_dir: File.join(Dir.pwd,"resources"),
+        app_delegate_file: File.join(Dir.pwd, "app", "app_delegate.rb"),
+        sizes: [[[320, 480], 1], [[320, 480], 2], [[320, 568], 2], [[375, 667], 2], [[414, 736], 3]],
+        image_name: "Default",
+        exclude_scales: [],
+        exclude_sizes: [],
+        custom_sizes: []
+    }
+
+    def prefix
+      "_splash_"
+    end
+
+    PROPERTIES.keys.each do |property|
+      define_method("#{property}=") do |value|
+        info_plist["#{prefix}#{property}"] = value
+        @properties_set << property
+      end
+
+      define_method(property) do
+        info_plist["#{prefix}#{property}"]
+      end
+    end
+
+    def finish
+      (PROPERTIES.keys - @properties_set.dup).each do |property|
+        default_value = PROPERTIES[property]
+        info_plist["#{prefix}#{property}"] = default_value
+      end
+    end
+  end
+end

data/lib/motion-splash/generator.rb

@@ -0,0 +1,77 @@
+class MotionSplash
+  class Generator
+    def self.generate_snapshots
+      self.new.start
+    end
+    
+    def initialize
+      @config = Config.new
+      @current_index = 0
+    end
+    
+    def start
+      setup_next_size
+    end
+
+    def setup_next_size
+      exit if @current_index >= enabled_sizes.size
+      size, scale = enabled_sizes[@current_index]
+      setup_for(size, scale)
+    end
+
+    def setup_for(size, scale)
+      puts "Generating image for #{size}@#{scale}x"
+      controller_class = Kernel.const_get(@config.controller_class)
+      splash_controller = controller_class.alloc.initWithNibName(nil, bundle: nil)
+      splash_controller.splash_generator = self
+
+      @window = UIWindow.alloc.initWithFrame([[0,0], size])
+      @window.rootViewController = splash_controller
+      @window.makeKeyAndVisible
+      splash_controller.view.frame = [[0, 0], size]
+    end
+
+    def take_snapshot
+      size, scale = enabled_sizes[@current_index]
+      image = create_image_for(scale, @window)
+      save_image(image, scale, size)
+      @current_index += 1
+      setup_next_size
+    end
+
+    def save_image(img, scale, size)
+      fileManager = NSFileManager.defaultManager
+      image_data = UIImagePNGRepresentation(img)
+      image_name = name_for(scale, size)
+      image_name = "#{@config.images_dir}/#{image_name}.png"
+      fileManager.createFileAtPath(image_name, contents: image_data, attributes: nil)
+    end
+
+    def create_image_for(scale, view)
+      UIGraphicsBeginImageContextWithOptions(view.bounds.size, true, scale)
+      view.drawViewHierarchyInRect(view.bounds, afterScreenUpdates: true)
+      img = UIGraphicsGetImageFromCurrentImageContext()
+      UIGraphicsEndImageContext()
+      img
+    end
+
+    def enabled_sizes
+      @enabled_sizes ||= @config.sizes.reject do |size, scale|
+        @config.exclude_sizes.include?(size) ||
+            @config.exclude_scales.include?(scale)
+      end + @config.custom_sizes
+    end
+
+    def name_for(scale, size)
+      case scale.to_i
+        when 2
+          size_suffix = size.last == 480 ? "" : "-#{size.last.to_i}h"
+          "#{@config.image_name}#{size_suffix}@2x"
+        when 3
+          "#{@config.image_name}-#{size.last.to_i}h@3x"
+        else
+          @config.image_name
+      end
+    end
+  end
+end

data/lib/motion-splash/splash_app_delegate.rb

@@ -0,0 +1,6 @@
+class AppDelegate
+  def application(application, didFinishLaunchingWithOptions:launchOptions)
+    MotionSplash::Generator.generate_snapshots
+    true
+  end
+end

data/motion-splash.gemspec

@@ -0,0 +1,22 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+Gem::Specification.new do |spec|
+  spec.name          = "motion-splash"
+  spec.version       = "1.0"
+  spec.authors       = ["Ignacio Piantanida"]
+  spec.email         = ["ijpiantanida@gmail.com"]
+  spec.description   = "Create all your splash images from any UIViewController using whatever method you like to style it.\nWith Xcode 6 and iOS 8 came the ability to create your launch images from a XIB or storyboard file. This is a huge gain over manually creating every image in all the available resolutions.\nBut as a RubyMotion developer, I try to stay away as much as possible from the Xcode environment... I present you Motion-Splash"
+  spec.summary       = "Create all your splash images from any UIViewController using whatever method you like to style it"
+  spec.homepage      = "https://github.com/ijpiantanida/motion-splash"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+end

data/samples/sample-1/.gitignore

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

data/samples/sample-1/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+gem 'rake'
+# Add your dependencies here:
+gem 'motion-splash', :path => "../../"
+gem 'motion-kit'

data/samples/sample-1/Rakefile

@@ -0,0 +1,19 @@
+# -*- coding: utf-8 -*-
+$:.unshift("/Library/RubyMotion/lib")
+require 'motion/project/template/ios'
+
+begin
+  require 'motion-splash'
+  require 'bundler'
+  Bundler.require
+rescue LoadError
+end
+
+Motion::Project::App.setup do |app|
+  # Use `rake config' to see complete project settings.
+  app.name = 'sample-1'
+
+  MotionSplash.setup(app) do |c|
+    #c.exclude_scales = [1]
+  end
+end

data/samples/sample-1/app/app_delegate.rb

@@ -0,0 +1,8 @@
+class AppDelegate
+  def application(application, didFinishLaunchingWithOptions:launchOptions)
+    @window = UIWindow.alloc.initWithFrame(UIScreen.mainScreen.bounds)
+    @window.rootViewController = NormalViewController.alloc.init
+    @window.makeKeyAndVisible
+    true
+  end
+end

data/samples/sample-1/app/layouts/splash_layout.rb

@@ -0,0 +1,63 @@
+class SplashLayout < MK::Layout
+  def layout
+    root :splash do
+      add UILabel, :title
+      add UIView, :center_box do
+        add UIImageView, :icon
+      end
+      add UIView, :bottom_box
+      add UIVisualEffectView, :blurry_box
+    end
+  end
+
+  def splash_style
+    background_color UIColor.greenColor
+  end
+
+  def title_style
+    text 'Awesome App'
+    font UIFont.preferredFontForTextStyle(UIFontTextStyleHeadline)
+    constraints do
+      top.equals(30)
+      center_x.equals(:superview)
+    end
+  end
+
+  def center_box_style
+    background_color UIColor.redColor
+    constraints do
+      center.equals(:superview)
+      width.equals(:superview).times(0.9)
+      height.equals(:superview, :width).times(0.9)
+    end
+  end
+
+  def icon_style
+    image UIImage.imageNamed("motionkit_logo")
+    constraints do
+      center.equals(:superview)
+      size.is <= :superview
+      height(:scale)
+    end
+  end
+
+  def bottom_box_style
+    background_color UIColor.blueColor
+    constraints do
+      center_x.equals(:superview)
+      width.equals(:center_box)
+      height.equals(40)
+      bottom.equals(:superview).minus(15)
+    end
+  end
+
+  def blurry_box_style
+    effect UIBlurEffect.effectWithStyle(UIBlurEffectStyleLight)
+    constraints do
+      center_x.equals(:bottom_box)
+      width.equals(:superview)
+      height.equals(:bottom_box).plus(60)
+      bottom.equals(:superview)
+    end
+  end
+end

data/samples/sample-1/app/normal_view_controller.rb

@@ -0,0 +1,6 @@
+class NormalViewController < UIViewController
+  def viewDidLoad
+    super
+    self.view.backgroundColor = UIColor.redColor
+  end
+end

data/samples/sample-1/app/splash_view_controller.rb

@@ -0,0 +1,13 @@
+class SplashController < UIViewController
+  attr_writer :splash_generator
+
+  def loadView
+    @layout = SplashLayout.new
+    self.view = @layout.view
+  end
+
+  def viewDidAppear(animated)
+    super
+    @splash_generator.take_snapshot
+  end
+end

data/samples/sample-1/spec/main_spec.rb

@@ -0,0 +1,9 @@
+describe "Application 'sample-1'" do
+  before do
+    @app = UIApplication.sharedApplication
+  end
+
+  it "has one window" do
+    @app.windows.size.should == 1
+  end
+end

data/samples/sample-2/.gitignore

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

data/samples/sample-2/Gemfile

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+
+gem 'rake'
+# Add your dependencies here:
+gem 'motion-splash', :path => "../../"

data/samples/sample-2/Rakefile

@@ -0,0 +1,20 @@
+# -*- coding: utf-8 -*-
+$:.unshift("/Library/RubyMotion/lib")
+require 'motion/project/template/ios'
+
+begin
+  require 'motion-splash'
+  require 'bundler'
+  Bundler.require
+rescue LoadError
+end
+
+Motion::Project::App.setup do |app|
+  # Use `rake config' to see complete project settings.
+  app.name = 'sample-2'
+
+  MotionSplash.setup(app) do |c|
+    c.controller_class = "CustomSplashViewController"
+    c.custom_sizes = [[[667, 375], 2]]
+  end
+end

data/samples/sample-2/app/app_delegate.rb

@@ -0,0 +1,8 @@
+class AppDelegate
+  def application(application, didFinishLaunchingWithOptions:launchOptions)
+    @window = UIWindow.alloc.initWithFrame(UIScreen.mainScreen.bounds)
+    @window.rootViewController = NormalViewController.alloc.init
+    @window.makeKeyAndVisible
+    true
+  end
+end

data/samples/sample-2/app/normal_view_controller.rb

@@ -0,0 +1,6 @@
+class NormalViewController < UIViewController
+  def viewDidLoad
+    super
+    self.view.backgroundColor = UIColor.redColor
+  end
+end

data/samples/sample-2/app/splash_view_controller.rb

@@ -0,0 +1,25 @@
+class CustomSplashViewController < UINavigationController
+  attr_writer :splash_generator
+
+  def viewDidLoad
+    super
+    UINavigationBar.appearance.barTintColor = UIColor.colorWithRed(0.28, green: 0.46, blue: 0.61, alpha: 1)
+
+    controller = SplashController.alloc.init
+    controller.splash_generator = @splash_generator
+    self.setViewControllers([controller], animated: false)
+  end
+end
+
+class SplashController < UIViewController
+  attr_accessor :splash_generator
+
+  def viewDidLoad
+    self.view.backgroundColor = UIColor.whiteColor
+  end
+
+  def viewDidAppear(animated)
+    super
+    @splash_generator.take_snapshot
+  end
+end

data/samples/sample-2/spec/main_spec.rb

@@ -0,0 +1,9 @@
+describe "Application 'sample-1'" do
+  before do
+    @app = UIApplication.sharedApplication
+  end
+
+  it "has one window" do
+    @app.windows.size.should == 1
+  end
+end

metadata

@@ -0,0 +1,112 @@
+--- !ruby/object:Gem::Specification
+name: motion-splash
+version: !ruby/object:Gem::Version
+  version: '1.0'
+platform: ruby
+authors:
+- Ignacio Piantanida
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-09-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: |-
+  Create all your splash images from any UIViewController using whatever method you like to style it.
+  With Xcode 6 and iOS 8 came the ability to create your launch images from a XIB or storyboard file. This is a huge gain over manually creating every image in all the available resolutions.
+  But as a RubyMotion developer, I try to stay away as much as possible from the Xcode environment... I present you Motion-Splash
+email:
+- ijpiantanida@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.md
+- Rakefile
+- lib/motion-splash.rb
+- lib/motion-splash/config.rb
+- lib/motion-splash/generator.rb
+- lib/motion-splash/splash_app_delegate.rb
+- motion-splash.gemspec
+- samples/sample-1/.gitignore
+- samples/sample-1/Gemfile
+- samples/sample-1/Rakefile
+- samples/sample-1/app/app_delegate.rb
+- samples/sample-1/app/layouts/splash_layout.rb
+- samples/sample-1/app/normal_view_controller.rb
+- samples/sample-1/app/splash_view_controller.rb
+- samples/sample-1/resources/Default-568h@2x.png
+- samples/sample-1/resources/Default-667h@2x.png
+- samples/sample-1/resources/Default-736h@3x.png
+- samples/sample-1/resources/Default.png
+- samples/sample-1/resources/Default@2x.png
+- samples/sample-1/resources/motionkit_logo.png
+- samples/sample-1/spec/main_spec.rb
+- samples/sample-2/.gitignore
+- samples/sample-2/Gemfile
+- samples/sample-2/Rakefile
+- samples/sample-2/app/app_delegate.rb
+- samples/sample-2/app/normal_view_controller.rb
+- samples/sample-2/app/splash_view_controller.rb
+- samples/sample-2/resources/Default-375h@2x.png
+- samples/sample-2/resources/Default-568h@2x.png
+- samples/sample-2/resources/Default-667h@2x.png
+- samples/sample-2/resources/Default-736h@3x.png
+- samples/sample-2/resources/Default.png
+- samples/sample-2/resources/Default@2x.png
+- samples/sample-2/spec/main_spec.rb
+homepage: https://github.com/ijpiantanida/motion-splash
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.1.5
+signing_key: 
+specification_version: 4
+summary: Create all your splash images from any UIViewController using whatever method
+  you like to style it
+test_files: []