You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by sh...@apache.org on 2012/08/03 03:29:17 UTC

ios commit: [CB-1188] Update Plugin Upgrade Guide for new iOS plugin signature (old one still supported, but deprecated)

Updated Branches:
  refs/heads/master 13ffa9c57 -> 24ef5ea72


[CB-1188] Update Plugin Upgrade Guide for new iOS plugin signature (old one still supported, but deprecated)


Project: http://git-wip-us.apache.org/repos/asf/incubator-cordova-ios/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-cordova-ios/commit/24ef5ea7
Tree: http://git-wip-us.apache.org/repos/asf/incubator-cordova-ios/tree/24ef5ea7
Diff: http://git-wip-us.apache.org/repos/asf/incubator-cordova-ios/diff/24ef5ea7

Branch: refs/heads/master
Commit: 24ef5ea725f9dba2b3c7c4c76829740e991e6f8d
Parents: 13ffa9c
Author: Shazron Abdullah <sh...@apache.org>
Authored: Thu Aug 2 18:29:07 2012 -0700
Committer: Shazron Abdullah <sh...@apache.org>
Committed: Thu Aug 2 18:29:07 2012 -0700

----------------------------------------------------------------------
 guides/Cordova Plugin Upgrade Guide.md |   14 ++++++++++++--
 1 files changed, 12 insertions(+), 2 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-cordova-ios/blob/24ef5ea7/guides/Cordova Plugin Upgrade Guide.md
----------------------------------------------------------------------
diff --git a/guides/Cordova Plugin Upgrade Guide.md b/guides/Cordova Plugin Upgrade Guide.md
index 4ff11cf..d31f8a5 100644
--- a/guides/Cordova Plugin Upgrade Guide.md	
+++ b/guides/Cordova Plugin Upgrade Guide.md	
@@ -26,8 +26,7 @@ This document is for developers who need to upgrade their Cordova  plugins to a
 
 1. **Install** Cordova 2.1.0
 2. Follow the **"Upgrading older Cordova plugins to 2.0.0"** section, if necessary
-3. No changes in plugin structure from 1.9.x
-4. Change in the method signature of the CordovaLib's JSONKit method categories, they are prefixed with "cdvjk_" now:
+3. **Change** in the method signature of the **CordovaLib's JSONKit method categories**, they are prefixed with "cdvjk_" now:
 
     e.g.
     
@@ -36,8 +35,19 @@ This document is for developers who need to upgrade their Cordova  plugins to a
    instead of:
    
         [myDict JSONString];
+        
+4. **Support** a new plugin method signature (old signature is deprecated):
+
+    The **new** signature is:
 
+        - (void) myMethod:(CDVInvokedUrlCommand*)command;
 
+    The **old (deprecated**) signature is:
+
+        - (void) myMethod:(NSMutableArray*)arguments withDict:(NSMutableDictionary*)options;
+
+    Basically, the options dictionary has been removed for the new signature, and the callbackId is not the 0th index item for the arguments array, but it is now in a separate property. View [CDVInvokedUrlCommand.h](https://github.com/apache/incubator-cordova-ios/blob/master/CordovaLib/Classes/CDVInvokedUrlCommand.h)
+    
 ## Upgrading older Cordova plugins to 2.0.0 ##
 
 1. **Install** Cordova 2.0.0