native 1.0.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a0f49ca96f43cc606c67f8d36983a1680534ad5099cef846bbf1a2ad9c67b70
-  data.tar.gz: 3547dcc23cc09bbae8daebbf422298891411502db16893c53235a3814704bc6a
+  metadata.gz: 0bfb554ed0a23884a6355580ddee53294e29b6ddfee890d4b81c894b027c9359
+  data.tar.gz: dfc98650f1fa96e4f72f6047017d8326fb526a47967657d2713eedcc24d66504
 SHA512:
-  metadata.gz: a2af11d5c69359666db6ba567f95119a2fa358a988274fea0b9d4cf13cc874e341e8a59c51c47e45f17f6c6294528f9f0f2ffa1846e57c6600aa9119df705083
-  data.tar.gz: 1c3cb8e5f8acb4ed23b51d53eb87cf616c2915957e508015e3e46d2182639f9fe5952602a03cf5d54ff0b1a77bb7d73b2fb9a7983b050b84660d9a4d0a0bd665
+  metadata.gz: 5375af7ad6450574e0317b12ac34a4cc5e1575558c57512335174c284d65f8eda977a0018434970800b8584e57579ae486bfd99fd342a1ed7583425929df177e
+  data.tar.gz: 9f73e0a914cc98362dee8a0bf213cde5ffeb4329dbecac9f4d00e2a7efa38996ea63f67ee5153060e3229196a1f52860ceedefd1fbe06dced38e38b42c5a41db

data/CHANGELOG.md

@@ -4,6 +4,12 @@
 
 * nothing yet
 
-### 1.0.0 - 2017-12-19
+### 2.0.0 - 2017-12-21
+
+* features
+    * made Devise optional
+    * added `owner` association to `App` model
+
+### 1.0.0 - 2017-12-20
 
 * initial release

data/DEPRECATIONS.md

@@ -1 +1,5 @@
 # Deprecations
+
+### 2.0.0 - 2017-12-21
+
+* `devise_class` configuration method removed

data/README.md

