motion-paddle 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d18314dddcee9e6f6cbd2a39d46eab6021968cbf
-  data.tar.gz: 14600491324e0f7e30dfebdf606315a13ec6c096
+  metadata.gz: 95fb281027ac232a348ea83b014a35620e4e339c
+  data.tar.gz: 6c09d0fa17dfb0427696f9b6375368d7ced6cdd1
 SHA512:
-  metadata.gz: 61fb59ae38bdc1308c5cc2b5de0ea25b8d9be0aebb942831d13795ee3fdcf492950e28e33022125fe632c889f4877d474c864458e38b20fba8a3c3e27d71320d
-  data.tar.gz: da03a3a5540a0b0ab501ab905b9e2498e45dc94ecbb26c652285e96ef1fa5af69b60939cbc1ed844635b5f464ab8ebf135b96271e6e84c97b058e9ad11ab3a88
+  metadata.gz: dc6480925611af3d6aa9f92686da9021fbb51617484805df7d74f054329c4e576db1db208c32a6713394e6eabed1acc2a17e35be5ec01e30b9047ba6de303f86
+  data.tar.gz: e1d91430da12bd747fe75a47e216cc5d9cb4fe1326c8713a9bedc7911c43dfd086ac2f0c1fc2b533d3e4fd1f75402e96c07aecf474439825d72f44cfa26171c7

data/README.md

@@ -1,8 +1,11 @@
 # motion-paddle
+[![Gem Version](https://badge.fury.io/rb/motion-paddle.svg)](http://badge.fury.io/rb/motion-paddle)
 
 Paddle for vendors: <https://vendors.paddle.com>
+
 You will have to vendor the Paddle framework yourself because I can't get the gem to bundle it properly.
-More info coming soon.
+
+You can see the gem in use in my MemoryTamer app <https://github.com/henderea/MemoryTamer>.
 
 ## Installation
 
@@ -20,7 +23,74 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+###In Rakefile:
+
+```ruby
+Motion::Project::App.setup do |app|
+  #...
+  app.paddle do
+    set :product_id, 'product_id'
+    set :vendor_id, 'vendor_id'
+    set :api_key, 'api_key'
+    set :current_price, 'current_price'
+    set :dev_name, 'dev_name'
+    set :currency, 'currency'
+    set :image, 'image'
+    set :product_name, 'product_name'
+    set :trial_duration, 'trial_duration'
+    set :trial_text, 'trial_text'
+    set :product_image, 'product_image'
+    set :time_trial, true
+  end
+  # you have to vendor Paddle.framework yourself
+  app.embedded_frameworks << 'vendor/Paddle.framework'
+end
+```
+
+### In app_delegate.rb
+
+```ruby
+def applicationDidFinishLaunching(notification)
+  MotionPaddle.setup(window = nil) { |action, note|
+    if MotionPaddle.activated?
+      NSLog "activated with license code #{MotionPaddle.activated_license_code} and email #{MotionPaddle.activated_email}"
+    else
+      NSLog "not activated"
+    end
+    if action == :activated
+      do_something_on_activated
+    elsif action == :continue
+      do_something_on_continue
+    end
+  }
+  MotionPaddle.listen(:deactivated) { |action, deactivated, deactivateMessage|
+    if deactivated
+      NSLog 'deactivated license'
+      MotionPaddle.show_licensing
+    else
+      NSLog "failed to deactivate license: #{deactivateMessage}"
+    end
+  }
+  MotionPaddle.listen(:error) { |action, nsError|
+    do_something_with_error
+  }
+end
+```
+
+###Other `MotionPaddle` methods not in the above example
+
+* `MotionPaddle.enabled?` - true if Paddle framework is included
+* `MotionPaddle.paddle_instance` - shared `Paddle` instance, typically not needed
+* `MotionPaddle.time_trial?` - defaults to value from Rakefile
+* `MotionPaddle.time_trial=` - override the `time_trial` value from the Rakefile
+* `MotionPaddle.can_force_exit?` - gets the Paddle framework setting for whether the app is shut down normally or force exited
+* `MotionPaddle.can_force_exit=` - set the above value
+* `MotionPaddle.will_show_licensing_window?` - get the Paddle framework setting for whether the app will show the licensing window right away or wait until `MotionPaddle.show_licensing` is called
+* `MotionPaddle.will_show_licensing_window=` - set the above value
+* `MotionPaddle.trial_days_left` - get the number of days left in the trial
+* `MotionPaddle.deactivate_license` - deactivate the license
+
+**NOTE:** some methods offer a version that uses the spelling "licen**c**e".  This is the name used for the methods in the Paddle framework, so I included this spelling as an option.  The `will_show_licensing_window` methods are the only ones with it spelled with an "s" in the Paddle framework, and they do not have the "c" version in `MotionPaddle`.
 
 ## Contributing
 

data/lib/motion-paddle/paddle_setup.rb

@@ -8,6 +8,10 @@ class MotionPaddle
       Paddle.sharedInstance
     end
 
+    def psk_instance
+      PaddleStoreKit.sharedInstance
+    end
+
     def product_id
       self.plist['product_id']
     end
@@ -78,6 +82,14 @@ class MotionPaddle
       paddle_instance.setWillShowLicensingWindow(will_show_licensing_window)
     end
 
+    def psk_valid_receipts
+      psk_instance.validReceipts
+    end
+
+    def psk_receipt_for_product_id(product_id)
+      psk_instance.receiptForProductId(product_id)
+    end
+
     def setup(window = nil, &block)
       return unless enabled?
       return unless self.plist
@@ -109,6 +121,34 @@ class MotionPaddle
       }
     end
 
+    def psk_show(product_ids = nil, &block)
+      return unless enabled?
+      psk = psk_instance
+      psk.setDelegate(self)
+      if product_ids && !product_ids.empty?
+        psk.showStoreViewForProductIds(product_ids)
+      else
+        psk.showStoreView
+      end
+      listen(:psk_purchase, &block)
+    end
+
+    def psk_show_product(product_id, &block)
+      return unless enabled?
+      psk = psk_instance
+      psk.setDelegate(self)
+      psk.showProduct(product_id)
+      listen(:psk_purchase, &block)
+      end
+
+    def psk_purchase_product(product_id, &block)
+      return unless enabled?
+      psk = psk_instance
+      psk.setDelegate(self)
+      psk.purchaseProduct(product_id)
+      listen(:psk_purchase, &block)
+    end
+
     def trial_days_left
       paddle_instance.daysRemainingOnTrial
     end
@@ -170,5 +210,20 @@ class MotionPaddle
     def paddleDidFailWithError(error)
       call_listeners :error, error
     end
+
+    #internal
+    def PSKProductPurchased(transactionReceipt)
+      call_listeners :psk_purchase, transactionReceipt
+    end
+
+    #internal
+    def PSKDidFailWithError(error)
+      call_listeners :psk_error, error
+    end
+
+    #internal
+    def PSKDidCancel(error)
+      call_listeners :psk_cancel, error
+    end
   end
 end

data/lib/motion-paddle/version.rb

@@ -1,3 +1,3 @@
 module MotionPaddle
-  VERSION = '1.0.0'
+  VERSION = '1.1.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: motion-paddle
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Eric Henderson
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-10-08 00:00:00.000000000 Z
+date: 2014-10-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -80,4 +80,3 @@ signing_key:
 specification_version: 4
 summary: A RubyMotion gem for using the Paddle framework
 test_files: []
-has_rdoc: