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 2013/07/11 03:11:02 UTC
docs commit: [CB-1107] Remove old plugin signature,
update Plugin Dev Guide
Updated Branches:
refs/heads/master 09d1f7f19 -> 8b7d6042f
[CB-1107] Remove old plugin signature, update Plugin Dev Guide
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/8b7d6042
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/8b7d6042
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/8b7d6042
Branch: refs/heads/master
Commit: 8b7d6042f855ee3a062e714aa87f7094b279fdc4
Parents: 09d1f7f
Author: Shazron Abdullah <sh...@apache.org>
Authored: Wed Jul 10 18:10:53 2013 -0700
Committer: Shazron Abdullah <sh...@apache.org>
Committed: Wed Jul 10 18:10:53 2013 -0700
----------------------------------------------------------------------
docs/en/edge/guide/platforms/ios/plugin.md | 29 -------------------------
1 file changed, 29 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/8b7d6042/docs/en/edge/guide/platforms/ios/plugin.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/ios/plugin.md b/docs/en/edge/guide/platforms/ios/plugin.md
index 61bc117..77d7ca3 100644
--- a/docs/en/edge/guide/platforms/ios/plugin.md
+++ b/docs/en/edge/guide/platforms/ios/plugin.md
@@ -97,18 +97,6 @@ callback does not fire.
* `messageAsMultipart` expects an `NSArray*` containing any of the other supported types, and sends the whole array as the `arguments` to your JavaScript callback.
* Quirk: this is not just syntactic sugar (though it is sweet). This way, all of the arguments are serialized/deserialized as necessary. e.g. it is safe to return `NSData*` as multipart, but not as `Array`/`Dictionary`.
-## Plugin Signatures
-
-The **new signature** supported beginning in **Cordova 2.1.0** 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.
-
## Echo Plugin iOS Plugin
We would add the following to the `<plugins>` tag of the project's `config.xml` file:
@@ -211,20 +199,3 @@ running in the iOS 6 Simulator.
* Don't forget to add your plugin's mapping to config.xml. If you forget, an error is logged in the Xcode console.
* Don't forget to add any hosts you connect to in the whitelist, as described in Domain Whitelist Guide. If you forget, an error is logged in the Xcode console.
-
-## Deprecated Plugin Signature Note
-
-The **old (deprecated)** signature is:
-
- - (void) myMethod:(NSMutableArray*)arguments withDict:(NSMutableDictionary*)options;
-
-The Objective-C plugin method's `options` parameter is deprecated, and
-should not be used. For legacy reasons, the last JavaScript object
-passed in the `args` array is passed in as the `options` dictionary of
-the Objective-C method. You must make sure that any JavaScript object
-that is passed in as an element in the `args` appears as the last item
-in the array. Otherwise it throws off the array index for all
-subsequent parameters of the Objective-C array. Only one JavaScript
-object is supported for the options dictionary, and only the last one
-encountered will be passed to the native method. Errors stemming from
-this problem are the reason `options` has been deprecated.