apple_manifest_rails 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,15 @@
 ---
-SHA1:
-  metadata.gz: 697d45b8821e48c937d6c4e0b605c55fce1c5a1a
-  data.tar.gz: 19f2f6e2939b48e17576dd25593c01b1bc666e04
-SHA512:
-  metadata.gz: 069a1471eac1d5f5fad7c17dc44b63f47eaeb9f2575a4ca67cb1af0cad11a42daec32dce6ee6c4dff332d6ba50866d31208145b4b4ccac6c54b041eba4a53027
-  data.tar.gz: 2363631a4ccca248568fafcd7ff189c0c73cf53fa581eb904c78b6f7a2518d88d4632bf72628eace78fa2ea0478e69f259e5cbe55f8fb49dbece0cc63316955e
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ZGMyNGZjOTA5NzBiZmY5NGRiM2FjNDE0ZTFiOGU5MWRkZGFlYzIzYw==
+  data.tar.gz: !binary |-
+    OGMzYzM4M2QwY2FlOThjNmUyOGE5NDFkZDIwMmQ5ZGU3YmY0YzJhNg==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    ZGVmZWQ0ZjEyOTBiN2UyMWM3Y2QzNmI3ZjE4MTA3MTc5N2E1M2Q2MDNjYmM2
+    OTdmNmZmY2RhMTcxOTVhMDEwYmU5NGM0NTUxNjRlZTZhYWZlYjEyNWU4NGM3
+    ZGIwMDJiYjJiY2ZiZmFjN2E5MTM2YTVkYmQ5NWI4MjYxMTk3Mzg=
+  data.tar.gz: !binary |-
+    ODk3OTA2NTNjYTNiYzhiNjQxMDBjNjZjYTliMjM3NGU5NjVhYmEwNzk2ZWZk
+    OWEwZjNlZjE4ZDAyZGEwYWU0YjIwMmFlY2ZmZWM4ZTg1N2Q5ZWZjNGFmNWNj
+    NWUwYWNiYTViZjlkYzQ3NGEyY2VmM2Y3ZTM5MjU5YzliMjVjNGY=

data/README.md

@@ -4,17 +4,53 @@ Mountable Rails engine for capturing iOS UDID, check if IPA is installable, and
 
 Created for a Rails 3.2 app, might work in Rails 4, but I haven't tried. Let me know if it works!
 
+## Configuration
+
+By default, the engine assumes the following directory structure in your rails project:
+
+```
+rails_application/
+  app/
+  config/
+  ...
+  mobile_build/              <------------- config.template_dir
+    builds/
+      app.ipa                <------------- config.ipa_path
+    manifest.plist
+    Profile.mobileconfig
+```
+
+The app.ipa file is the actual compiled binary archive from Xcode. The engine will look at the embedded.mobileprovision to check if the client is installable.
+
+### Important Info
+
+The plist and mobileconfig files are part of the UDID capture and install processes, they are templates that will be modified before being sent to the client. See the `templates` directory for what these files need to look like. Customize them to your liking and make sure they exist where expected.
+
+The engine will not work without these.
+
+### Custom Initializer
+
+Optionally, you can override these defaults by setting up an initializer in your rails app, e.g. `config/initializers/apple_manifest_rails.rb`
+
+```
+AppleManifestRails.configure do |config|
+  config.page_title = "Who needs testflight? I've got apple_manifest_rails!"
+  config.template_dir = Rails.root.join('apple_manifest_rails', 'templates')
+  config.ipa_path = Rails.root.join('apple_manifest_rails', 'binaries', 'my_custom.ipa')
+end
+```
+
 ## Install
 
-1. Add to your rails gemfile
+Step 1: Add to your rails gemfile
 
 ```ruby
 gem 'apple_manifest_rails'
 ```
 
-2. Bundle
+Step 2: `bundle install`
 
-3. Mount the engine in `config/routes.rb`
+Step 3: Mount the engine in `config/routes.rb`
 
 ```ruby
 Example::Application.routes.draw do
@@ -22,26 +58,7 @@ Example::Application.routes.draw do
 end
 ```
 
-4. Start your server and navigate your iOS Safari browser to `/enroll`
-
-## Configure
-
-The engine assumes the following directory structure in your rails project
-```
-rails_application/
-  app/
-  config/
-  ...
-  mobile_build/
-    builds/
-      app.ipa
-    manifest.plist
-    Profile.mobileconfig
-```
-
-The plist and mobileconfig files are part of the UDID capture and install processes, they are templates that will be modified before being sent to the client. See the `templates` directory for what these files need to look like. Customize them to your liking.
-
-The app.ipa file is the actual compiled binary archive from Xcode. The engine will look at the embedded.mobileprovision to check if the client is installable.
+Step 4: Start your `rails server` and navigate iOS Safari to `/enroll` or `/install` (aliased)
 
 ## Contributing
 

data/app/controllers/apple_manifest_rails/manifest_controller.rb

@@ -8,13 +8,13 @@ module AppleManifestRails
     end
 
     def mobileconfig
