Tweak CordovaPlugin.initialize method to be less deprecated.

Thinking here is that we need a while for both initialize and
pluginInitialize to exist before plugin authors would bother not using
the deprecated one anyways. Really, no harm in keeping both for some
time.
This commit is contained in:
Andrew Grieve 2014-07-10 15:03:53 -04:00
parent a14c794255
commit 3792f75281

View File

@ -34,27 +34,35 @@ import android.net.Uri;
public class CordovaPlugin {
@Deprecated // This is never set.
public String id;
public CordovaWebView webView; // WebView object
public CordovaWebView webView;
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() {
}
/**