motion-launchimages 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2a011eb95f543bac37beccf3bf70cf10c5668df0
+  data.tar.gz: efabfc1d2b75fd98d9535021240052d2cd89ca24
+SHA512:
+  metadata.gz: f571a451be42262a1bb6319095b20d958fab480965caa97fa41e909be84780d1f1573e3acb234cfe9fe0d5f4f14d6adf9c5b02db02bc0ab4743cb0ea7c3e3f4a
+  data.tar.gz: dbc5e4804244f82e52afad693b8a738d67d363c4bd878fcd79a65590feca913b155de8befc2ea12eacd6bd84d4550274192e46c9760c53eab7bdd7d14dddaabf

data/README.md

@@ -0,0 +1,52 @@
+# motion-launchimages
+
+Automate taking your iPhone and/or iPad launch images (i.e. `Default-568h@2x.png`) with `rake launchimages`.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'motion-launchimages'
+
+And then execute:
+
+    bundle
+
+## Usage
+
+After your app has launched, let motion-launchimages know to take the screenshots:
+
+```ruby
+class AppDelegate
+
+  def application(application, didFinishLaunchingWithOptions:launchOptions)
+    # ...
+
+    Motion::LaunchImages.take!
+    true
+  end
+end
+```
+
+This method does nothing if it's not taking screenshots, so it's safe to leave in your code.
+
+If you need to do some processing to get your app ready for the screenshot, you can use `Motion::LaunchImages.taking?` to check whether the app is being screenshoted. For example, if you have a table in your main view, you might want to empty it out like this:
+
+```ruby
+class MainViewController
+  def tableView(table, numberOfRowsInSection:section)
+    return 0 if Motion::LaunchImages.taking?
+    # ...
+  end
+end
+```
+
+## Running
+
+Just run `rake launchimages`! The task will launch your app in the simulator several times with different screen sizes and save the screenshots in your resources directory with the correct names. It detects whether it's being run on an iPhone or iPad (or both) app and only takes the screenshots it needs to.
+
+If you want to just take the screenshot at one resolution, you can run `rake take_launchimages=true device_name="iPhone 6 Plus"` (for example). Any of the iPhone or iPad devices should work. You can get a full list of what's available by opening the simulator, going to the `Hardware` menu and looking under `Device`.
+
+## Contact
+
+[Brendan J. Caffrey](http://brendan.jcaffrey.com/)

data/lib/motion-launchimages.rb

@@ -0,0 +1,37 @@
+require 'open3'
+
+unless defined?(Motion::Project::Config)
+  raise 'This file must be required within a RubyMotion project Rakefile.'
+end
+
+Motion::Project::App.setup do |app|
+  Dir.glob(File.join(File.dirname(__FILE__), 'motion/*.rb')).each do |file|
+    app.files.unshift(file)
+
+    if ENV.has_key?('take_launchimages')
+      app.info_plist['screenshot_path'] = Dir.pwd + '/resources/'
+    end
+  end
+end
+
+desc 'Take launch images of your app at all display resolutions'
+task :launchimages do
+  devices = []
+  family = Motion::Project::App.config.device_family
+  family = [family] if family.is_a?(Symbol)
+
+  if family.index(:iphone) != nil
+    devices << 'iPhone 4s' << 'iPhone 5s' << 'iPhone 6' << 'iPhone 6 Plus'
+  end
+
+  if family.index(:ipad) != nil
+    devices << 'iPad 2' << 'iPad Air'
+  end
+
+  devices.each do |device|
+    puts "Taking screenshot on #{device}"
+    Open3.popen3({'take_launchimages' => 'true', 'device_name' => device}, 'rake') do |i, o, e, s|
+      o.read
+    end
+  end
+end

data/lib/motion/launch_images.rb

@@ -0,0 +1,125 @@
+module Motion
+  class LaunchImages
+    def self.screenshot_path
+      NSBundle.mainBundle.objectForInfoDictionaryKey('screenshot_path')
+    end
+
+    def self.taking?
+      screenshot_path != nil
+    end
+
+    def self.take!(orientation = :portrait)
+      return unless taking?
+
+      Dispatch::Queue.main.async do
+        if needs_rotation?(orientation)
+          rotate(orientation)
+          sleep 1.0
+        end
+
+        Dispatch::Queue.main.async { capture! }
+      end
+    end
+
+    def self.capture!
+      screen = UIScreen.mainScreen
+      height = screen.bounds.size.height
+      scale = begin
+        if !screen.respondsToSelector('displayLinkWithTarget:selector:')
+          ''
+        elsif screen.scale == 1.0
+          ''
+        elsif screen.scale == 2.0
+          '@2x'
+        elsif screen.scale == 3.0
+          '@3x'
+        else
+          puts 'Error: Unable to determine screen scale'
+          exit
+        end
+      end
+      filename = generate_filename(height, scale)
+
+      if scale != ''
+        UIGraphicsBeginImageContextWithOptions(window.bounds.size, false, screen.scale)
+      else
+        UIGraphicsBeginImageContext(window.bounds.size)
+      end
+
+      window.layer.renderInContext(UIGraphicsGetCurrentContext())
+      image = UIGraphicsGetImageFromCurrentImageContext()
+      UIGraphicsEndImageContext()
+      data = UIImagePNGRepresentation(image)
+      data.writeToFile(filename, atomically:true)
+      puts "Wrote to #{filename}"
+
+      if should_rotate_and_take_again?(height)
+        take!(:landscape)
+      else
+        exit
+      end
+    end
+
+    def self.generate_filename(height, scale)
+      filename = screenshot_path + 'Default'
+
+      case height
+      when 480 # iPhone 4s
+      when 568 # iPhone 5s
+        filename << '-568h'
+      when 667 # iPhone 6
+        filename << '-667h'
+      when 736 # iPhone 6 Plus
+        filename << '-736h'
+      when 768 # iPad (Landscape)
+        filename << '-Landscape'
+      when 1024 # iPad (Portrait)
+        filename << '-Portrait'
+      else
+        puts "Error: Invalid screen height #{height}"
+        exit
+      end
+
+      filename << scale << '.png'
+    end
+
+    # ported from BubbleWrap to reduce dependencies
+    def self.window
+      normal_windows = UIApplication.sharedApplication.windows.select { |w|
+        w.windowLevel == UIWindowLevelNormal
+      }
+
+      key_window = normal_windows.select { |w|
+        w == UIApplication.sharedApplication.keyWindow
+      }.first
+
+      key_window || normal_windows.first
+    end
+
+    def self.should_rotate_and_take_again?(height)
+      height == 1024 # iPad (Portrait)
+    end
+
+    def self.rotate(to)
+      if to == :portrait
+        value = NSNumber.numberWithInt(UIInterfaceOrientationPortrait)
+      else
+        value = NSNumber.numberWithInt(UIInterfaceOrientationLandscapeLeft)
+      end
+
+      UIDevice.currentDevice.setValue(value, forKey:'orientation')
+    end
+
+    def self.needs_rotation?(orientation)
+      status = UIApplication.sharedApplication.statusBarOrientation
+      if orientation == :portrait && status == UIInterfaceOrientationPortrait
+        false
+      elsif orientation == :landscape && (status == UIInterfaceOrientationLandscapeLeft ||
+                                          status == UIInterfaceOrientationLandscapeRight)
+        false
+      else
+        true
+      end
+    end
+  end
+end

data/motion-launchimages.gemspec

@@ -0,0 +1,16 @@
+Gem::Specification.new do |s|
+  s.name        = 'motion-launchimages'
+  s.version     = '1.0.0'
+  s.summary     = 'Automate RubyMotion launch images'
+  s.description = 'Automate RubyMotion launch images'
+  s.homepage    = 'https://github.com/brendanjcaffrey/motion-launchimages'
+  s.authors     = ['Brendan J. Caffrey']
+  s.email       = ['brendan@jcaffrey.com']
+  s.license     = 'MIT'
+
+  files = ['README.md', 'motion-launchimages.gemspec']
+  files.concat(Dir.glob('lib/**/*.rb'))
+  s.files         = files
+  s.require_paths = ['lib']
+  s.add_development_dependency 'rake'
+end

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification
+name: motion-launchimages
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Brendan J. Caffrey
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-03-15 00:00:00.000000000 Z
+dependencies:
+- !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: Automate RubyMotion launch images
+email:
+- brendan@jcaffrey.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/motion-launchimages.rb
+- lib/motion/launch_images.rb
+- motion-launchimages.gemspec
+homepage: https://github.com/brendanjcaffrey/motion-launchimages
+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.4.5
+signing_key: 
+specification_version: 4
+summary: Automate RubyMotion launch images
+test_files: []