antenna-ota 0.1.4 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5268c6276e2dd2cdebbd16c1a1df41dc49bab722
-  data.tar.gz: 953bc51904fcb09accd8aa90df9691fb7ba09113
+  metadata.gz: 1cca2a6dae4fc47cc88f5eacb32aab337cdc7360
+  data.tar.gz: 6a7fd2e44625b70df3d159ebece9a408309ecf76
 SHA512:
-  metadata.gz: b26482d957a336ef3c6ecc5b659d0d6f07947ceccd1738687608aa94027f6aee35791f4b4c4821fc06aafe92bbbbbcc906f0fed8581d2e620583e51be42569ed
-  data.tar.gz: 322384d8829dcd4dd5dc5743be1a2d2b52b030250bdda63b59d48eb1ca42fa0bbe4a00a5e6beadb41a12328dc4e4f16d7acff59f1c2da813f1f95340c0c8605c
+  metadata.gz: f6c7abf14f8c470064074aa38635f229a4aaa22d5b93371bbbd586e1d3a2d277d7be42546806c5f233e5e7a573d0d519547adfd9c3ad4305e14ee7bb3a0f9a54
+  data.tar.gz: 2f11040e094155e3ac93a44dcfd96cd22c3506411d74829224fa4e76982950d409739d4166f3848a9cd86d85224f777fdf084a70b9d567aa20ee0508f0f5d08d

data/README.md

@@ -2,7 +2,7 @@
 
 # Antenna
 
