Maintainers: Update plugins for Gephi 0.10

[mbastian]

Hi all, we're pleased to have just released the latest Gephi version! This release doesn't require major changes to plugins so we were able to already adapt and publish most of your plugins already.

As maintainers, we would like however to ask you to test it to make it sure it still works in the 0.10 version.

In case your plugin hasn't been released yet for the 0.10 version, follow those instructions to adapt your code and make a Pull Request so we can then merge your changes to the master-forge branch.

If you're unsure what to do, don't hesitate to ask!

Also note that we now follow semantic versioning for Gephi Plugins as well. We will only ask maintainers to review and update plugins for minor and major versions upgrades. So, for instance if Gephi upgrades to 0.10.1 we guarantee that all plugins remain compatible. Next update will be with the 0.11 version.

Migration

1. Merge from master branch

Before starting, make sure to merge with the master branch so you get the latest changes to the pom.xml.

2. Update parent pom

Make sure each of your modules use the latest version of the gephi-plugin-parent

<parent>
     <artifactId>gephi-plugin-parent</artifactId>
     <groupId>org.gephi</groupId>
     <version>0.10.0</version>
</parent>

3. Run validation

Before submitting a PR, make sure your plugin properly builds and validates.

4. Increment the version of your plugin

Make sure to also increment the version of your plugin.

Code changes

There were a couple of API changes that you may need to adapt to. You can see the full list on the release notes.

1. Update Validation Panels

If you were using any panel validation you'll need to change some code (see #2682 for details).

• The ValidationPanel changed package and is now in org.netbeans.validation.api.ui.swing.ValidationPanel
• Most validators are now in StringValidators instead of Validators
• You can use the DialogDescriptorWithValidation helper to obtain a DialogDescriptor with a validation panel.

You can also check this gephi commit where we've adapted many of the validation panels in Gephi.

2. Some modules have been deleted

The directory-chooser module has been deleted as it wasn't needed anymore. See gephi/gephi#2684 for details.

3. iText -> PDFBox

We've changed the library we use to export PDF files from iText to PDFBox. You can read more details in gephi/gephi#2652.

If you deal with PDFs this will certainly require a migration. Fortunately, the two APIs are quite similar. If you get stuck feel free to reach out.

4. Project/Workspace manipulations

We've done some refactoring on ProjectAPI to make it simpler and more reliable. You can read more details in gephi/gephi#2589.

As part of this work, we've removed the need to use the ProjectControllerUI to do operations like creating a new project. It was confusing to have to deal with both ProjectController and ProjectControllerUI. You now only have to work with ProjectController. Consult the Javadoc if needed.

Thank you!