-      enroll = AppleManifest::Enroll::MobileConfig.new(request)
+      enroll = AppleManifestRails::Enroll::MobileConfig.new(request)
       enroll.write_mobileconfig
       send_file enroll.outfile_path, type: enroll.mime_type
     end
 
     def extract_udid
-      parser = AppleManifest::Enroll::ResponseParser.new(request)
+      parser = AppleManifestRails::Enroll::ResponseParser.new(request)
       udid = parser.get 'UDID'
       version = parser.get 'VERSION'
       product = parser.get 'PRODUCT'
@@ -25,8 +25,8 @@ module AppleManifestRails
     # Check install
     def check_install
       @udid = params[:udid]
-      @checker = AppleManifest::Install::Checker.new(@udid, 'app.ipa')
-      set_itms_url if @checker.installable?
+      @checker = AppleManifestRails::Install::Checker.new
+      set_itms_url if @checker.installable?(@udid)
     end
 
     # Install (Send IPA)
@@ -36,7 +36,7 @@ module AppleManifestRails
     end
 
     def manifest
-      install = AppleManifest::Install::IPA.new(request)
+      install = AppleManifestRails::Install::IPA.new(request)
       install.write_manifest
       send_file install.manifest_path
     end
@@ -47,12 +47,11 @@ module AppleManifestRails
 
     private
     def ipa_path
-      filename = 'app.ipa'
-      Rails.root.join('mobile_build', 'builds', filename).to_s
+      AppleManifestRails.ipa_path
     end
 
     def set_itms_url
-      @itms_url = AppleManifest::Install::IPA.new(request).itms_uri
+      @itms_url = AppleManifestRails::Install::IPA.new(request).itms_uri
     end
   end
 end

data/app/views/apple_manifest_rails/manifest/check_install.html.haml

@@ -1,4 +1,4 @@
-- if @checker.installable?
+- if @checker.installable?(@udid)
   = javascript_tag "window.location.href = '#{@itms_url}'"
 - else
   Your device is not provisioned and so cannot install.

data/app/views/apple_manifest_rails/manifest/enroll.html.haml

@@ -1,7 +1,7 @@
 - if @ios_device
   #device
     #header
-      %h1#title Enroll Device
+      %h1#title Enroll Device / Install App
     #content
       %ol.instructions
         %li Tap Start to begin process

data/app/views/layouts/apple_manifest_rails/application.html.erb

@@ -1,7 +1,7 @@
 <!DOCTYPE html>
 <html>
 <head>
-  <title>AppleManifestRails</title>
+  <title><%= AppleManifestRails.page_title %></title>
   <%= stylesheet_link_tag    "apple_manifest_rails/application", :media => "all" %>
   <%= javascript_include_tag "apple_manifest_rails/application" %>
   <%= csrf_meta_tags %>

data/config/routes.rb

@@ -3,7 +3,7 @@ AppleManifestRails::Engine.routes.draw do
   get "/enroll/mobileconfig" => "manifest#mobileconfig"
   post "/enroll/mobileconfig/extract_udid" => "manifest#extract_udid"
   get "/enroll/mobileconfig/extract_udid/check_install" => "manifest#check_install"
-  get "/install" => "manifest#install"
+  get "/install" => "manifest#enroll"
   get "/apple_manifest/manifest.plist" => "manifest#manifest"
-  get "/install/(:appname).ipa" => "manifest#send_ipa"
-end
+  get "/install/app.ipa" => "manifest#send_ipa"
+end

data/lib/apple_manifest_rails.rb

@@ -1,9 +1,41 @@
 require "apple_manifest_rails/engine"
 
-require "apple_manifest/enroll/mobile_config"
-require "apple_manifest/enroll/response_parser"
-require "apple_manifest/install/checker"
-require "apple_manifest/install/ipa"
+require "apple_manifest_rails/enroll/mobile_config"
+require "apple_manifest_rails/enroll/response_parser"
+require "apple_manifest_rails/install/checker"
+require "apple_manifest_rails/install/ipa"
+require "apple_manifest_rails/template_dir"
 
 module AppleManifestRails
+  def self.configure
+    yield self
+  end
+
+  def self.page_title
+    @page_title ||= "AppleManifestRails v#{VERSION}"
+  end
+
+  def self.page_title=(str)
+    @page_title = str
+  end
+
+  def self.template_dir
+    @template_dir ||= TemplateDir.new(Rails.root.join('apple_manifest_templates'))
+  end
+
+  def self.template_dir=(path)
+    @template_dir ||= TemplateDir.new(path.to_s)
+  end
+
+  def self.template name
+    template_dir.join name
+  end
+
+  def self.ipa_path
+    @ipa_path ||= template_dir.join('builds', 'app.ipa')
+  end
+
+  def self.ipa_path= str
+    @ipa_path = str
+  end
 end

data/lib/{apple_manifest → apple_manifest_rails}/enroll/mobile_config.rb

@@ -1,4 +1,4 @@
-module AppleManifest
+module AppleManifestRails
   module Enroll
     class MobileConfig
       attr_accessor :next_url