@@ -35,6 +35,7 @@ Native is being powered by **[NativeGap](https://nativegap.com)**.
     * [NativeGap](#nativegap)
     * [Assets](#assets)
     * [App methods](#app-methods)
+        * [Associate objects](#associate-objects)
     * [View methods](#view-methods)
     * [Notifications](#notifications)
     * [Content scaling (Android)](#content-scaling-android)
@@ -42,6 +43,7 @@ Native is being powered by **[NativeGap](https://nativegap.com)**.
 * [To Do](#to-do)
 * [Contributing](#contributing)
     * [Contributors](#contributors)
+    * [Semantic versioning](#semantic-versioning)
 * [License](#license)
 
 ---
@@ -117,7 +119,7 @@ mount Native::Engine, at: '/native'
 
 ### NativeGap
 
-While this gem assists you in creating a true cross-platform app, [NativeGap](https://nativegap.com) is still needed to create the actual native code. That's not too big of a deal though, NativeApp can be used entirely for free and it has an extensive [documentation](https://nativegap.com/guide).
+While this gem assists you in creating a true cross-platform app, [NativeGap](https://nativegap.com) is still needed to create the actual native code. That's not too big of a deal though, NativeApp can be used entirely for free ([learn more](https://nativegap.com/pricing)) and it has an extensive [documentation](https://nativegap.com/guide).
 
 Getting started with NativeGap:
 
@@ -127,11 +129,11 @@ Getting started with NativeGap:
 
 That's it!
 
-Native also supports the coexistence of multiple NativeGap apps with only one Rails app as a source.
+**Note:** Native also supports the coexistence of multiple NativeGap apps with only one Rails app as a source.
 
 ### Assets
 
-With Native it is fairly simple to add platform specific stylesheets and scripts. In your assets directory you have a separate folder (in `app/assets/native`) for every platform which behaves similarly to the root assets folder. You are not only able to add custom assets for those platforms added by Native, but you can also add `web` specific assets.
+With Native it is fairly simple to add platform specific stylesheets and scripts. In your assets directory you have a separate folder (`app/assets/native`) for every platform behaving similarly to the root assets folder. You are not only able to add custom assets for those platforms added by Native, but you can also add `web` specific assets.
 
 You simple have to include ...
 
@@ -148,8 +150,8 @@ Native introduces an `App` activerecord model. Every object of your devise class
 ```ruby
 a = App.first
 
-# Returns user (or other devise object) that this device belongs to. Can return `nil`.
-a.user
+# Returns associated object. Can return `nil`.
+a.owner
 
 # Returns lowercase string of platform.
 d.platform
@@ -175,6 +177,20 @@ d.platforms
 d.apps
 ```
 
+#### Associate objects
+
+If you are using Devise and your model is named `User`, the object returned by `current_user` will automatically be associated with the current app. If your Devise model is not named `User` or you are using a different user-management solution that does not implement a `current_user` method, you are able to override this default behavior.
+
+Let's say our Devise model is named `Admin`. Just add a `private` method to your `ApplicationController`:
+
+```ruby
+def set_app_owner
+    current_admin if current_admin
+end
+```
+
+**Note:** Essentially `set_app_owner` has to return a class object *or* `nil`.
+
 ### View methods
 
 **`current_app`** Returns `App` object related to current session. Returns `nil` when the Rails is being used normally.
@@ -211,12 +227,10 @@ You can configure Native by passing a block to `configure`:
 
 ```ruby
 Native.configure do |config|
-    config.devise_class = 'User'
+    config.android = true
 end
 ```
 
-**`devise_class`** Specify your devise class. Takes a string. Defaults to `'User'`.
-
 **`#{platform}`** Set to `false` to disable the platform. Takes a boolean. Defaults to `true`.
 
 **`#{platform}_url`** Specify the start url of your app on a given platform by passing a stringified route helper. Takes a string. Defaults to `'root_url'`.
@@ -245,6 +259,10 @@ Give the people some :heart: who are working on this project. See them all at:
 
 https://github.com/NativeGap/native-rails/graphs/contributors
 
+### Semantic Versioning
+
+Native follows Semantic Versioning 2.0 as defined at http://semver.org.
+
 ## License
 
 MIT License

data/app/controllers/native/application_controller.rb

@@ -1,2 +1,7 @@
 class Native::ApplicationController < ActionController::Base
+
+    def set_app_owner
+        current_user if current_user
+    end
+
 end

data/app/controllers/native/platforms_controller.rb

@@ -60,7 +60,7 @@ module Native
                 @app.platform = platform
                 @app.url = url
             end
-            @app.send( "#{Native.configuration.devise_class.downcase}=", send("current_#{Native.configuration.devise_class.downcase}") ) if send("current_#{Native.configuration.devise_class.downcase}")
+            @app.owner = ApplicationController.set_app_owner || set_app_owner
             @app.last_used = Time.now
             @app.save!
 

data/lib/generators/templates/app_model.rb

@@ -4,6 +4,6 @@ class Native::App < ActiveRecord::Base
 
     include Native::AppLib
 
-    belongs_to Native.configuration.devise_class.downcase.to_sym, optional: true
+    belongs_to :owner, polymorphic: true, optional: true
 
 end

data/lib/generators/templates/apps_migration.rb.erb

@@ -2,7 +2,7 @@ class NativeMigration < ActiveRecord::Migration<%= migration_version %>
     def change
         create_table :native_apps do |t|
 
-            t.references Native.configuration.devise_class.downcase.to_sym, index: true
+            t.references :owner, polymorphic: true, index: true
 
             t.string :platform, index: true
             t.string :url, index: true

data/lib/generators/templates/initializer.rb

@@ -1,13 +1,5 @@
 Native.configure do |config|
 
-    ### DEVISE ###
-
-    # Specify your devise class. Defaults to `'User'`.
-    # config.devise_class = 'User'
-
-
-    ### CUSTOMIZATION ###
-
     # Specify platforms your app supports.
     # config.android = true
     # config.ios = true

data/lib/native/configuration.rb

@@ -1,7 +1,6 @@
 module Native
     class Configuration
 
-        attr_accessor :devise_class
         attr_accessor :android
         attr_accessor :ios
         attr_accessor :uwp
@@ -23,7 +22,6 @@ module Native
         attr_accessor :scale_size
 
         def initialize
-            @devise_class = 'User'
             @android = true
             @ios = true
             @uwp = true

data/lib/native/version.rb

@@ -1,5 +1,5 @@
 module Native
 
-    VERSION = '1.0.0'
+    VERSION = '2.0.0'
 
 end

data/native.gemspec

@@ -22,5 +22,4 @@ Gem::Specification.new do |gem|
     gem.add_development_dependency 'bundler', '~> 1.16'
     gem.add_development_dependency 'rake', '~> 10.0'
     gem.add_dependency 'rails', '>= 5.0'
-    gem.add_dependency 'devise', '~> 4.3'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: native
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 2.0.0
 platform: ruby
 authors:
 - Jonas Hübotter
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-12-20 00:00:00.000000000 Z
+date: 2017-12-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -52,20 +52,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '5.0'
-- !ruby/object:Gem::Dependency
-  name: devise
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '4.3'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '4.3'
 description: Build native apps for all major platforms from your Rails applications.
 email: jonas.huebotter@gmail.com
 executables: []