Changes between Version 17 and Version 18 of DevelopersGuide/DevelopingPlugins

Timestamp:

2007-07-19T14:54:09+02:00 (18 years ago)

Author:

imi

Comment:

--

DevelopersGuide/DevelopingPlugins

@@ -23 +23 @@
 
 = Callbacks =
-Most of your plugin work will probably be tweaking the JOSM object tree at startup time, but there are a few callbacks that get automatically called on every plugin.
+Most of your plugin work will probably be tweaking the JOSM object tree at startup time, but there are a few callbacks that get automatically called on every plugin (whether you subclass Plugin or not, just the signature matters).
 
 == mapFrameInitialized ==
@@ -84 +84 @@
 
 
+= Versioning and Dependencies =
+JOSM does not support declarative dependency checking - you have to do it by hand. But don't be scared, it's not that hard. You can request information about other installed plugins via {{{PluginInformation.getLoaded("pluginname")}}}. As example if your plugin is named "secondwaltz" and you depend on the plugin "schostakowitsch" to be loaded, do the following things:
+
+ - make sure you get loaded after "schostakowitsch" (by incrementing your Plugin-Stage. See above)
+ - check for "schostakowitsch" to be loaded in your plugin's class constructor:
+{{{
+#!java
+PluginInformation schostakowitsch = PluginInformation.getLoaded("schostakowitsch");
+if (schostakowitsch == null || !"2".equals(schostakowitsch.version)) {
+  JOptionPane.showMessageDialog(Main.parent, tr("Please install plugin 'schostakowitsch' version 2");
+  return;
+}
+}}}
+ - Of course, you may initialize the parts of your plugin that don't need "schostakowitsch" to be loaded or react in some other way to the missing plugin (e.g. by using a build-in version of "schostakowitsch").
+
+
 = Legal stuff (Imis opinion) =