-Antenna aims to take the pain out of creating and distributing all the necessary files for Enterprise iOS over-the-air distribution. It generates the mandatory XML manifest, app icons and an HTML file, automatically extracting all the needed information from the specified `.ipa` file, and uploads everything via a distribution method of your choice (currently only S3 is supported, but you're encouraged to create other storage backends). The result is a (signed S3) URL, which you may then send to your clients, so they can easily install your app from Mobile Safari with just one tap.
+Antenna aims to take the pain out of creating and distributing all the necessary files for Enterprise iOS over-the-air distribution. It generates the mandatory XML manifest, app icons and an HTML file, automatically extracting all the needed information from the specified `.ipa` file, and uploads everything via a distribution method of your choice (currently only S3 and local filesystem are supported, but you're encouraged to create other storage backends). The result is a (signed S3) URL, which you may then send to your clients, so they can easily install your app from Mobile Safari with just one tap.
 
 ## Installation
 
@@ -23,6 +23,7 @@ $ antenna
 
   Commands:
     help    Display global or [command] help documentation
+    local   Distribute .ipa file to local file system
     s3      Distribute .ipa file over Amazon S3
 
   Global Options:
@@ -32,6 +33,30 @@ $ antenna
     -t, --trace          Display backtrace when an error occurs
 ```
 
+### S3-specific options
+
+```
+    -f, --file FILE                             .ipa file to distribute
+    -a, --access-key-id ACCESS_KEY_ID           S3 access key ID
+    -s, --secret-access-key SECRET_ACCESS_KEY   S3 secret access key
+    -b, --bucket BUCKET                         S3 bucket name
+        --[no-]create                           (Don't) create bucket if it doesn't already exist
+    -r  --region REGION                         AWS region (optional, e.g. https://mys3.example.com)
+    -e  --endpoint ENDPOINT                     S3 endpoint (optional, e.g. https://mys3.example.com)
+    -x  --expires EXPIRES                       Expiration of URLs in seconds (optional, e.g. 86400 = one day, one week max)
+    -i  --base BASE                             Base filename (optional, defaults to IPA filename without .ipa extension)
+    -p  --public                                Use public instead of signed URLs (you'll might want '--acl public-read' also)
+        --acl ACL                               Permissions for uploaded files. Must be one of: private, public-read, public-read-write, authenticated-read, bucket-owner-read, bucket-owner-full-control (optional, defaults to private)
+```
+
+### Local-specific options
+
+```
+    -f, --file FILE      .ipa file to distribute (searches current directory for .ipa files if not specified)
+    -U, --url URL        Base URL all files should be prefixed with
+    -i, --base BASE      Base filename (optional, defaults to IPA filename without .ipa extension)
+```
+
 ## Examples
 
 ### 1. Private, signed URL
@@ -64,7 +89,20 @@ The resulting URLs show an installation page like the following and can be distr
 
 ![Installation site](https://raw.githubusercontent.com/soulchild/antenna/master/assets/example-installation.png)
 
-*Note:* App icons in any .ipa file are converted from PNG to [Apple's CgBI file format](http://iphonedevwiki.net/index.php/CgBI_file_format) and therefore not viewable in most applications, including Chrome and Firefox. Apple applications like (Mobile) Safari or Preview.app know how to handle the format though.
+_Note:_ App icons in any .ipa file are converted from PNG to [Apple's CgBI file format](http://iphonedevwiki.net/index.php/CgBI_file_format) and therefore not viewable in most applications, including Chrome and Firefox. Apple applications like (Mobile) Safari or Preview.app know how to handle the format though.
+
+### 3. Local file system
+
+Distribute OverTheAir.ipa to the local file-system. The resulting files can then be uploaded manually:
+
+```bash
+$ antenna local --url https://www.example.com/ipa/ --file OverTheAir.ipa
+Distributing OverTheAir.ipa ...
+Distributing OverTheAir.png ...
+Distributing OverTheAir.plist ...
+Distributing OverTheAir.html ...
+https://www.example.com/ipa/OverTheAir.html
+```
 
 ## Author
 
@@ -78,4 +116,4 @@ Bug reports and pull requests are welcome on [GitHub](https://github.com/soulchi
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/antenna.gemspec

@@ -20,7 +20,7 @@ Gem::Specification.new do |spec|
 
   spec.add_development_dependency "bundler", "~> 1.7"
   spec.add_development_dependency "rake", "~> 10.0"
-  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "rspec", "~> 3.8"
   
   spec.add_dependency "aws-sdk", '~> 2.0', '>= 2.0.0'
   spec.add_dependency "commander", "~> 4.3"

data/lib/antenna/command/local.rb

@@ -0,0 +1,26 @@
+require 'distributor'
+require 'distributor/local'
+
+command :local do |c|
+  c.name = "local"
+  c.syntax = "antenna local [options]"
+  c.summary = "Distribute .ipa file to local file system"
+
+  c.example 'Distribute "awesome.ipa" to current path', 'antenna local --url https://example.com/ipas/ --file ./awesome.ipa'
+
+  c.option '-f', '--file FILE', '.ipa file to distribute (searches current directory for .ipa files if not specified)'
+  c.option '-U', '--url URL', 'Base URL all files should be prefixed with'
+  c.option '-i', '--base BASE', "Base filename (optional, defaults to IPA filename without .ipa extension)"
+
+  c.action do |args, options|
+    determine_file! unless @file = options.file
+    say_error "Missing .ipa file" and abort unless @file and File.exist?(@file)
+
+    local = Antenna::Distributor::Local.new()
+    distributor = Antenna::Distributor.new(local)
+    puts distributor.distribute @file, {
+      :base => options.base,
+      :url  => options.url
+    }
+  end
+end

data/lib/antenna/commands.rb

@@ -1,6 +1,7 @@
 $:.push File.expand_path('../', __FILE__)
 
 require 'command/s3'
+require 'command/local'
 
 private
 

data/lib/antenna/distributor/local.rb

@@ -0,0 +1,26 @@
+require 'uri'
+
+module Antenna
+  class Distributor::Local
+    def initialize()
+    end
+
+    def setup(ipa_file, options = {})
+      @options = options
+    end
+
+    def distribute(data, filename, content_type)
+      puts "Distributing #{filename} ..."
+
+      target = open(filename, 'w')
+      target.write(data)
+      target.close
+
+      if @options[:url]
+        URI.join(@options[:url], filename)
+      else
+        filename
+      end
+    end
+  end
+end

data/lib/antenna/version.rb

@@ -1,3 +1,3 @@
 module Antenna
-  VERSION = "0.1.4"
+  VERSION = "0.2.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: antenna-ota
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.2.1
 platform: ruby
 authors:
 - Tobi Kremer
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-12-02 00:00:00.000000000 Z
+date: 2018-09-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -42,16 +42,16 @@ dependencies:
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.8'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.8'
 - !ruby/object:Gem::Dependency
   name: aws-sdk
   requirement: !ruby/object:Gem::Requirement
@@ -171,9 +171,11 @@ files:
 - bin/setup
 - exe/antenna
 - lib/antenna.rb
+- lib/antenna/command/local.rb
 - lib/antenna/command/s3.rb
 - lib/antenna/commands.rb
 - lib/antenna/distributor.rb
+- lib/antenna/distributor/local.rb
 - lib/antenna/distributor/s3.rb
 - lib/antenna/html.rb
 - lib/antenna/infoplist.rb