From: Decebal Suiu Date: Fri, 8 Jul 2016 14:09:37 +0000 (+0300) Subject: Add Troubleshooting section in readme file X-Git-Tag: release-1.1.0~7 X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=3af8b794e6e1cadc43e85dd6f18e19c63ce90dbb;p=pf4j.git Add Troubleshooting section in readme file --- diff --git a/README.md b/README.md index af3e1cc..a26838e 100644 --- a/README.md +++ b/README.md @@ -402,6 +402,17 @@ protected ExtensionFinder createExtensionFinder() { } ``` +Troubleshooting +------------------- +Below are listed some problems that may occur when attempting to use PF4J, and suggestions for solving them. + +- **No Extensions Found** + +See if you have a file `extensions.idx` in each plugin. +If file `extensions.idx` doesn't exist then probably it's something wrong with the annotation processing step (enable annotation processing in your IDE or in your Maven script). +If file `extensions.idx` exists and it's not empty then sure you have a class loader issue (you have the same extension point in two different class loader), in this situation you must remove some libraries (probably the API jar) from plugin. +Are some resources on the internet related to this subject: [#82](https://github.com/decebals/pf4j/issues/82), [#64](https://github.com/decebals/pf4j/issues/64) and [No extensions found] (https://groups.google.com/forum/#!topic/pf4j/tEQXY_WpD3A). + Demo ------------------- I have a tiny demo application. The demo application is in demo folder.