diff --git a/framework/src/org/apache/cordova/CordovaPlugin.java b/framework/src/org/apache/cordova/CordovaPlugin.java index 2e7a9327..f467bdfe 100644 --- a/framework/src/org/apache/cordova/CordovaPlugin.java +++ b/framework/src/org/apache/cordova/CordovaPlugin.java @@ -36,23 +36,31 @@ public class CordovaPlugin { public CordovaInterface cordova; protected CordovaPreferences preferences; - void privateInitialize(CordovaInterface cordova, CordovaWebView webView, CordovaPreferences preferences) { + /** + * Call this after constructing to initialize the plugin. + * Final because we want to be able to change args without breaking plugins. + */ + public final void privateInitialize(CordovaInterface cordova, CordovaWebView webView, CordovaPreferences preferences) { assert this.cordova == null; this.cordova = cordova; this.webView = webView; this.preferences = preferences; initialize(cordova, webView); - initialize(); + pluginInitialize(); } - @Deprecated // Override initialize() instead. + /** + * Called after plugin construction and fields have been initialized. + * Prefer to use pluginInitialize instead since there is no value in + * having parameters on the initialize() function. + */ public void initialize(CordovaInterface cordova, CordovaWebView webView) { } /** - * This is where you can do start-up logic with protected fields set. + * Called after plugin construction and fields have been initialized. */ - protected void initialize() { + protected void pluginInitialize() { } /**