@@ -25,7 +25,7 @@ module AppleManifest
 
       private
       def template_path
-        Rails.root.join('mobile_build', 'Profile.mobileconfig').to_s
+        AppleManifestRails.template('Profile.mobileconfig')
       end
     end
   end

data/lib/{apple_manifest → apple_manifest_rails}/enroll/response_parser.rb

@@ -1,4 +1,4 @@
-module AppleManifest
+module AppleManifestRails
   module Enroll
     class ResponseParser
       attr_accessor :body

data/lib/{apple_manifest → apple_manifest_rails}/install/checker.rb

@@ -1,17 +1,21 @@
 require 'fileutils'
 require 'zip/zipfilesystem'
 
-module AppleManifest
+module AppleManifestRails
   module Install
     class Checker
       attr_accessor :mobileprovision
 
-      def initialize udid, appname
-        ipa_path = Rails.root.join('mobile_build', 'builds', appname).to_s
+      def initialize
+        ipa_path = AppleManifestRails.ipa_path
         extract_mobileprovision_from ipa_path
-        @installable = self.mobileprovision.include? udid
       end
 
+      def installable? udid
+        self.mobileprovision.include? udid
+      end
+      
+      private
       def extract_mobileprovision_from ipa_path
         tempfile = File.join('tmp', 'embedded.mobileprovision')
         FileUtils.rm tempfile if File.exists? tempfile
@@ -26,10 +30,6 @@ module AppleManifest
         File.open(tempfile) {|f| self.mobileprovision = f.read }
         FileUtils.rm tempfile
       end
-
-      def installable? 
-        @installable
-      end
     end
   end
 end

data/lib/{apple_manifest → apple_manifest_rails}/install/ipa.rb

@@ -1,12 +1,12 @@
-module AppleManifest
+module AppleManifestRails
   module Install
     class IPA
 
       def template
-        Rails.root.join('mobile_build', 'manifest.plist').to_s
+        AppleManifestRails.template('manifest.plist')
       end
-
-      def tmp
+      
+      def manifest_path
         Rails.root.join('tmp', 'manifest.plist').to_s
       end
 
@@ -25,16 +25,12 @@ module AppleManifest
       end
 
       def write_manifest
-        File.open(tmp, "w") do |f|
+        File.open(manifest_path, "w") do |f|
           File.open(template, "r") do |tmpl|
             f.write tmpl.read.gsub("[IPAURL]", self.url)
           end
         end
       end
-
-      def manifest_path
-        Rails.root.join("tmp","manifest.plist").to_s
-      end
     end
   end
 end

data/lib/apple_manifest_rails/template_dir.rb

@@ -0,0 +1,30 @@
+module AppleManifestRails
+  class TemplateDir
+    attr_accessor :dir
+    class InvalidTemplateDirError < StandardError ; end
+    class TemplateMissingError < StandardError ; end
+    EXPECTED_TEMPLATES = %w{Profile.mobileconfig manifest.plist}
+
+    def initialize dir
+      errors = []
+      self.dir = File.expand_path(dir.to_s)
+      if File.directory?(self.dir)
+        EXPECTED_TEMPLATES.each do |t|
+          path = self.join(t)
+          unless File.exists?(path)
+            errors << "Template missing! #{path}"
+          end
+        end
+      else
+        raise InvalidTemplateDirError, "Expected a template directory! #{self.dir}"
+      end
+      if errors.size > 0
+        raise TemplateMissingError, errors.join("\n")
+      end
+    end
+
+    def join *args
+      File.join(self.dir, args)
+    end
+  end
+end

data/lib/apple_manifest_rails/version.rb

@@ -1,3 +1,3 @@
 module AppleManifestRails
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: apple_manifest_rails
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Keyvan Fatehi
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-05-06 00:00:00.000000000 Z
+date: 2013-05-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -73,11 +73,12 @@ files:
 - app/views/apple_manifest_rails/manifest/install.html.haml
 - app/views/layouts/apple_manifest_rails/application.html.erb
 - config/routes.rb
-- lib/apple_manifest/enroll/mobile_config.rb
-- lib/apple_manifest/enroll/response_parser.rb
-- lib/apple_manifest/install/checker.rb
-- lib/apple_manifest/install/ipa.rb
 - lib/apple_manifest_rails/engine.rb
+- lib/apple_manifest_rails/enroll/mobile_config.rb
+- lib/apple_manifest_rails/enroll/response_parser.rb
+- lib/apple_manifest_rails/install/checker.rb
+- lib/apple_manifest_rails/install/ipa.rb
+- lib/apple_manifest_rails/template_dir.rb
 - lib/apple_manifest_rails/version.rb
 - lib/apple_manifest_rails.rb
 - lib/tasks/apple_manifest_rails_tasks.rake
@@ -97,12 +98,12 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ! '>='
     - !ruby/object:Gem::Version
       version: 1.9.2
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
@@ -112,3 +113,4 @@ signing_key:
 specification_version: 4
 summary: Rails engine for iOS app distribution
 test_files: []
+has_rdoc: