cordova-plugin-extension

Cordova Plugin common extension with adapter interface

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
cordova-plugin-extension
1.6.07 months ago7 years agoMinified + gzip package size for cordova-plugin-extension in KB

Readme

Cordova Plugin Common Extension #
Extend the Cordova plugin base class with adapter interface.
Plugin written based on this interface, may also be reused for Unity, Cocos2d-X, and other frameworks.
Purpose #
Make Cordova Plugins reusable.
To use mobile device native functionalities and integrate 3rd-party SDKs, mobile developers are writting hundreds plugins for Cordova, Unity, Cocos2d-X, and other frameworks.
Can they be reused? Yes, it's possible.
Cordova plugin manager is bridging function call between javascript and native languages, actually, it can be ported to bridge with C, C++, C#, then it can be reused for Unity, Cocos2d-X and other frameworks.
See:
How it works ? #
Android implementation:
public interface PluginAdapterDelegate {
	// context
	public Activity getActivity();
	public View getView();
	// send message from plugin to container on events
	public void fireEvent(String obj, String eventName, String jsonData);
	// send call result
	public void sendPluginResult(PluginResult result, CallbackContext context);
}

public class CordovaPluginExt extends CordovaPlugin implements PluginAdapterDelegate {
	protected PluginAdapterDelegate adapter = null;
}

iOS implementation:
```objective-c @protocol PluginAdapterDelegate
// context
  • (UIView) getView;
  • (UIViewController) getViewController;
// send message from plugin to container on events
  • (void) fireEvent:(NSString)obj event:(NSString)eventName withData:(NSString)jsonStr;
// send call result
  • (void) sendPluginResult:(CDVPluginResult)result to:(NSString)callbackId;
@end
@interface CDVPluginExt : CDVPlugin @property(nonatomic, retain) id adapter; @end
Other platform:

Not implemented yet.

# How to Use? #

This plugin is used as dependency of other plugins, for plugin developers only.

In your plugin.xml, add it as dependency:

```xml
<dependency id="cordova-plugin-extension"/>

Inherit Cordova Plugin Ext:
Plugin for Android:
import com.rjfun.cordova.ext.*;

// your plugin class
public class YourPluginClass extends CordovaPluginExt {
	// implement the method, call the API defined in PluginAdapterDelegate
	public boolean execute(String action, JSONArray inputs, CallbackContext callbackContext) throws JSONException;
}

Plugin for iOS: ```objective-c
import "CDVCordovaExt.h"
// your plugin class @interface YourPluginClass : CDVPluginExt
// implement the method, call the API defined in PluginAdapterDelegate
  • (void) yourmethod:(CDVInvokedUrlCommand )command;
@end ```
Related Projects #
To use the plugin in other frameworks, following plugin managers are required.
Credit #
This project is created by Raymond Xie.
If you are interested in this project, welcome to join and contribute.