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 <shaz...@apache.org> Authored: Thu Aug 2 18:29:07 2012 -0700 Committer: Shazron Abdullah <shaz...@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